The open alternative to Salesforce, designed for AI.
TypeScript crmcrm-systemcustomergood-first-issuegraphqlhacktoberfestjavascriptmarketingmonoreponestjsopen-sourcepostgresqlreactreactjssalestypescriptweb
i18n - docs translations (#24166)
github-actions[bot]ddce288246f6
diff --git a/packages/twenty-docs/docs.json b/packages/twenty-docs/docs.jsonindex 1207ef66731..264968ed4fe 100644--- a/packages/twenty-docs/docs.json+++ b/packages/twenty-docs/docs.json@@ -4639,6 +4639,7 @@"l/pt/developers/extend/apps/logic/overview","l/pt/developers/extend/apps/logic/logic-functions","l/pt/developers/extend/apps/logic/key-value-store",+ "l/pt/developers/extend/apps/logic/background-jobs","l/pt/developers/extend/apps/logic/skills-and-agents","l/pt/developers/extend/apps/logic/connections"]@@ -5484,7 +5485,8 @@"l/ru/user-guide/settings/capabilities/member-management","l/ru/user-guide/settings/capabilities/profile-settings","l/ru/user-guide/settings/capabilities/experience-settings",- "l/ru/user-guide/settings/capabilities/domains-settings"+ "l/ru/user-guide/settings/capabilities/domains-settings",+ "l/ru/user-guide/settings/capabilities/community-settings"]},{@@ -5494,6 +5496,19 @@]}]+ },+ {+ "group": "Юридическая информация",+ "icon": "book",+ "pages": [+ "l/ru/user-guide/legal/overview",+ {+ "group": "Инструкции",+ "pages": [+ "l/ru/user-guide/legal/how-tos/legal-faq"+ ]+ }+ ]}]},@@ -5520,6 +5535,18 @@"l/ru/developers/extend/apps/getting-started/troubleshooting"]},+ {+ "group": "Обучение",+ "pages": [+ "l/ru/developers/extend/apps/tutorials/document-generator/overview",+ "l/ru/developers/extend/apps/tutorials/document-generator/data-model",+ "l/ru/developers/extend/apps/tutorials/document-generator/generating-documents",+ "l/ru/developers/extend/apps/tutorials/document-generator/http-routes",+ "l/ru/developers/extend/apps/tutorials/document-generator/building-the-ui",+ "l/ru/developers/extend/apps/tutorials/document-generator/ai-agent",+ "l/ru/developers/extend/apps/tutorials/document-generator/publishing"+ ]+ },{"group": "Конфигурация","pages": [@@ -5536,6 +5563,7 @@"l/ru/developers/extend/apps/data/overview","l/ru/developers/extend/apps/data/objects","l/ru/developers/extend/apps/data/extending-objects",+ "l/ru/developers/extend/apps/data/system-fields","l/ru/developers/extend/apps/data/relations"]},@@ -5545,6 +5573,7 @@"l/ru/developers/extend/apps/logic/overview","l/ru/developers/extend/apps/logic/logic-functions","l/ru/developers/extend/apps/logic/key-value-store",+ "l/ru/developers/extend/apps/logic/background-jobs","l/ru/developers/extend/apps/logic/skills-and-agents","l/ru/developers/extend/apps/logic/connections"]@@ -5569,6 +5598,12 @@"l/ru/developers/extend/apps/operations/testing","l/ru/developers/extend/apps/operations/publishing"]+ },+ {+ "group": "Переводы",+ "pages": [+ "l/ru/developers/extend/apps/translations/overview"+ ]}]},@@ -6472,6 +6507,7 @@"l/zh/developers/extend/apps/logic/overview","l/zh/developers/extend/apps/logic/logic-functions","l/zh/developers/extend/apps/logic/key-value-store",+ "l/zh/developers/extend/apps/logic/background-jobs","l/zh/developers/extend/apps/logic/skills-and-agents","l/zh/developers/extend/apps/logic/connections"]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 896bef811be..595807b30f6 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@@ -806,22 +806,22 @@ const Card = () => {| `element.classList.add(...)` | يرمي استثناء (`classList` هو `undefined`) | قم ببناء سلسلة `className` بنفسك || `document.getElementById()`, `getElementsByClassName()`, `createTreeWalker()` | يرمي استثناء | `querySelector()` / `querySelectorAll()`, والتي تعمل || `document.activeElement` | دائمًا `undefined` | تتبّع التركيز باستخدام `onFocus` / `onBlur` |-| `\<canvas>` | لا يَرسُم أي شيء، بدون خطأ | استخدم SVG، أو ارسم خارج الشاشة ثم اعرض `<img src={dataUrl}>` |+| `canvas` | لا يَرسُم أي شيء، بدون خطأ | SVG، أو الرسم خارج الشاشة وعرض النتيجة في عنصر `img` || `createPortal(node, document.body)` | لا يَرسُم أي شيء، بينما `isConnected` يُبلغ عن النجاح | استخدم الطبقات العائمة (overlays) داخل التخطيط نفسه مع `position: absolute`، أو مرّر إلى المكتبة عنصر الحاوية الخاص بك |فجوة الـ portal هي السبب في أن عناصر popover في Radix و Headless UI و MUI و react-select لا ترسُم أي شيء بشكل افتراضي. معظمها يقبل خاصية container؛ وجّهها إلى عنصر قمت بترسيمه.### الأحداث-أحداث الماوس، والمؤشر، واللمس، والسحب، ولوحة المفاتيح، والتركيز، و`input`/`change`/`submit`، و`scroll`/`wheel`/`contextmenu` و`animationend`/`transitionend` تمر إلى المضيف، بالإضافة إلى عدد قليل لكل عنصر: `load`/`error` على `<img>`، والحافظة والتكوين على `<input>`/`\<textarea>`، والوسائط على `\<video>`/`\<audio>`، و`toggle` على `\<details>`/`\<dialog>`. أي شيء آخر (`onAuxClick`, `onSelect`, `onInvalid`, `onReset`, `onAnimationStart`, التقاط المؤشر، `onLoad` خارج `<img>`) يتم إسقاطه دون تحذير.+أحداث الماوس، والمؤشر، واللمس، والسحب، ولوحة المفاتيح، والتركيز، و`input`/`change`/`submit`، و`scroll`/`wheel`/`contextmenu` و`animationend`/`transitionend` تُمرَّر إلى المضيف، بالإضافة إلى بعض الأحداث الخاصة بكل عنصر: `load`/`error` على `img`، والحافظة والتركيب على `input`/`textarea`، والوسائط على `video`/`audio`، و`toggle` على `details`/`dialog`. أي شيء آخر (`onAuxClick`, `onSelect`, `onInvalid`, `onReset`, `onAnimationStart`, التقاط المؤشر، `onLoad` خارج `img`) يتم إسقاطه دون تحذير.`document.addEventListener()` و `window.addEventListener()` تُسجِّلان بدون خطأ لكن لا تُطلقان أبدًا، وهذا هو السبب في أن السحب يتوقف بمجرد أن يغادر المؤشر العنصر الذي بدأ عليه. `event.preventDefault()` لا يعبر أيضًا؛ إرسال النماذج، و`dragover`/`drop` ونقرات الروابط محمية مسبقًا من أجلك.### السمات والأنماط-كل عنصر يمرّر خصائصه الخاصة إلى DOM المضيف (`href` على `\<a>`, و `src`/`alt` على `<img>`, و `value`/`placeholder`/`disabled` على `<input>`, وهكذا)، بالإضافة إلى مجموعة مشتركة على كل عنصر: `id`, `className`, `style`, `title`, `tabIndex`, `role`, `draggable` وأي سمة `aria-*` / `data-*` (مفصولة بشرطات، لذا يتم إسقاط `ariaLabel`). أي شيء خارج ذلك يتم تجاهله بصمت، لذا عبّر عن الحالة المخصّصة كـ `data-*`.+كل عنصر يمرّر خصائصه الخاصة إلى DOM المضيف (`href` على `a`، و`src`/`alt` على `img`، و`value`/`placeholder`/`disabled` على `input`، وهكذا)، بالإضافة إلى مجموعة مشتركة على كل عنصر: `id`, `className`, `style`, `title`, `tabIndex`, `role`, `draggable` وأي سمة `aria-*` / `data-*` (مفصولة بشرطات، لذا يتم إسقاط `ariaLabel`). أي شيء خارج ذلك يتم تجاهله بصمت، لذا عبّر عن الحالة المخصّصة كـ `data-*`.-يتم حقن CSS الخاص بالمكوّن، سواءً من `import './styles.css'` أو CSS-in-JS أو عنصر `\<style>`، في وسم `\<head>` لصفحة المضيف **بدون نطاق**. لذا تتصادم أسماء الأصناف مع أسماء Twenty نفسها (قم بإضافة بادئة لها، ولا تكتب أبدًا محددًا مثل `div { ... }`)، و `@media` تطابِق نافذة المتصفح بدلاً من الودجت الخاص بك (استخدم `@container` مع `container-type` الخاص بك). خصائص `style` المضمنة لا تتأثر.+يتم حقن CSS الخاص بالمكوّن، سواءً من `import './styles.css'` أو CSS-in-JS أو عنصر `style`، في وسم `head` لصفحة المضيف **بدون نطاق**. لذا تتصادم أسماء الأصناف مع أسماء Twenty نفسها (قم بإضافة بادئة لها، ولا تكتب أبدًا محددًا مثل `div { ... }`)، و `@media` تطابِق نافذة المتصفح بدلاً من الودجت الخاص بك (استخدم `@container` مع `container-type` الخاص بك). خصائص `style` المضمنة لا تتأثر.### التخزين والشبكة@@ -835,7 +835,7 @@ const Card = () => {### فجوات أخرى-* **محتويات الملفات.** يُرجِع `<input type="file">` إلى معالجك بيانات تعريف الملف فقط، وليس البايتات، لذلك فإن `FileReader` وعمليات الرفع غير ممكنة بعد.+* **محتويات الملفات.** يُرجِع `input` من النوع `file` إلى معالجك بيانات تعريف الملف فقط، وليس البايتات، لذلك فإن `FileReader` وعمليات الرفع غير ممكنة بعد.* **حمولات السحب والإفلات.** أحداث السحب تُطلق، لكن `event.dataTransfer` هي `undefined`.* **الوحدات المدمجة في Node.** `fs` و`path` و`node:crypto` تفشل في عملية البناء، لذا انقل ذلك العمل إلى [دالة منطقية](/l/ar/developers/extend/apps/logic/logic-functions). Web Crypto و `fetch` و `TextEncoder` و `URL` متوفرة.-* يتم دائمًا إعادة عزل **`\<iframe>`** دون `allow-same-origin`، لذلك يعمل التضمين الذي يعتمد على جلسته الخاصة في وضع "تسجيل الخروج". ليس لديه `onLoad` أيضًا.+* يتم دائمًا إعادة عزل **`iframe`** دون `allow-same-origin`، لذلك يعمل التضمين الذي يعتمد على جلسته الخاصة في وضع "تسجيل الخروج". ليس لديه `onLoad` أيضًا.diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/translations/overview.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/translations/overview.mdxindex b7ebb8e2be6..9d556636592 100644--- a/packages/twenty-docs/l/ar/developers/extend/apps/translations/overview.mdx+++ b/packages/twenty-docs/l/ar/developers/extend/apps/translations/overview.mdx@@ -50,7 +50,7 @@ const Card = ({ count, name }: { count: number; name: string }) => {### متى تستخدم أيًّا منها-* **`<Trans>…</Trans>`** — نص ثابت في JSX. استخدم الخاصيتين `message` و`values` من أجل الاستبدال (interpolation) (`<Trans message="Hi {name}" values={{ name }} />`); لا يمكن استخراج الاستبدال مباشرة في العناصر الفرعية (children) بشكل ثابت.+* **`Trans`** — نص ثابت في JSX. استخدم الخاصيتين `message` و`values` من أجل الاستبدال (interpolation)، كما في `Trans message="Hi {name}" values={{ name }}`؛ لا يمكن استخراج الاستبدال مباشرة في العناصر الفرعية (children) بشكل ثابت.* **`useTranslate().t`** — سلاسل ديناميكية داخل المكوّن. يُعيد التصيير عندما يغيّر المستخدم اللغة. يفضّل استخدامه داخل التصيير (render).* **`t(...)`** (مستوردة مباشرة) — ترجمة فورية (eager) يمكن استخدامها **في أي مكان**،بما في ذلك معالجات الأحداث (event handlers)، والبرامج المساعدة (helpers)، ونطاق الوحدة (module scope) — وليس فقط داخل التصيير.@@ -75,7 +75,8 @@ twenty dev:translations-extract # collect strings into locales/twenty dev:translations-extract --locale fr-FR # also scaffold a target locale```-يقوم الاستخراج بجمع كل من تسميات ملف البيان (manifest labels) وسلاسل `t()`/`msg()`/`\<Trans>` من شفرة الواجهة الأمامية (front-component) في `locales/\<locale>.json`، مفهرسة حسب سلسلة المصدر. املأ الترجمات:+يقوم الاستخراج بجمع كل من تسميات ملف البيان (manifest labels) وسلاسل `t()`/`msg()`/`Trans`+من شفرة الواجهة الأمامية (front-component) في `locales/\<locale>.json`، مفهرسة حسب سلسلة المصدر. املأ الترجمات:```json// locales/fr-FR.json@@ -94,7 +95,7 @@ twenty dev:translations-extract --locale fr-FR # also scaffold a target localeيقوم `twenty dev:build` بتجميع الكتالوجات وتقديم اللغة الصحيحة للمستخدمالحالي: يتم حل تسميات ملف البيان (manifest labels) على جانب الخادم، ويتم تضمين كتالوجات الواجهة الأمامية (front-component)داخل كل حزمة مكوّن. وقت التشغيل يقرأ المكوّن-اللغة (locale) من سياق التنفيذ الخاص به (لغة المضيف الحالية) ويحل كل سلسلة مقابل كتالوجه، مع الرجوع إلى المصدر عندما تكون الترجمة مفقودة. تغيير اللغة في المضيف يعيد تصيير سلاسل `\<Trans>` و+اللغة (locale) من سياق التنفيذ الخاص به (لغة المضيف الحالية) ويحل كل سلسلة مقابل كتالوجه، مع الرجوع إلى المصدر عندما تكون الترجمة مفقودة. تغيير اللغة في المضيف يعيد تصيير سلاسل `Trans` و`useTranslate().t` مباشرة.نظرًا إلى أنّ الكتالوجات تُجمَّع في وقت البناء، فإن تحديث ترجمة ما يعني@@ -105,6 +106,13 @@ twenty dev:translations-extract --locale fr-FR # also scaffold a target localeيعرض سلاسل المصدر، لذا اختبر المخرجات المترجمة ببناء (build) لمرة واحدة.</Note>-قد تمتد عناصر النص التابعة لـ `<Trans>` على عدة أسطر — يتم ضغط المسافات-بنفس الطريقة التي يقوم JSX بضغطها، لذلك كل من `<Trans>Welcome\n back</Trans>`-ومفتاح الاستخراج يصبحان `Welcome back`.+قد تمتد عناصر النص التابعة لـ `Trans` على عدة أسطر — يتم ضغط المسافات+بنفس الطريقة التي يقوم JSX بضغطها، لذلك كلاهما يتم استخلاصه إلى المفتاح `Welcome back`:++```tsx+<Trans>Welcome back</Trans>+<Trans>+ Welcome+ back+</Trans>+```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.mdxindex 2f0123f27ca..8dc124e047f 100644--- 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@@ -806,22 +806,22 @@ Takže recharts `ResponsiveContainer`, Floating UI / Popper, virtualizace seznam| `element.classList.add(...)` | Vyvolá výjimku (`classList` je `undefined`) | Sestavte si řetězec `className` sami || `document.getElementById()`, `getElementsByClassName()`, `createTreeWalker()` | Vyvolá výjimku | `querySelector()` / `querySelectorAll()`, které fungují || `document.activeElement` | Vždy `undefined` | Sledujte fokus pomocí `onFocus` / `onBlur` |-| `\<canvas>` | Nerenderuje nic, žádná chyba | SVG, nebo kreslete offscreen a zobrazte `<img src={dataUrl}>` |+| `canvas` | Nerenderuje nic, žádná chyba | SVG, nebo kreslit mimo obrazovku a výsledek zobrazit v prvku `img` || `createPortal(node, document.body)` | Nerenderuje nic, zatímco `isConnected` hlásí úspěch | Překryvné prvky inline pomocí `position: absolute`, nebo knihovně předávejte vlastní kontejnerový prvek |Kvůli této mezeře v portálu popovery Radix, Headless UI, MUI a react-select ve výchozím stavu nic nevyrenderují. Většina z nich přijímá prop pro kontejner; nasměrujte ho na prvek, který jste vyrenderovali.### Události-Události myši, ukazatele, dotyku, tažení, klávesnice, fokusu, `input`/`change`/`submit`, `scroll`/`wheel`/`contextmenu` a `animationend`/`transitionend` přecházejí do hostitele, plus několik specifických pro prvek: `load`/`error` na `<img>`, schránka a kompozice na `<input>`/`\<textarea>`, média na `\<video>`/`\<audio>`, `toggle` na `\<details>`/`\<dialog>`. Cokoli dalšího (`onAuxClick`, `onSelect`, `onInvalid`, `onReset`, `onAnimationStart`, zachycení ukazatele (pointer capture), `onLoad` na `<img>`) je bez varování zahazováno.+Události myši, ukazatele, dotyku, přetažení, klávesnice, fokusu, `input`/`change`/`submit`, `scroll`/`wheel`/`contextmenu` a `animationend`/`transitionend` se předávají hostiteli, a navíc několik dalších podle typu prvku: `load`/`error` na `img`, schránka a skládání (composition) na `input`/`textarea`, média na `video`/`audio`, `toggle` na `details`/`dialog`. Cokoli dalšího (`onAuxClick`, `onSelect`, `onInvalid`, `onReset`, `onAnimationStart`, zachycení ukazatele (pointer capture), `onLoad` na `img`) je bez varování zahazováno.`document.addEventListener()` a `window.addEventListener()` se zaregistrují bez chyby, ale nikdy se nespustí, což je důvod, proč se přetažení zastaví, jakmile ukazatel opustí prvek, na kterém začalo. Ani `event.preventDefault()` se nepřenáší; odeslání formuláře, `dragover`/`drop` a kliknutí na odkazy jsou už za vás ošetřené.### Atributy a stylování-Každý prvek předává své vlastní vlastnosti do hostitelského DOMu (`href` na `\<a>`, `src`/`alt` na `<img>`, `value`/`placeholder`/`disabled` na `<input>` atd.) plus společnou sadu na každém prvku: `id`, `className`, `style`, `title`, `tabIndex`, `role`, `draggable` a jakýkoli atribut `aria-*` / `data-*` (s pomlčkou, takže `ariaLabel` je zahozena). Cokoli mimo tento rozsah je tiše zahazováno, takže vlastní stav vyjádřete jako `data-*`.+Každý prvek předává své vlastní vlastnosti do hostitelského DOM (`href` na `a`, `src`/`alt` na `img`, `value`/`placeholder`/`disabled` na `input` atd.), a navíc má každý prvek společnou sadu: `id`, `className`, `style`, `title`, `tabIndex`, `role`, `draggable` a jakýkoli atribut `aria-*` / `data-*` (s pomlčkou; `ariaLabel` je proto ignorována). Cokoli mimo tento rozsah je tiše zahazováno, takže vlastní stav vyjádřete jako `data-*`.-Komponentové CSS, ať už z `import './styles.css'`, CSS-in-JS nebo z prvku `\<style>`, je do `\<head>` hostitelské stránky vkládáno **bez ohraničení (unscoped)**. Třídy se tak střetávají s vlastními třídami Twenty (přidávejte jim předpony a nikdy nepište holé `div { ... }` selektory) a `@media` se vztahuje k oknu prohlížeče, nikoli k vašemu widgetu (použijte `@container` s vlastním `container-type`). Inline propy `style` nejsou ovlivněny.+Komponentové CSS, ať už z `import './styles.css'`, CSS-in-JS nebo z prvku `style`, je do `head` hostitelské stránky vkládáno **bez ohraničení (unscoped)**. Třídy se tak střetávají s vlastními třídami Twenty (přidávejte jim předpony a nikdy nepište holé `div { ... }` selektory) a `@media` se vztahuje k oknu prohlížeče, nikoli k vašemu widgetu (použijte `@container` s vlastním `container-type`). Inline propy `style` nejsou ovlivněny.### Úložiště a síť@@ -835,7 +835,7 @@ Komponentové CSS, ať už z `import './styles.css'`, CSS-in-JS nebo z prvku `\<### Další omezení-* **Obsah souborů.** `<input type="file">` poskytuje vašemu handleru pouze metadata souboru, nikoli samotné bajty, takže `FileReader` a nahrávání zatím nejsou možná.+* **Obsah souborů.** `input` typu `file` poskytuje vašemu handleru pouze metadata souboru, nikoli samotné bajty, takže `FileReader` a nahrávání zatím nejsou možná.* **Payloady drag-and-drop.** Události tažení se spouštějí, ale `event.dataTransfer` je `undefined`.* **Vestavěné moduly Node.** `fs`, `path` a `node:crypto` způsobí chybu při sestavení, takže tuto práci přesuňte do [logické funkce](/l/cs/developers/extend/apps/logic/logic-functions). Web Crypto, `fetch`, `TextEncoder` a `URL` jsou k dispozici.-* **`\<iframe>`** je vždy znovu zasandboxováno bez `allow-same-origin`, takže vložený obsah spoléhající se na vlastní relaci se vykreslí jako odhlášený. Nemá ani `onLoad`.+* **`iframe`** je vždy znovu zasandboxováno bez `allow-same-origin`, takže vložený obsah spoléhající se na vlastní relaci se vykreslí jako odhlášený. Nemá ani `onLoad`.diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/translations/overview.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/translations/overview.mdxindex 72d2b10aa79..15ba3590776 100644--- a/packages/twenty-docs/l/cs/developers/extend/apps/translations/overview.mdx+++ b/packages/twenty-docs/l/cs/developers/extend/apps/translations/overview.mdx@@ -53,8 +53,8 @@ const Card = ({ count, name }: { count: number; name: string }) => {### Kdy co použít-* **`<Trans>…</Trans>`** — statický text v JSX. Použijte props `message` a `values`- pro interpolaci (`<Trans message="Hi {name}" values={{ name }} />`);+* **`Trans`** — statický text v JSX. Použijte props `message` a `values` pro+ interpolaci, jak je ukázáno v `Trans message="Hi {name}" values={{ name }}`;interpolace přímo v potomcích není staticky extrahovatelná.* **`useTranslate().t`** — dynamické řetězce uvnitř komponenty. Znovu se vykreslí, kdyžuživatel přepne jazyk. Uvnitř renderu tomuto dávejte přednost.@@ -83,7 +83,7 @@ twenty dev:translations-extract # collect strings into locales/twenty dev:translations-extract --locale fr-FR # also scaffold a target locale```-Extrakce shromáždí jak popisky manifestu, tak řetězce `t()`/`msg()`/`\<Trans>`+Extrakce shromáždí jak popisky manifestu, tak řetězce `t()`/`msg()`/`Trans`z vašeho zdrojového kódu front komponent do `locales/\<locale>.json`, kde jsou klíčemzdrojové řetězce. Doplňte překlady:@@ -105,7 +105,7 @@ překladu. Jakýkoli řetězec ponechaný prázdný spadne zpět na zdrojový teaktuálního uživatele: popisky manifestu jsou vyhodnoceny na straně serveru a katalogyfront komponent jsou zabudovány do každého balíčku komponent. Za běhu komponenta čtejazykovou verzi (locale) z vykonávacího kontextu (aktuální jazyk hostitele) a překládá-každý řetězec podle svého katalogu, přičemž při chybějícím překladu spadne zpět na zdroj. Přepnutí jazyka v hostiteli znovu vykreslí řetězce `\<Trans>` a+každý řetězec podle svého katalogu, přičemž při chybějícím překladu spadne zpět na zdroj. Přepnutí jazyka v hostiteli znovu vykreslí řetězce `Trans` a`useTranslate().t` v reálném čase.Protože katalogy jsou kompilovány v době buildu, aktualizace překladu znamená@@ -116,6 +116,13 @@ Překlady jsou kompilovány příkazy `twenty dev:build` (a `twenty apply`). Nepotestujte pomocí jednorázového buildu.</Note>-Potomci `<Trans>` s textem mohou být rozloženi na více řádků — prázdné znaky jsou zpracovány-stejně, jako je zpracovává JSX, takže `<Trans>Welcome\n back</Trans>` i extrahovaný-klíč se oba stanou `Welcome back`.+Textoví potomci `Trans` mohou být na více řádcích — bílé znaky se slučují+stejně jako je slučuje JSX, takže oba tyto případy se extrahují pod klíčem `Welcome back`:++```tsx+<Trans>Welcome back</Trans>+<Trans>+ Welcome+ back+</Trans>+```diff --git a/packages/twenty-docs/l/de/developers/extend/apps/layout/front-components.mdx b/packages/twenty-docs/l/de/developers/extend/apps/layout/front-components.mdxindex 52e14ecf8ca..6c8ac9e33d5 100644--- a/packages/twenty-docs/l/de/developers/extend/apps/layout/front-components.mdx+++ b/packages/twenty-docs/l/de/developers/extend/apps/layout/front-components.mdx@@ -806,22 +806,22 @@ Ein `ref` gibt dir ein Sandbox-Element, kein `HTMLElement`.| `element.classList.add(...)` | Löst eine Exception aus (`classList` ist `undefined`) | Erstelle den `className`-String selbst || `document.getElementById()`, `getElementsByClassName()`, `createTreeWalker()` | Löst eine Exception aus | `querySelector()` / `querySelectorAll()`, die funktionieren || `document.activeElement` | Immer `undefined` | Fokus mit `onFocus` / `onBlur` verfolgen |-| `\<canvas>` | Rendert nichts, keine Fehlermeldung | SVG verwenden oder Offscreen zeichnen und ein `<img src={dataUrl}>` anzeigen |+| `canvas` | Rendert nichts, keine Fehlermeldung | SVG oder außerhalb des Bildschirms zeichnen und das Ergebnis in einem `img`-Element anzeigen || `createPortal(node, document.body)` | Rendert nichts, während `isConnected` Erfolg meldet | Overlays inline mit `position: absolute` oder der Bibliothek dein eigenes Container-Element übergeben |Diese Portal-Lücke ist der Grund, warum Radix-, Headless-UI-, MUI- und react-select-Popover standardmäßig nichts rendern. Die meisten akzeptieren eine Container-Prop; verweise sie auf ein Element, das du gerendert hast.### Ereignisse-Maus, Zeiger, Touch, Drag, Tastatur, Fokus, `input`/`change`/`submit`, `scroll`/`wheel`/`contextmenu` und `animationend`/`transitionend` werden an den Host durchgereicht, plus ein paar pro Element: `load`/`error` auf `<img>`, Zwischenablage und Composition auf `<input>`/`\<textarea>`, Medien auf `\<video>`/`\<audio>`, `toggle` auf `\<details>`/`\<dialog>`. Alles andere (`onAuxClick`, `onSelect`, `onInvalid`, `onReset`, `onAnimationStart`, Pointer-Capture, `onLoad` von `<img>`) wird ohne Warnung verworfen.+Maus, Zeiger, Touch, Drag, Tastatur, Fokus, `input`/`change`/`submit`, `scroll`/`wheel`/`contextmenu` und `animationend`/`transitionend` werden an den Host durchgereicht, plus ein paar pro Element: `load`/`error` auf `img`, Zwischenablage und Komposition auf `input`/`textarea`, Medien auf `video`/`audio`, `toggle` auf `details`/`dialog`. Alles andere (`onAuxClick`, `onSelect`, `onInvalid`, `onReset`, `onAnimationStart`, Pointer-Capture, `onLoad` von `img`) wird ohne Warnung verworfen.`document.addEventListener()` und `window.addEventListener()` werden ohne Fehler registriert und feuern nie, weshalb ein Drag aufhört, sobald der Zeiger das Element verlässt, auf dem er begonnen hat. `event.preventDefault()` wird ebenfalls nicht durchgereicht; Formularübermittlung, `dragover`/`drop` und Link-Klicks sind bereits für dich abgesichert.### Attribute und Styling-Jedes Element leitet seine eigenen Eigenschaften an den Host-DOM weiter (`href` auf `\<a>`, `src`/`alt` auf `<img>`, `value`/`placeholder`/`disabled` auf `<input>` usw.), plus einen gemeinsamen Satz auf jedem Element: `id`, `className`, `style`, `title`, `tabIndex`, `role`, `draggable` und jedes `aria-*`-/`data-*`-Attribut (mit Bindestrich, daher wird `ariaLabel` verworfen). Alles außerhalb davon wird stillschweigend verworfen, daher solltest du benutzerdefinierte Zustände als `data-*` ausdrücken.+Jedes Element leitet seine eigenen Eigenschaften an den Host-DOM weiter (`href` auf `a`, `src`/`alt` auf `img`, `value`/`placeholder`/`disabled` auf `input` usw.), plus einen gemeinsamen Satz auf jedem Element: `id`, `className`, `style`, `title`, `tabIndex`, `role`, `draggable` und jedes `aria-*`-/`data-*`-Attribut (mit Bindestrich, daher wird `ariaLabel` verworfen). Alles außerhalb davon wird stillschweigend verworfen, daher solltest du benutzerdefinierte Zustände als `data-*` ausdrücken.-Component-CSS, egal ob aus `import './styles.css'`, CSS-in-JS oder einem `\<style>`-Element, wird **unscoped** in den `\<head>` der Host-Seite injiziert. Dadurch kollidieren Klassennamen mit denen von Twenty (präfixe sie und schreibe niemals nacktes `div { ... }`-Selektoren), und `@media` bezieht sich auf das Browserfenster statt auf dein Widget (verwende `@container` mit deinem eigenen `container-type`). Inline-`style`-Props sind nicht betroffen.+Component-CSS, egal ob aus `import './styles.css'`, CSS-in-JS oder einem `style`-Element, wird **unscoped** in den `head` der Host-Seite injiziert. Dadurch kollidieren Klassennamen mit denen von Twenty (präfixe sie und schreibe niemals nacktes `div { ... }`-Selektoren), und `@media` bezieht sich auf das Browserfenster statt auf dein Widget (verwende `@container` mit deinem eigenen `container-type`). Inline-`style`-Props sind nicht betroffen.### Speicher und Netzwerk@@ -835,7 +835,7 @@ Component-CSS, egal ob aus `import './styles.css'`, CSS-in-JS oder einem `\<styl### Weitere Lücken-* **Dateiinhalt.** `<input type="file">` gibt deinem Handler nur Dateimetadaten, nicht die Bytes, daher sind `FileReader` und Uploads noch nicht möglich.+* **Dateiinhalt.** Ein `input` des Typs `file` gibt deinem Handler nur Dateimetadaten, nicht die Bytes, daher sind `FileReader` und Uploads noch nicht möglich.* **Drag-and-drop-Nutzlasten.** Drag-Events werden ausgelöst, aber `event.dataTransfer` ist `undefined`.* **Node-Built-ins.** `fs`, `path` und `node:crypto` führen zu einem Build-Fehler, daher solltest du diese Arbeit in eine [Logic Function](/l/de/developers/extend/apps/logic/logic-functions) auslagern. Web Crypto, `fetch`, `TextEncoder` und `URL` sind verfügbar.-* **`\<iframe>`** wird immer erneut ohne `allow-same-origin` sandboxed, sodass ein Embed, das von seiner eigenen Session abhängt, als ausgeloggt gerendert wird. Es hat auch kein `onLoad`.+* **`iframe`** wird immer erneut ohne `allow-same-origin` in einer Sandbox ausgeführt, sodass eine Einbettung, die auf ihre eigene Sitzung angewiesen ist, als abgemeldet gerendert wird. Es hat auch kein `onLoad`.diff --git a/packages/twenty-docs/l/de/developers/extend/apps/translations/overview.mdx b/packages/twenty-docs/l/de/developers/extend/apps/translations/overview.mdxindex 61bee4e6585..2d1a759fb20 100644--- a/packages/twenty-docs/l/de/developers/extend/apps/translations/overview.mdx+++ b/packages/twenty-docs/l/de/developers/extend/apps/translations/overview.mdx@@ -55,8 +55,8 @@ const Card = ({ count, name }: { count: number; name: string }) => {### Wann Sie welches verwenden sollten-* **`<Trans>…</Trans>`** – statischer Text in JSX. Verwenden Sie die Props `message` und `values`- zur Interpolation (`<Trans message="Hi {name}" values={{ name }} />`);+* **`Trans`** – statischer Text in JSX. Verwenden Sie die Props `message` und `values`+ zur Interpolation, wie in `Trans message="Hi {name}" values={{ name }}`;eine direkte Interpolation in den Children ist nicht statisch extrahierbar.* **`useTranslate().t`** – dynamische Zeichenketten innerhalb einer Komponente. Wird neu gerendert, wenn derBenutzer die Sprache wechselt. Bevorzugen Sie dies innerhalb von Render-Funktionen.@@ -85,7 +85,8 @@ twenty dev:translations-extract # collect strings into locales/twenty dev:translations-extract --locale fr-FR # also scaffold a target locale```-Die Extraktion sammelt sowohl Ihre Manifest-Labels als auch die `t()`-/`msg()`-/`\<Trans>`-Zeichenketten aus Ihrem Front-Komponenten-Quellcode in `locales/\<locale>.json`, indiziert nach der Quellzeichenkette. Füllen Sie die Übersetzungen aus:+Die Extraktion sammelt sowohl Ihre Manifest-Labels als auch die `t()`-/`msg()`-/`Trans`-+Zeichenketten aus Ihrem Front-Komponenten-Quellcode in `locales/\<locale>.json`, indiziert nach der Quellzeichenkette. Füllen Sie die Übersetzungen aus:```json// locales/fr-FR.json@@ -104,7 +105,7 @@ Platzhalter wie `{name}` werden zur Laufzeit ersetzt – behalten Sie sie in der`twenty dev:build` kompiliert die Kataloge und stellt die richtige Sprache für den aktuellen Benutzer bereit: Manifest-Labels werden serverseitig aufgelöst und Front-Komponenten-Kataloge werden in jedes Komponenten-Bundle eingebunden. Zur Laufzeit liest eine Komponente dieLocale aus ihrem Ausführungskontext (der aktuellen Sprache des Hosts) und löstjede Zeichenkette gegen ihren Katalog auf, wobei auf die Quelle zurückgegriffen-wird, wenn eine Übersetzung fehlt. Das Umschalten der Sprache im Host rendert `\<Trans>`- und+wird, wenn eine Übersetzung fehlt. Das Umschalten der Sprache im Host rendert `Trans`- und`useTranslate().t`-Zeichenketten live neu.Da Kataloge zur Build-Zeit kompiliert werden, bedeutet das Aktualisieren einer Übersetzung,@@ -116,4 +117,12 @@ kontinuierliche `twenty dev`-Watch zeigt Quellzeichenketten an, daher sollten Simit einem einmaligen Build testen.</Note>-`<Trans>`-Text-Children können sich über mehrere Zeilen erstrecken – Leerraum wird auf dieselbe Weise zusammengefasst, wie JSX ihn zusammenfasst, sodass sowohl `<Trans>Welcome\n back</Trans>` als auch der extrahierte Schlüssel zu `Welcome back` werden.+`Trans`-Text-Children können sich über mehrere Zeilen erstrecken – Leerraum wird auf dieselbe Weise zusammengefasst, wie JSX ihn zusammenfasst, sodass beide zum Schlüssel `Welcome back` extrahiert werden:++```tsx+<Trans>Welcome back</Trans>+<Trans>+ Welcome+ back+</Trans>+```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.mdxindex b805f28c97b..ffd3d6ff722 100644--- 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@@ -806,22 +806,22 @@ Un `ref` te da un elemento sandbox, no un `HTMLElement`.| `element.classList.add(...)` | Lanza una excepción (`classList` es `undefined`) | Construye tú mismo la cadena `className` || `document.getElementById()`, `getElementsByClassName()`, `createTreeWalker()` | Lanza una excepción | `querySelector()` / `querySelectorAll()`, que sí funcionan || `document.activeElement` | Siempre `undefined` | Controla el foco con `onFocus` / `onBlur` |-| `\<canvas>` | No renderiza nada, sin error | SVG, o dibuja fuera de pantalla y muestra un `<img src={dataUrl}>` |+| `canvas` | No renderiza nada, sin error | SVG, o dibujar fuera de pantalla y mostrar el resultado en un elemento `img` || `createPortal(node, document.body)` | No renderiza nada, mientras que `isConnected` informa de éxito | Superposiciones en línea con `position: absolute`, o pasa a la biblioteca tu propio elemento contenedor |La brecha del portal es la razón por la que los popovers de Radix, Headless UI, MUI y react-select no renderizan nada de forma predeterminada. La mayoría acepta una prop de contenedor; apúntala a un elemento que hayas renderizado.### Eventos-Eventos de ratón, puntero, tacto, arrastre, teclado, foco, `input`/`change`/`submit`, `scroll`/`wheel`/`contextmenu` y `animationend`/`transitionend` pasan al host, además de algunos específicos por elemento: `load`/`error` en `<img>`, portapapeles y composición en `<input>`/`\<textarea>`, medios en `\<video>`/`\<audio>`, `toggle` en `\<details>`/`\<dialog>`. Cualquier otra cosa (`onAuxClick`, `onSelect`, `onInvalid`, `onReset`, `onAnimationStart`, captura de puntero, `onLoad` fuera de `<img>`) se descarta sin aviso.+Eventos de ratón, puntero, tacto, arrastre, teclado, foco, `input`/`change`/`submit`, `scroll`/`wheel`/`contextmenu` y `animationend`/`transitionend` pasan al host, además de algunos específicos por elemento: `load`/`error` en `img`, portapapeles y composición en `input`/`textarea`, medios en `video`/`audio`, `toggle` en `details`/`dialog`. Cualquier otra cosa (`onAuxClick`, `onSelect`, `onInvalid`, `onReset`, `onAnimationStart`, captura de puntero, `onLoad` fuera de `img`) se descarta sin aviso.`document.addEventListener()` y `window.addEventListener()` se registran sin error y nunca se disparan, lo que explica por qué un arrastre se detiene tan pronto como el puntero sale del elemento en el que comenzó. `event.preventDefault()` tampoco cruza; el envío de formularios, `dragover`/`drop` y los clics en enlaces ya están protegidos por ti.### Atributos y estilos-Cada elemento reenvía sus propias propiedades al DOM del host (`href` en `\<a>`, `src`/`alt` en `<img>`, `value`/`placeholder`/`disabled` en `<input>`, etc.), además de un conjunto común en cada elemento: `id`, `className`, `style`, `title`, `tabIndex`, `role`, `draggable` y cualquier atributo `aria-*` / `data-*` (con guiones, por lo que `ariaLabel` se descarta). Cualquier cosa fuera de eso se descarta silenciosamente, así que expresa el estado personalizado como `data-*`.+Cada elemento reenvía sus propias propiedades al DOM del host (`href` en `a`, `src`/`alt` en `img`, `value`/`placeholder`/`disabled` en `input`, etc.), además de un conjunto común en cada elemento: `id`, `className`, `style`, `title`, `tabIndex`, `role`, `draggable` y cualquier atributo `aria-*` / `data-*` (con guiones, por lo que `ariaLabel` se descarta). Cualquier cosa fuera de eso se descarta silenciosamente, así que expresa el estado personalizado como `data-*`.-El CSS del componente, ya sea desde `import './styles.css'`, CSS-in-JS o un elemento `\<style>`, se inyecta en el `\<head>` de la página del host **sin ámbito**. Así que los nombres de clase colisionan con los de Twenty (ponles un prefijo y nunca escribas `div { ... }` como selectores), y `@media` coincide con la ventana del navegador en lugar de con tu widget (usa `@container` con tu propio `container-type`). Las props de `style` en línea no se ven afectadas.+El CSS del componente, ya sea desde `import './styles.css'`, CSS-in-JS o un elemento `style`, se inyecta en el `head` de la página del host **sin ámbito**. Así que los nombres de clase colisionan con los de Twenty (ponles un prefijo y nunca escribas `div { ... }` como selectores), y `@media` coincide con la ventana del navegador en lugar de con tu widget (usa `@container` con tu propio `container-type`). Las props de `style` en línea no se ven afectadas.### Almacenamiento y red@@ -835,7 +835,7 @@ El CSS del componente, ya sea desde `import './styles.css'`, CSS-in-JS o un elem### Otras carencias-* **Contenido de archivos.** `<input type="file">` solo proporciona a tu manejador los metadatos del archivo, no los bytes, por lo que `FileReader` y las subidas no son posibles todavía.+* **Contenido de archivos.** Un `input` de tipo `file` solo proporciona a tu manejador los metadatos del archivo, no los bytes, por lo que `FileReader` y las subidas no son posibles todavía.* **Cargas útiles de arrastrar y soltar.** Los eventos de arrastre se disparan, pero `event.dataTransfer` es `undefined`.* **Integraciones nativas de Node.** `fs`, `path` y `node:crypto` hacen que la compilación falle, así que mueve ese trabajo a una [función de lógica](/l/es/developers/extend/apps/logic/logic-functions). Web Crypto, `fetch`, `TextEncoder` y `URL` están disponibles.-* **`\<iframe>`** siempre se vuelve a aislar sin `allow-same-origin`, por lo que un embed que depende de su propia sesión se renderiza como desconectado. Tampoco tiene `onLoad`.+* **`iframe`** siempre se vuelve a aislar sin `allow-same-origin`, por lo que un embed que depende de su propia sesión se renderiza como desconectado. Tampoco tiene `onLoad`.diff --git a/packages/twenty-docs/l/es/developers/extend/apps/translations/overview.mdx b/packages/twenty-docs/l/es/developers/extend/apps/translations/overview.mdxindex c3f76c0c9ce..46675dd4c33 100644--- a/packages/twenty-docs/l/es/developers/extend/apps/translations/overview.mdx+++ b/packages/twenty-docs/l/es/developers/extend/apps/translations/overview.mdx@@ -51,9 +51,7 @@ const Card = ({ count, name }: { count: number; name: string }) => {### Cuándo usar qué-* **`<Trans>…</Trans>`** — texto estático en JSX. Usa los accesorios `message` y `values`- para la interpolación (`<Trans message="Hi {name}" values={{ name }} />`);- interpolar directamente en los hijos no es extraíble estáticamente.+* **`Trans`** — texto estático en JSX. Usa las props `message` y `values` para la interpolación, como en `Trans message="Hi {name}" values={{ name }}`; la interpolación directamente en los children no se puede extraer de forma estática.* **`useTranslate().t`** — cadenas dinámicas dentro de un componente. Se vuelve a procesar cuando el usuariocambia de idioma. Preferir esto dentro del render.* **`t(...)`** (importado directamente) — una traducción entera utilizable **en cualquier lugar**,@@ -81,9 +79,7 @@ twenty dev:translations-extract # collect strings into locales/twenty dev:translations-extract --locale fr-FR # also scaffold a target locale```-La extracción recolecta tanto tus etiquetas de manifiesto como las de `t()`/`msg()`/`\<Trans>`-cadenas de tu fuente de componentes front-front en `locales/\<locale>. son`, keyed by-source string. Rellena las traducciones:+La extracción recopila tanto las etiquetas de tu manifest como las cadenas de `t()`/`msg()`/`Trans` de tu código fuente de front-component en `locales/\<locale>.json`, indexadas por la cadena de origen. Rellena las traducciones:```json// locales/fr-FR.json@@ -103,8 +99,7 @@ Los marcadores de posición como `{name}` se sustituyen en tiempo de ejecuciónusuario actual: las etiquetas del manifiesto se resuelven del lado del servidor y los catálogos de front-component se incluyen en cada paquete de componente. En tiempo de ejecución, un componente lee la configuración regionaldesde su contexto de ejecución (el idioma actual del host) y resuelvecada cadena contra su catálogo, volviendo a la fuente cuando falta una traducción-. Cambiando idioma en el host vuelve a renderizar cadenas `\<Trans>` y-`useTranslate().t` en directo.+. Cambiar el idioma en el host vuelve a renderizar en tiempo real las cadenas de `Trans` y `useTranslate().t`.Debido a que los catálogos se compilan en tiempo de construcción, actualizar una traducción significavolver a ejecutar `twenty dev:build` (y redesplegar), lo mismo que cualquier otro cambio.@@ -115,6 +110,12 @@ continuo `veinte dev` muestra las cadenas de origen, así que prueba la salida lcon una compilación única.</Note>-`<Trans>` los hijos de texto pueden expandir múltiples líneas — el espacio en blanco está colapsado el-de la misma manera que JSX lo colapsa, así que `<Trans>Bienvenido\n de vuelta</Trans>` y la clave-extraída se convierten en `Welcome back`.+Los nodos de texto hijos de `Trans` pueden abarcar varias líneas; los espacios en blanco se colapsan de la misma manera en que JSX los colapsa, por lo que ambos se extraen a la clave `Welcome back`:++```tsx+<Trans>Welcome back</Trans>+<Trans>+ Welcome+ back+</Trans>+```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.mdxindex f990704ac0b..726a1e4a6d6 100644--- 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@@ -806,22 +806,22 @@ Une `ref` vous donne un élément du bac à sable, pas un `HTMLElement`.| `element.classList.add(...)` | Lève une exception (`classList` est `undefined`) | Construisez vous-même la chaîne `className` || `document.getElementById()`, `getElementsByClassName()`, `createTreeWalker()` | Lève une exception | `querySelector()` / `querySelectorAll()`, qui fonctionnent || `document.activeElement` | Toujours `undefined` | Suivez le focus avec `onFocus` / `onBlur` |-| `\<canvas>` | Ne rend rien, pas d’erreur | SVG, ou dessinez hors écran et affichez une `<img src={dataUrl}>` |+| `canvas` | Ne rend rien, pas d’erreur | SVG, ou dessiner hors écran et afficher le résultat dans un élément `img` || `createPortal(node, document.body)` | Ne rend rien, tandis que `isConnected` signale un succès | Superpositions en ligne avec `position: absolute`, ou passez à la bibliothèque votre propre élément conteneur |Cet écart lié au portail est la raison pour laquelle les popovers de Radix, Headless UI, MUI et react-select ne rendent rien par défaut. La plupart acceptent une prop de conteneur ; faites-la pointer vers un élément que vous avez rendu.### Événements-La souris, le pointeur, le toucher, le glisser-déposer, le clavier, le focus, `input`/`change`/`submit`, `scroll`/`wheel`/`contextmenu` et `animationend`/`transitionend` sont transmis à l’hôte, plus quelques événements spécifiques à chaque élément : `load`/`error` sur `<img>`, le presse-papiers et la composition sur `<input>`/`\<textarea>`, les médias sur `\<video>`/`\<audio>`, `toggle` sur `\<details>`/`\<dialog>`. Tout le reste (`onAuxClick`, `onSelect`, `onInvalid`, `onReset`, `onAnimationStart`, la capture de pointeur, `onLoad` sur `<img>`) est ignoré sans avertissement.+La souris, le pointeur, le toucher, le glisser, le clavier, le focus, `input`/`change`/`submit`, `scroll`/`wheel`/`contextmenu` et `animationend`/`transitionend` sont transmis à l’hôte, plus quelques événements propres à chaque élément : `load`/`error` sur `img`, le presse-papiers et la composition sur `input`/`textarea`, les médias sur `video`/`audio`, `toggle` sur `details`/`dialog`. Tout le reste (`onAuxClick`, `onSelect`, `onInvalid`, `onReset`, `onAnimationStart`, la capture de pointeur, `onLoad` sur `img`) est ignoré sans avertissement.`document.addEventListener()` et `window.addEventListener()` s’enregistrent sans erreur mais ne se déclenchent jamais, c’est pourquoi un glisser-déposer s’arrête dès que le pointeur quitte l’élément sur lequel il a commencé. `event.preventDefault()` ne traverse pas non plus ; l’envoi de formulaire, `dragover`/`drop` et les clics sur les liens sont déjà protégés pour vous.### Attributs et styles-Chaque élément transfère ses propres propriétés au DOM hôte (`href` sur `\<a>`, `src`/`alt` sur `<img>`, `value`/`placeholder`/`disabled` sur `<input>`, etc.), plus un ensemble commun sur chaque élément : `id`, `className`, `style`, `title`, `tabIndex`, `role`, `draggable` et tout attribut `aria-*` / `data-*` (avec tiret, donc `ariaLabel` est ignoré). Tout ce qui sort de ce cadre est silencieusement supprimé, donc exprimez l’état personnalisé sous forme de `data-*`.+Chaque élément transfère ses propres propriétés au DOM hôte (`href` sur `a`, `src`/`alt` sur `img`, `value`/`placeholder`/`disabled` sur `input`, etc.), plus un ensemble commun sur chaque élément : `id`, `className`, `style`, `title`, `tabIndex`, `role`, `draggable` et tout attribut `aria-*` / `data-*` (avec tiret, donc `ariaLabel` est ignoré). Tout ce qui sort de ce cadre est silencieusement supprimé, donc exprimez l’état personnalisé sous forme de `data-*`.-Le CSS du composant, qu’il provienne de `import './styles.css'`, de CSS-in-JS ou d’un élément `\<style>`, est injecté dans le `\<head>` de la page hôte **sans portée**. Ainsi, les noms de classes entrent en collision avec ceux de Twenty (préfixez-les, et n’écrivez jamais de `div { ... }` sélecteurs), et `@media` correspond à la fenêtre du navigateur plutôt qu’à votre widget (utilisez `@container` avec votre propre `container-type`). Les props `style` en ligne ne sont pas affectées.+Le CSS du composant, qu’il provienne de `import './styles.css'`, de CSS-in-JS ou d’un élément `style`, est injecté dans le `head` de la page hôte **sans portée**. Ainsi, les noms de classes entrent en collision avec ceux de Twenty (préfixez-les, et n’écrivez jamais de `div { ... }` sélecteurs), et `@media` correspond à la fenêtre du navigateur plutôt qu’à votre widget (utilisez `@container` avec votre propre `container-type`). Les props `style` en ligne ne sont pas affectées.### Stockage et réseau@@ -835,7 +835,7 @@ Le CSS du composant, qu’il provienne de `import './styles.css'`, de CSS-in-JS### Autres lacunes-* **Contenu de fichier.** `<input type="file">` fournit uniquement à votre gestionnaire les métadonnées du fichier, pas les octets, donc `FileReader` et les téléversements ne sont pas encore possibles.+* **Contenu de fichier.** Un `input` de type `file` fournit uniquement à votre gestionnaire les métadonnées du fichier, pas les octets, donc `FileReader` et les téléversements ne sont pas encore possibles.* **Charges utiles de glisser-déposer.** Les événements de glisser-déposer se déclenchent, mais `event.dataTransfer` est `undefined`.* **Modules natifs Node.** `fs`, `path` et `node:crypto` font échouer la construction, donc déplacez ce travail dans une [fonction logique](/l/fr/developers/extend/apps/logic/logic-functions). Web Crypto, `fetch`, `TextEncoder` et `URL` sont disponibles.-* **`\<iframe>`** est toujours à nouveau placé dans un bac à sable sans `allow-same-origin`, donc une intégration qui repose sur sa propre session s’affiche comme déconnectée. Il n’a pas non plus de `onLoad`.+* **`iframe`** est toujours à nouveau placé dans un bac à sable sans `allow-same-origin`, donc une intégration qui repose sur sa propre session s’affiche comme déconnectée. Il n’a pas non plus de `onLoad`.diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/translations/overview.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/translations/overview.mdxindex 0921119754b..ea29095a267 100644--- a/packages/twenty-docs/l/fr/developers/extend/apps/translations/overview.mdx+++ b/packages/twenty-docs/l/fr/developers/extend/apps/translations/overview.mdx@@ -55,8 +55,8 @@ const Card = ({ count, name }: { count: number; name: string }) => {### Quand utiliser quoi-* **`<Trans>…</Trans>`** — texte statique dans JSX. Utilisez les props `message` et `values`- pour l’interpolation (`<Trans message="Hi {name}" values={{ name }} />`) ;+* **`Trans`** — texte statique dans JSX. Utilisez les props `message` et `values` pour+ l’interpolation, comme dans `Trans message="Hi {name}" values={{ name }}`;l’interpolation directement dans les enfants n’est pas extractible statiquement.* **`useTranslate().t`** — chaînes dynamiques à l’intérieur d’un composant. Se réaffiche lorsquel’utilisateur change de langue. À privilégier à l’intérieur du rendu.@@ -85,7 +85,7 @@ twenty dev:translations-extract # collect strings into locales/twenty dev:translations-extract --locale fr-FR # also scaffold a target locale```-L’extraction collecte à la fois les libellés de votre manifeste et les chaînes `t()`/`msg()`/`\<Trans>`+L’extraction collecte à la fois les libellés de votre manifeste et les chaînes `t()`/`msg()`/`Trans`provenant de votre source front-component dans `locales/\<locale>.json`, indexées parchaîne source. Renseignez les traductions :@@ -108,7 +108,7 @@ l’utilisateur actuel : les libellés du manifeste sont résolus côté serveurfront-component sont intégrés à chaque bundle de composant. À l’exécution, un composant lit lalocale depuis son contexte d’exécution (la langue actuelle de l’hôte) et résoutchaque chaîne à partir de son catalogue, en revenant à la source lorsqu’une traduction-manque. Changer la langue dans l’hôte réaffiche en direct les chaînes `\<Trans>` et+manque. Changer la langue dans l’hôte réaffiche en direct les chaînes `Trans` et`useTranslate().t`.Comme les catalogues sont compilés au moment de la build, mettre à jour une traduction implique@@ -120,6 +120,13 @@ surveillance continue `twenty dev` affiche les chaînes source, donc testez la savec une build ponctuelle.</Note>-Les enfants texte de `<Trans>` peuvent s’étendre sur plusieurs lignes — les espaces sont compressés de-la même façon que JSX les compresse, donc `<Trans>Welcome\n back</Trans>` et la clé extraite-deviendront toutes deux `Welcome back`.+Les enfants textuels de `Trans` peuvent s’étendre sur plusieurs lignes — les espaces sont réduits+de la même façon que JSX les réduit, donc ces deux exemples sont extraits avec la clé `Welcome back` :++```tsx+<Trans>Welcome back</Trans>+<Trans>+ Welcome+ back+</Trans>+```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.mdxindex 1bf252d8bec..b9ae936e0ee 100644--- 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@@ -806,22 +806,22 @@ Un `ref` ti restituisce un elemento sandbox, non un `HTMLElement`.| `element.classList.add(...)` | Genera un’eccezione (`classList` è `undefined`) | Costruisci tu stesso la stringa `className` || `document.getElementById()`, `getElementsByClassName()`, `createTreeWalker()` | Genera un’eccezione | `querySelector()` / `querySelectorAll()`, che funzionano || `document.activeElement` | Sempre `undefined` | Tieni traccia del focus con `onFocus` / `onBlur` |-| `\<canvas>` | Non renderizza nulla, nessun errore | SVG, oppure disegna offscreen e mostra un `<img src={dataUrl}>` |+| `canvas` | Non renderizza nulla, nessun errore | SVG, oppure disegna fuori dallo schermo e mostra il risultato in un elemento `img` || `createPortal(node, document.body)` | Non renderizza nulla, mentre `isConnected` segnala successo | Overlay inline con `position: absolute`, oppure passa alla libreria un tuo elemento container |Il gap del portale è il motivo per cui i popover di Radix, Headless UI, MUI e react-select non renderizzano nulla per impostazione predefinita. La maggior parte accetta una prop container; indirizzala a un elemento che hai renderizzato.### Eventi-Mouse, puntatore, touch, drag, tastiera, focus, `input`/`change`/`submit`, `scroll`/`wheel`/`contextmenu` e `animationend`/`transitionend` passano all'host, più alcuni per elemento: `load`/`error` su `<img>`, appunti e composizione su `<input>`/`\<textarea>`, media su `\<video>`/`\<audio>`, `toggle` su `\<details>`/`\<dialog>`. Tutto il resto (`onAuxClick`, `onSelect`, `onInvalid`, `onReset`, `onAnimationStart`, capture del pointer, `onLoad` fuori da `<img>`) viene ignorato senza avviso.+Mouse, puntatore, touch, drag, tastiera, focus, `input`/`change`/`submit`, `scroll`/`wheel`/`contextmenu` e `animationend`/`transitionend` passano all'host, più alcuni per elemento: `load`/`error` su `img`, appunti e composizione su `input`/`textarea`, media su `video`/`audio`, `toggle` su `details`/`dialog`. Tutto il resto (`onAuxClick`, `onSelect`, `onInvalid`, `onReset`, `onAnimationStart`, acquisizione del puntatore, `onLoad` su `img`) viene scartato senza alcun avviso.`document.addEventListener()` e `window.addEventListener()` si registrano senza errori e non vengono mai attivati, motivo per cui un drag si interrompe non appena il puntatore lascia l'elemento da cui è partito. `event.preventDefault()` non viene propagato nemmeno; l'invio dei form, `dragover`/`drop` e i clic sui link sono già protetti per te.### Attributi e stile-Ogni elemento inoltra le proprie proprietà al DOM host (`href` su `\<a>`, `src`/`alt` su `<img>`, `value`/`placeholder`/`disabled` su `<input>`, e così via), più un insieme comune su ogni elemento: `id`, `className`, `style`, `title`, `tabIndex`, `role`, `draggable` e qualsiasi attributo `aria-*` / `data-*` (con trattino, quindi `ariaLabel` viene scartato). Qualsiasi cosa al di fuori di ciò viene silenziosamente scartata, quindi esprimi lo stato personalizzato come `data-*`.+Ogni elemento inoltra le proprie proprietà al DOM host (`href` su `a`, `src`/`alt` su `img`, `value`/`placeholder`/`disabled` su `input`, e così via), più un insieme comune su ogni elemento: `id`, `className`, `style`, `title`, `tabIndex`, `role`, `draggable` e qualsiasi attributo `aria-*` / `data-*` (con trattino, quindi `ariaLabel` viene scartato). Qualsiasi cosa al di fuori di ciò viene silenziosamente scartata, quindi esprimi lo stato personalizzato come `data-*`.-Il CSS del componente, che provenga da `import './styles.css'`, da CSS-in-JS o da un elemento `\<style>`, viene iniettato nel `\<head>` della pagina host **senza ambito**. Quindi i nomi delle classi entrano in conflitto con quelli di Twenty (aggiungi un prefisso e non scrivere mai `div { ... }` come selettori), e `@media` corrisponde alla finestra del browser piuttosto che al tuo widget (usa `@container` con il tuo `container-type`). Le prop `style` inline non sono interessate.+Il CSS del componente, che provenga da `import './styles.css'`, da CSS-in-JS o da un elemento `style`, viene iniettato nell'`head` della pagina host **senza ambito**. Quindi i nomi delle classi entrano in conflitto con quelli di Twenty (aggiungi un prefisso e non scrivere mai `div { ... }` come selettori), e `@media` corrisponde alla finestra del browser piuttosto che al tuo widget (usa `@container` con il tuo `container-type`). Le prop `style` inline non sono interessate.### Storage e rete@@ -835,7 +835,7 @@ Il CSS del componente, che provenga da `import './styles.css'`, da CSS-in-JS o d### Altre lacune-* **Contenuti dei file.** `<input type="file">` fornisce al tuo gestore solo i metadati del file, non i byte, quindi `FileReader` e gli upload non sono ancora possibili.+* **Contenuti dei file.** Un `input` di tipo `file` fornisce al tuo gestore solo i metadati del file, non i byte, quindi `FileReader` e gli upload non sono ancora possibili.* **Payload di drag-and-drop.** Gli eventi di drag vengono attivati, ma `event.dataTransfer` è `undefined`.* **Built-in di Node.** `fs`, `path` e `node:crypto` fanno fallire la build, quindi sposta quel lavoro in una [logic function](/l/it/developers/extend/apps/logic/logic-functions). Web Crypto, `fetch`, `TextEncoder` e `URL` sono disponibili.-* **`\<iframe>`** viene sempre nuovamente messo in sandbox senza `allow-same-origin`, quindi un embed che dipende dalla propria sessione viene renderizzato come disconnesso. Non ha nemmeno `onLoad`.+* **`iframe`** viene sempre nuovamente messo in sandbox senza `allow-same-origin`, quindi un embed che dipende dalla propria sessione viene renderizzato come disconnesso. Non ha nemmeno `onLoad`.diff --git a/packages/twenty-docs/l/it/developers/extend/apps/translations/overview.mdx b/packages/twenty-docs/l/it/developers/extend/apps/translations/overview.mdxindex ce72615183d..296fb530471 100644--- a/packages/twenty-docs/l/it/developers/extend/apps/translations/overview.mdx+++ b/packages/twenty-docs/l/it/developers/extend/apps/translations/overview.mdx@@ -55,9 +55,9 @@ const Card = ({ count, name }: { count: number; name: string }) => {### Quando usare cosa-* **`<Trans>…</Trans>`** — testo statico in JSX. Usa le prop `message` e `values`- per l’interpolazione (`<Trans message="Hi {name}" values={{ name }} />`);- l’interpolazione direttamente nei children non è estraibile staticamente.+* **`Trans`** — testo statico in JSX. Usa le prop `message` e `values` per+ l'interpolazione, come in `Trans message="Hi {name}" values={{ name }}`;+ l'interpolazione direttamente nei figli non è estraibile staticamente.* **`useTranslate().t`** — stringhe dinamiche all’interno di un componente. Esegue il re-render quandol’utente cambia lingua. Preferiscilo all’interno del render.* **`t(...)`** (importato direttamente) — traduzione eager utilizzabile **ovunque**,@@ -85,9 +85,9 @@ twenty dev:translations-extract # collect strings into locales/twenty dev:translations-extract --locale fr-FR # also scaffold a target locale```-L’estrazione raccoglie sia le etichette del manifest sia le stringhe `t()`/`msg()`/`\<Trans>`-dal sorgente dei tuoi front-component in `locales/\<locale>.json`, con chiave-la stringa sorgente. Compila le traduzioni:+L'estrazione raccoglie sia le etichette del manifest sia le stringhe `t()`/`msg()`/`Trans`+dal tuo sorgente front-component in `locales/\<locale>.json`, indicizzate per+stringa sorgente. Compila le traduzioni:```json// locales/fr-FR.json@@ -108,7 +108,7 @@ corrente: le etichette del manifest vengono risolte lato server e i cataloghi defront-component vengono inclusi in ogni bundle di componente. A runtime un componente legge lalocale dal proprio contesto di esecuzione (la lingua corrente dell’host) e risolveogni stringa rispetto al proprio catalogo, facendo fallback alla sorgente quando-una traduzione manca. Il cambio di lingua nell’host esegue il re-render delle stringhe `\<Trans>` e+una traduzione manca. Cambiare lingua nell'host esegue nuovamente il render delle stringhe `Trans` e`useTranslate().t` in tempo reale.Poiché i cataloghi vengono compilati in fase di build, aggiornare una traduzione significa@@ -119,6 +119,13 @@ Le traduzioni vengono compilate da `twenty dev:build` (e `twenty apply`). La modcon una build una tantum.</Note>-I figli di testo di `<Trans>` possono estendersi su più righe — gli spazi bianchi vengono compressi-nello stesso modo in cui JSX li comprime, quindi `<Trans>Welcome\n back</Trans>` e la chiave estratta-diventano entrambi `Welcome back`.+I figli di testo di `Trans` possono estendersi su più righe — gli spazi bianchi vengono compressi+nello stesso modo in cui JSX li comprime, quindi entrambe queste varianti vengono estratte con la chiave `Welcome back`:++```tsx+<Trans>Welcome back</Trans>+<Trans>+ Welcome+ back+</Trans>+```diff --git a/packages/twenty-docs/l/ja/developers/extend/apps/layout/front-components.mdx b/packages/twenty-docs/l/ja/developers/extend/apps/layout/front-components.mdxindex adc99296ac4..2d216d66f76 100644--- a/packages/twenty-docs/l/ja/developers/extend/apps/layout/front-components.mdx+++ b/packages/twenty-docs/l/ja/developers/extend/apps/layout/front-components.mdx@@ -806,22 +806,22 @@ Front components は現在も積極的に開発が進められています。| `element.classList.add(...)` | 例外を投げます(`classList` は `undefined` です) | `className` 文字列を自分で組み立ててください || `document.getElementById()`, `getElementsByClassName()`, `createTreeWalker()` | 例外を投げます | 動作する `querySelector()` / `querySelectorAll()` を使ってください || `document.activeElement` | 常に `undefined` です | `onFocus` / `onBlur` でフォーカスを追跡してください |-| `\<canvas>` | 何もレンダリングされず、エラーも出ません | SVG を使うか、オフスクリーンで描画して `<img src={dataUrl}>` として表示してください |+| `canvas` | 何もレンダリングされず、エラーも出ません | SVG、またはオフスクリーンで描画して、その結果を `img` 要素で表示します || `createPortal(node, document.body)` | `isConnected` は成功を報告しますが、何もレンダリングされません | `position: absolute` によるインラインのオーバーレイを使うか、ライブラリに自前のコンテナー要素を渡してください |このポータルのギャップが原因で、Radix、Headless UI、MUI、react-select のポップオーバーはデフォルトでは何もレンダリングしません。 ほとんどのライブラリは container プロップを受け付けるので、自分がレンダリングした要素を指定してください。### イベント-マウス、ポインター、タッチ、ドラッグ、キーボード、フォーカス、`input`/`change`/`submit`、`scroll`/`wheel`/`contextmenu`、そして `animationend`/`transitionend` はホストへ渡されます。さらに、要素ごとにいくつかのイベントも渡されます:`<img>` の `load`/`error`、`<input>`/`\<textarea>` のクリップボードおよびコンポジション、`\<video>`/`\<audio>` のメディア、`\<details>`/`\<dialog>` の `toggle` などです。 それ以外(`onAuxClick`、`onSelect`、`onInvalid`、`onReset`、`onAnimationStart`、pointer capture、`<img>` の `onLoad`)は、警告なしに破棄されます。+マウス、ポインター、タッチ、ドラッグ、キーボード、フォーカス、`input`/`change`/`submit`、`scroll`/`wheel`/`contextmenu`、そして `animationend`/`transitionend` はホストへ渡されます。さらに、要素ごとにいくつかのイベントも渡されます:`img` の `load`/`error`、`input`/`textarea` のクリップボードおよびコンポジション、`video`/`audio` のメディア、`details`/`dialog` の `toggle` などです。 それ以外(`onAuxClick`、`onSelect`、`onInvalid`、`onReset`、`onAnimationStart`、pointer capture、`img` の `onLoad`)は、警告なしに破棄されます。`document.addEventListener()` と `window.addEventListener()` はエラーなく登録されますが、一度も発火しません。そのため、ドラッグは開始した要素からポインターが離れた瞬間に止まります。 `event.preventDefault()` も渡されません。フォーム送信、`dragover`/`drop`、およびリンクのクリックは、すでに保護されています。### 属性とスタイリング-各要素は自分自身のプロパティをホスト DOM にフォワードします(`\<a>` の `href`、`<img>` の `src`/`alt`、`<input>` の `value`/`placeholder`/`disabled` など)。さらに、すべての要素に共通のプロパティセットもフォワードされます:`id`、`className`、`style`、`title`、`tabIndex`、`role`、`draggable`、および任意の `aria-*` / `data-*` 属性(ハイフン区切りのため、`ariaLabel` は破棄されます)。 それ以外のものはすべて暗黙的に破棄されるため、カスタム状態は `data-*` として表現してください。+各要素は自分自身のプロパティをホスト DOM にフォワードします(`a` の `href`、`img` の `src`/`alt`、`input` の `value`/`placeholder`/`disabled` など)。さらに、すべての要素に共通のプロパティセットもフォワードされます:`id`、`className`、`style`、`title`、`tabIndex`、`role`、`draggable`、および任意の `aria-*` / `data-*` 属性(ハイフン区切りのため、`ariaLabel` は破棄されます)。 それ以外のものはすべて暗黙的に破棄されるため、カスタム状態は `data-*` として表現してください。-コンポーネントの CSS(`import './styles.css'`、CSS-in-JS、または `\<style>` 要素のいずれであっても)は、ホストページの `\<head>` に **スコープなし(unscoped)** で挿入されます。 そのため、クラス名が Twenty 独自のクラス名と衝突します(プレフィックスを付け、決して素の `div { ... }` セレクタは書かないでください)。また、`@media` はウィジェットではなくブラウザウィンドウに対してマッチします(独自の `container-type` を指定した `@container` を使用してください)。 インラインの `style` props には影響しません。+コンポーネントの CSS(`import './styles.css'`、CSS-in-JS、または `style` 要素のいずれであっても)は、ホストページの `head` に **スコープなし(unscoped)** で挿入されます。 そのため、クラス名が Twenty 独自のクラス名と衝突します(プレフィックスを付け、決して素の `div { ... }` セレクタは書かないでください)。また、`@media` はウィジェットではなくブラウザウィンドウに対してマッチします(独自の `container-type` を指定した `@container` を使用してください)。 インラインの `style` props には影響しません。### ストレージとネットワーク@@ -835,7 +835,7 @@ Front components は現在も積極的に開発が進められています。### その他のギャップ-* **ファイル内容。** `<input type="file">` は、ハンドラーにファイルのメタデータのみを渡し、バイト列は渡さないため、`FileReader` やアップロードはまだ利用できません。+* **ファイル内容。** type が `file` の `input` は、ハンドラーにファイルのメタデータのみを渡し、バイト列は渡さないため、`FileReader` やアップロードはまだ利用できません。* **ドラッグ&ドロップのペイロード。** ドラッグイベントは発火しますが、`event.dataTransfer` は `undefined` です。* **Node 組み込みモジュール。** `fs`、`path`、`node:crypto` はビルドに失敗するため、その処理は [ロジック関数](/l/ja/developers/extend/apps/logic/logic-functions) に移動してください。 Web Crypto、`fetch`、`TextEncoder`、および `URL` は利用可能です。-* **`\<iframe>`** は常に `allow-same-origin` なしで再サンドボックス化されるため、独自のセッションに依存する埋め込みは、ログアウト状態としてレンダリングされます。 また、`onLoad` もありません。+* **`iframe`** は常に `allow-same-origin` なしで再サンドボックス化されるため、独自のセッションに依存する埋め込みは、ログアウト状態としてレンダリングされます。 また、`onLoad` もありません。diff --git a/packages/twenty-docs/l/ja/developers/extend/apps/translations/overview.mdx b/packages/twenty-docs/l/ja/developers/extend/apps/translations/overview.mdxindex f035835b616..e3cbc9840c1 100644--- a/packages/twenty-docs/l/ja/developers/extend/apps/translations/overview.mdx+++ b/packages/twenty-docs/l/ja/developers/extend/apps/translations/overview.mdx@@ -49,9 +49,9 @@ const Card = ({ count, name }: { count: number; name: string }) => {### When to use which-* **`<Trans>…</Trans>`** — JSX の静的テキスト。 `message` と `values`- プロパティを使用して補間(`<Trans message="Hi {name}" values={{ name }} />`); 子要素に直接補間する- は静的に抽出できません。+* **`Trans`** — JSX 内の静的テキストです。 補間には `message` と `values` の props を使用します。+ 例: `Trans message="Hi {name}" values={{ name }}` のようにします。+ 子要素内で直接補間すると、静的に抽出できません。* **`useTranslate().t`** — コンポーネント内の動的文字列。ユーザーが言語を切り替えたときに再レンダリングします。 これをレンダリング内で好みます。* **`t(...)`** (imported directly) — eager translation used **anywhere** ,@@ -78,7 +78,7 @@ twenty dev:translations-extract # collect strings into locales/twenty dev:translations-extract --locale fr-FR # also scaffold a target locale```-抽出処理では、マニフェストのラベルとフロントコンポーネントのソース内にある `t()`/`msg()`/`\<Trans>` の文字列の両方が収集され、ソース文字列をキーとして `locales/\<locale>.json` にまとめられます。 翻訳を入力:+抽出処理では、マニフェストのラベルとフロントコンポーネントのソース内にある `t()`/`msg()`/`Trans` の文字列の両方が収集され、ソース文字列をキーとして `locales/\<locale>.json` にまとめられます。 翻訳を入力:```json// locales/fr-FR.json@@ -94,8 +94,8 @@ twenty dev:translations-extract --locale fr-FR # also scaffold a target locale## 動作方法-`twenty dev:build` はカタログをコンパイルし、現在のユーザーに対して適切な言語を提供します。マニフェストのラベルはサーバー側で解決され、フロントコンポーネントのカタログは各コンポーネントバンドルに組み込まれます。 実行時には、コンポーネントが実行コンテキスト(ホストの現在の言語)からロケールを読み取り、そのカタログに対して各文字列を解決し、翻訳が存在しない場合はソースにフォールバックします。 ホストの再レンダリングで言語を切り替えます。`\<Trans>` と-`useTranslate().t` 文字列は動作します。+`twenty dev:build` はカタログをコンパイルし、現在のユーザーに対して適切な言語を提供します。マニフェストのラベルはサーバー側で解決され、フロントコンポーネントのカタログは各コンポーネントバンドルに組み込まれます。 実行時には、コンポーネントが実行コンテキスト(ホストの現在の言語)からロケールを読み取り、そのカタログに対して各文字列を解決し、翻訳が存在しない場合はソースにフォールバックします。 ホスト側で言語を切り替えると、`Trans` と+`useTranslate().t` の文字列が即時に再レンダリングされます。カタログはビルド時にコンパイルされるため、翻訳を更新すると、他の変更と同じように、`20dev:build` を再実行(および再デプロイ)することになります。@@ -106,4 +106,12 @@ twenty dev:translations-extract --locale fr-FR # also scaffold a target localeをテストします。</Note>-`<Trans>` のテキスト子要素は複数行にまたがってもかまいません — 空白は JSX と同じように折りたたまれるため、`<Trans>Welcome\n back</Trans>` と抽出されたキーはどちらも `Welcome back` になります。+`Trans` のテキスト子要素は複数行にまたがってもかまいません — 空白は JSX と同じように折りたたまれるため、どちらもキー `Welcome back` として抽出されます:++```tsx+<Trans>Welcome back</Trans>+<Trans>+ Welcome+ back+</Trans>+```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.mdxindex 3225f3eefbd..05cc9dc414a 100644--- 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@@ -806,22 +806,22 @@ Front 컴포넌트는 활발히 개발 중입니다. 렌더링, 스타일링 및| `element.classList.add(...)` | 예외 발생(`classList`는 `undefined`임) | `className` 문자열을 직접 구성하세요. || `document.getElementById()`, `getElementsByClassName()`, `createTreeWalker()` | 예외 발생 | 정상 동작하는 `querySelector()` / `querySelectorAll()`을 사용 || `document.activeElement` | 항상 `undefined` | `onFocus` / `onBlur`로 포커스를 추적하세요. |-| `\<canvas>` | 아무것도 렌더링되지 않으며, 오류도 없습니다. | SVG를 사용하거나, 오프스크린에서 그린 뒤 `<img src={dataUrl}>`로 표시하세요. |+| `canvas` | 아무것도 렌더링되지 않으며, 오류도 없습니다. | SVG 또는 오프스크린에서 그린 뒤 결과를 `img` 요소에 표시 || `createPortal(node, document.body)` | `isConnected`는 성공으로 보고하지만 아무것도 렌더링되지 않습니다 | `position: absolute`로 인라인 오버레이를 사용하거나 라이브러리에 직접 렌더링한 컨테이너 요소를 전달하세요 |이 포털 간극 때문에 Radix, Headless UI, MUI, react-select의 팝오버는 기본적으로 아무것도 렌더링하지 않습니다. 대부분 컨테이너 prop을 받으므로, 직접 렌더링한 요소를 가리키도록 설정하세요.### 이벤트-마우스, 포인터, 터치, 드래그, 키보드, 포커스, `input`/`change`/`submit`, `scroll`/`wheel`/`contextmenu` 그리고 `animationend`/`transitionend` 이벤트는 호스트로 전달되며, 여기에 요소별로 몇 가지가 더해집니다: `<img>`의 `load`/`error`, `<input>`/`\<textarea>`의 클립보드 및 조합(composition), `\<video>`/`\<audio>`의 미디어, `\<details>`/`\<dialog>`의 `toggle` 등입니다. 그 밖의 것들(`onAuxClick`, `onSelect`, `onInvalid`, `onReset`, `onAnimationStart`, 포인터 캡처, `<img>`의 `onLoad` 등)은 경고 없이 모두 무시됩니다.+마우스, 포인터, 터치, 드래그, 키보드, 포커스, `input`/`change`/`submit`, `scroll`/`wheel`/`contextmenu` 그리고 `animationend`/`transitionend` 이벤트는 호스트로 전달되며, 여기에 요소별로 몇 가지가 더해집니다: `img`의 `load`/`error`, `input`/`textarea`의 클립보드 및 조합(composition), `video`/`audio`의 미디어, `details`/`dialog`의 `toggle` 등입니다. 그 밖의 것들(`onAuxClick`, `onSelect`, `onInvalid`, `onReset`, `onAnimationStart`, 포인터 캡처, `img`의 `onLoad` 등)은 경고 없이 모두 무시됩니다.`document.addEventListener()`와 `window.addEventListener()`는 오류 없이 등록되지만 절대 실행되지 않으며, 이 때문에 드래그는 시작한 요소를 벗어나는 순간 중지됩니다. `event.preventDefault()` 역시 전달되지 않습니다. 폼 제출, `dragover`/`drop` 및 링크 클릭은 이미 보호되어 있습니다.### 속성과 스타일링-각 요소는 자신의 속성을 호스트 DOM으로 전달합니다(`href`는 `\<a>`, `src`/`alt`는 `<img>`, `value`/`placeholder`/`disabled`는 `<input>` 등). 또한 모든 요소에 공통으로 `id`, `className`, `style`, `title`, `tabIndex`, `role`, `draggable`, 그리고 하이픈이 포함된 모든 `aria-*` / `data-*` 속성(따라서 `ariaLabel`은 무시됨)을 전달합니다. 그 외의 속성은 조용히 폐기되므로, 사용자 정의 상태는 `data-*`로 표현하세요.+각 요소는 자신의 속성을 호스트 DOM으로 전달합니다(`a`의 `href`, `img`의 `src`/`alt`, `input`의 `value`/`placeholder`/`disabled` 등). 또한 모든 요소에 공통으로 `id`, `className`, `style`, `title`, `tabIndex`, `role`, `draggable`, 그리고 하이픈이 포함된 모든 `aria-*` / `data-*` 속성(따라서 `ariaLabel`은 무시됨)을 전달합니다. 그 외의 속성은 조용히 폐기되므로, 사용자 정의 상태는 `data-*`로 표현하세요.-컴포넌트 CSS는 `import './styles.css'`, CSS-in-JS 또는 `\<style>` 요소에서 오든, 호스트 페이지의 `\<head>`에 **범위 없이(unscoped)** 주입됩니다. 따라서 클래스 이름이 Twenty 자체 것과 충돌합니다(접두사를 붙이고, `div { ... }` 선택자를 직접 작성하지 마세요). 그리고 `@media`는 위젯이 아니라 브라우저 창을 기준으로 매칭됩니다(직접 지정한 `container-type`과 함께 `@container`를 사용하세요). 인라인 `style` prop은 영향을 받지 않습니다.+컴포넌트 CSS는 `import './styles.css'`, CSS-in-JS 또는 `style` 요소에서 오든, 호스트 페이지의 `head`에 **범위 없이(unscoped)** 주입됩니다. 따라서 클래스 이름이 Twenty 자체 것과 충돌합니다(접두사를 붙이고, `div { ... }` 선택자를 직접 작성하지 마세요). 그리고 `@media`는 위젯이 아니라 브라우저 창을 기준으로 매칭됩니다(직접 지정한 `container-type`과 함께 `@container`를 사용하세요). 인라인 `style` prop은 영향을 받지 않습니다.### 스토리지와 네트워크@@ -835,7 +835,7 @@ Front 컴포넌트는 활발히 개발 중입니다. 렌더링, 스타일링 및### 기타 제약 사항-* **파일 내용.** `<input type="file">`은 핸들러에 바이트가 아닌 파일 메타데이터만 제공하므로, 현재는 `FileReader` 사용과 업로드가 불가능합니다.+* **파일 내용.** `file` 타입의 `input`은 핸들러에 바이트가 아닌 파일 메타데이터만 제공하므로, 현재는 `FileReader` 사용과 업로드가 불가능합니다.* **드래그 앤 드롭 페이로드.** 드래그 이벤트는 발생하지만, `event.dataTransfer`는 `undefined`입니다.* **Node 내장 모듈.** `fs`, `path` 및 `node:crypto`는 빌드에 실패하므로, 해당 작업은 [logic function](/l/ko/developers/extend/apps/logic/logic-functions)으로 옮기세요. Web Crypto, `fetch`, `TextEncoder` 및 `URL`은 사용할 수 있습니다.-* \*\*`\<iframe>`\*\*은 항상 `allow-same-origin` 없이 다시 샌드박싱되므로, 자체 세션에 의존하는 임베드는 로그아웃된 상태로 렌더링됩니다. 또한 `onLoad`도 지원되지 않습니다.+* \*\*`iframe`\*\*은 항상 `allow-same-origin` 없이 다시 샌드박싱되므로, 자체 세션에 의존하는 임베드는 로그아웃된 상태로 렌더링됩니다. 또한 `onLoad`도 지원되지 않습니다.diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/translations/overview.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/translations/overview.mdxindex 9dcd5286e10..44ae447fbd1 100644--- a/packages/twenty-docs/l/ko/developers/extend/apps/translations/overview.mdx+++ b/packages/twenty-docs/l/ko/developers/extend/apps/translations/overview.mdx@@ -51,8 +51,8 @@ const Card = ({ count, name }: { count: number; name: string }) => {### 언제 무엇을 사용할지-* **`<Trans>…</Trans>`** — JSX 안의 정적 텍스트입니다. 보간을 위해 `message` 및 `values`- props를 사용하세요 (`<Trans message="Hi {name}" values={{ name }} />`);+* **`Trans`** — JSX 안의 정적 텍스트입니다. 보간을 위해 `message` 및 `values` props를 사용하세요+ (`Trans message="Hi {name}" values={{ name }}`);children 안에서 직접 보간하는 것은 정적으로 추출할 수 없습니다.* **`useTranslate().t`** — 컴포넌트 내부에서 사용하는 동적 문자열입니다. 사용자가 언어를 전환하면다시 렌더링됩니다. render 내부에서는 이것을 사용하는 것을 권장합니다.@@ -79,7 +79,7 @@ twenty dev:translations-extract # collect strings into locales/twenty dev:translations-extract --locale fr-FR # also scaffold a target locale```-추출 과정에서는 manifest 레이블과 front-component 소스의 `t()`/`msg()`/`\<Trans>`+추출 과정에서는 manifest 레이블과 front-component 소스의 `t()`/`msg()`/`Trans`문자열을 모두 `locales/\<locale>.json` 파일에 소스 문자열을 키로 하여 수집합니다. 번역을 채워 넣으세요:```json@@ -96,7 +96,7 @@ twenty dev:translations-extract --locale fr-FR # also scaffold a target locale## 실행 방식`twenty dev:build`는 카탈로그를 컴파일하고 현재 사용자에게 맞는 언어를 제공합니다.-manifest 레이블은 서버 측에서 처리되고, front-component 카탈로그는 각 컴포넌트 번들에 내장됩니다. 런타임에는 컴포넌트가 실행 컨텍스트(호스트의 현재 언어)에서 로케일을 읽고, 각 문자열을 해당 카탈로그에서 찾아 해석하며, 번역이 없으면 소스 텍스트로 대체합니다. 호스트에서 언어를 전환하면 `\<Trans>`와+manifest 레이블은 서버 측에서 처리되고, front-component 카탈로그는 각 컴포넌트 번들에 내장됩니다. 런타임에는 컴포넌트가 실행 컨텍스트(호스트의 현재 언어)에서 로케일을 읽고, 각 문자열을 해당 카탈로그에서 찾아 해석하며, 번역이 없으면 소스 텍스트로 대체합니다. 호스트에서 언어를 전환하면 `Trans`와`useTranslate().t` 문자열이 실시간으로 다시 렌더링됩니다.카탈로그는 빌드 시점에 컴파일되므로, 번역을 업데이트하려면@@ -107,5 +107,13 @@ manifest 레이블은 서버 측에서 처리되고, front-component 카탈로로컬라이즈된 출력을 테스트하려면 일회성 빌드를 수행하세요.</Note>-`<Trans>`의 텍스트 children은 여러 줄에 걸쳐 있을 수 있으며 — 공백은 JSX에서와 동일한 방식으로-축약되므로, `<Trans>Welcome\n back</Trans>`과 추출된 key는 모두 `Welcome back`이 됩니다.+`Trans`의 텍스트 children은 여러 줄에 걸쳐 있을 수 있으며 — 공백은 JSX에서와 동일한 방식으로 축약되므로,+둘 다 `Welcome back` 키로 추출됩니다.++```tsx+<Trans>Welcome back</Trans>+<Trans>+ Welcome+ back+</Trans>+```diff --git a/packages/twenty-docs/l/pt/developers/contribute/capabilities/bug-and-requests.mdx b/packages/twenty-docs/l/pt/developers/contribute/capabilities/bug-and-requests.mdxindex d8a2fac2941..9ae733d293e 100644--- a/packages/twenty-docs/l/pt/developers/contribute/capabilities/bug-and-requests.mdx+++ b/packages/twenty-docs/l/pt/developers/contribute/capabilities/bug-and-requests.mdx@@ -22,7 +22,7 @@ Contribuir com código para o Twenty começa com um pull request (PR).1. Confira as [issues existentes](https://github.com/twentyhq/twenty/issues) para trabalhos relacionados2. Para novas funcionalidades, abra primeiro uma issue para discutir-3. Consulte nosso [Código de Conduta](https://github.com/twentyhq/twenty/blob/main/CODE_OF_CONDUCT.md)+3. Consulte nosso [Código de Conduta](https://github.com/twentyhq/twenty/blob/main/.github/CODE_OF_CONDUCT.md)### Fork e clonediff --git a/packages/twenty-docs/l/pt/developers/contribute/contribute.mdx b/packages/twenty-docs/l/pt/developers/contribute/contribute.mdxindex 33eca4b63e9..b9a17c86e3b 100644--- a/packages/twenty-docs/l/pt/developers/contribute/contribute.mdx+++ b/packages/twenty-docs/l/pt/developers/contribute/contribute.mdx@@ -25,7 +25,7 @@ O Twenty é de código aberto e recebe contribuições da comunidade. Seja corri<Card title="Relatos de bugs e solicitações" icon="bug" href="/l/pt/developers/contribute/capabilities/bug-and-requests">Relate problemas ou solicite funcionalidades</Card>- <Card title="Desenvolvimento Frontend" icon="browser" href="/l/pt/developers/contribute/capabilities/frontend-development">+ <Card title="Desenvolvimento Frontend" icon="browser" href="/desenvolvedores/contribuir/recursos/frontend-development/folder-architecture-front">Contribua para a UI</Card></CardGroup>diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/config/application.mdxindex 5d0641cecf3..b1678baabfc 100644--- a/packages/twenty-docs/l/pt/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/apps/config/application.mdx@@ -37,6 +37,7 @@ Notas:* As funções de pré-instalação, pós-instalação e desinstalação são detectadas automaticamente durante a construção do manifesto — você não precisa referenciá-las em `defineApplication()`.* Passar `defaultRoleUniversalIdentifier` explicitamente ainda é compatível para retrocompatibilidade, mas foi preterido em favor de `defineApplicationRole()`.* `serverVariables` são configurações e segredos com escopo de instância (por exemplo, chaves de API). Ao contrário de `applicationVariables`, eles não declaram nenhum valor no manifesto — o operador do workspace os preenche nas configurações do app, e eles são injetados nas funções de lógica somente depois de definidos.+* Ambos os tipos de variável aceitam `isDeprecated: true`. Use isso para aposentar uma variável em vez de excluí-la: manter a chave declarada preserva o valor armazenado (excluí-la destrói o valor inserido pelo operador), e a variável ainda é injetada, para que seu código possa fazer fallback para ela — `process.env.NEW_API_KEY ?? process.env.API_KEY`. Uma variável obsoleta desaparece das configurações do aplicativo assim que não tiver valor e nunca é contabilizada na verificação de configuração do aplicativo, portanto `isDeprecated` prevalece sobre `isRequired`.* Para renderizar uma interface de configuração personalizada na guia **Configurações** do app (no lugar da seção padrão de configuração de variáveis), declare um componente de front-end com [`defineSettingsFrontComponent()`](/l/pt/developers/extend/apps/layout/front-components#custom-settings-component) em seu próprio arquivo. Só é permitido um por app. Seções gerenciadas pelo sistema (atualização automática, URL do app, conexões) permanecem sempre visíveis.## Tipos de variáveisdiff --git a/packages/twenty-docs/l/pt/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/config/roles.mdxindex 173a1129e6f..e8c909957fd 100644--- a/packages/twenty-docs/l/pt/developers/extend/apps/config/roles.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/apps/config/roles.mdx@@ -204,4 +204,4 @@ Notas:* Comece a partir do papel gerado pelo scaffold e, em seguida, restrinja-o progressivamente — o padrão concede amplo acesso de leitura, o que raramente é o que você quer em produção.* Substitua `objectPermissions` e `fieldPermissions` pelos objetos e campos de que suas funções realmente precisam.* `permissionFlagUniversalIdentifiers` controlam o acesso a recursos em nível de plataforma. Mantenha-os no mínimo necessário.-* Veja um exemplo 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).+* Veja um exemplo de trabalho: [`exemplos/hello-world/src/roles/default-role.ts`](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/examples/hello-world/src/roles/default-role.ts).diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/data/objects.mdxindex 036dce88240..4fefc26e15e 100644--- a/packages/twenty-docs/l/pt/developers/extend/apps/data/objects.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/apps/data/objects.mdx@@ -79,6 +79,7 @@ export default defineObject({* O `universalIdentifier` deve ser exclusivo e estável entre implantações.* Cada campo requer `name`, `type`, `label` e seu próprio `universalIdentifier` estável.* O array `fields` é opcional — você pode definir objetos sem campos personalizados.+* `openRecordIn` define onde os registros deste objeto são abertos quando clicados: `ObjectOpenRecordIn.USER_CHOICE` (o padrão, seguindo a preferência de cada membro do workspace em Settings → Experience), `ObjectOpenRecordIn.SIDE_PANEL` ou `ObjectOpenRecordIn.RECORD_PAGE`. Fixe em `RECORD_PAGE` para registros que precisam de uma página inteira para serem utilizáveis, como acontece com fluxos de trabalho e dashboards, ou em `SIDE_PANEL` para registros que só fazem sentido como um painel rápido, como acontece com eventos de calendário.* Campos inline definidos aqui **não** precisam de `objectUniversalIdentifier` — ele é herdado do objeto pai. Use [`defineField()`](/l/pt/developers/extend/apps/data/extending-objects) para adicionar campos a objetos que não pertencem a você.* Você pode criar novos objetos com `yarn twenty dev:add object`, que orienta você na definição de nomes, campos e relacionamentos. Veja [Arquitetura → Scaffolding de entidades](/l/pt/developers/extend/apps/getting-started/scaffolding).@@ -138,4 +139,4 @@ Alterações em `isNullable` são aplicadas em todas as sincronizações, inclui* **Conecte este objeto a outros** — veja [Relações](/l/pt/developers/extend/apps/data/relations) para o padrão de relação bidirecional.* **Adicione campos a objetos de outros apps** — veja [Extensão de objetos](/l/pt/developers/extend/apps/data/extending-objects) para `defineField()`.-* **Exiba este objeto na interface** — veja [Views](/l/pt/developers/extend/apps/layout/views) e [Itens do menu de navegação](/l/pt/developers/extend/apps/layout/navigation-menu-items) para colocá‑lo na barra lateral.+* **Exibir este objeto na interface do usuário (UI)** — consulte [Itens do menu de navegação](/l/pt/developers/extend/apps/layout/navigation-menu-items) para adicionar uma entrada na barra lateral; consulte [Views](/l/pt/developers/extend/apps/layout/views) para adicionar configurações de lista personalizadas.diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/data/system-fields.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/data/system-fields.mdxindex 98969e71f66..5233f1040bb 100644--- a/packages/twenty-docs/l/pt/developers/extend/apps/data/system-fields.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/apps/data/system-fields.mdx@@ -144,23 +144,26 @@ Assim como acontece com campos de sistema escalares, o id resolvido funciona emestão disponíveis a partir da versão 2.26 do `twenty-sdk` e requerem um servidor Twenty na versão 2.26 ou posterior.</Note>-O servidor também provisiona uma **visualização de sistema** em cada objeto: a visualização principal de lista (`All {objectLabelPlural}`, com chave `ViewKey.INDEX`), com uma coluna por campo exibível. Assim como os campos de relação de sistema, seus identificadores são derivados **sem usar nomes**, então renomear um objeto ou um campo nunca os altera.+O servidor também provisiona uma **visualização de sistema** em cada objeto: a visualização principal de lista (`All {objectLabelPlural}`, com chave `ViewKey.INDEX` (derivada com `SYSTEM_VIEW_KEYS.INDEX`)), com uma coluna por campo exibível. Assim como os campos de relação de sistema, seus identificadores são derivados **sem usar nomes**, então renomear um objeto ou um campo nunca os altera.Use `getSystemViewUniversalIdentifier` para resolvê‑la:```ts-import { getSystemViewUniversalIdentifier, ViewKey } from 'twenty-sdk/define';+import {+ getSystemViewUniversalIdentifier,+ SYSTEM_VIEW_KEYS,+} from 'twenty-sdk/define';const rocketIndexViewId = getSystemViewUniversalIdentifier({objectMetadataApplicationUniversalIdentifier: APPLICATION_UNIVERSAL_IDENTIFIER,objectUniversalIdentifier: ROCKET_OBJECT_UNIVERSAL_IDENTIFIER,- viewKey: ViewKey.INDEX,+ viewKey: SYSTEM_VIEW_KEYS.INDEX,});```* `objectMetadataApplicationUniversalIdentifier` é o aplicativo proprietário do **objeto**, que define o namespace da visualização.* `objectUniversalIdentifier` é o objeto que a visualização lista.-* `viewKey` é a chave da visualização de sistema, hoje `ViewKey.INDEX`.+* `viewKey` é o discriminador de visualização de sistema: `SYSTEM_VIEW_KEYS.INDEX` para a visualização principal de lista, `SYSTEM_VIEW_KEYS.FIELDS_WIDGET` para a visualização do widget de campos da página de registro. Ele é a chave da derivação; apenas `INDEX` também é armazenado na linha da visualização.O id resolvido funciona em qualquer lugar em que um `viewUniversalIdentifier` seja esperado, como uma entrada de barra lateral [`NavigationMenuItemType.VIEW`](/l/pt/developers/extend/apps/layout/navigation-menu-items). Para simplesmente abrir a lista principal de um objeto, prefira `NavigationMenuItemType.OBJECT` com `targetObjectUniversalIdentifier`: isso não precisa de derivação.diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/getting-started/concepts.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/getting-started/concepts.mdxindex 4ea05a6bba7..1e6ed262f43 100644--- a/packages/twenty-docs/l/pt/developers/extend/apps/getting-started/concepts.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/apps/getting-started/concepts.mdx@@ -34,22 +34,23 @@ your-app/## Tipos de entidade-| Entidade | Finalidade | Documentação |-| ----------------------------- | --------------------------------------------------- | ---------------------------------------------------------------------------------- |-| **Aplicação** | Identidade da aplicação, função padrão, variáveis | [Configuração da aplicação](/l/pt/developers/extend/apps/config/application) |-| **Papel** | Conjuntos de permissões para objetos e campos | [Papéis e permissões](/l/pt/developers/extend/apps/config/roles) |-| **Objeto** | Tipos de registro personalizados com campos | [Objetos](/l/pt/developers/extend/apps/data/objects) |-| **Campo** | Adicionar campos a objetos de outros apps | [Extensão de objetos](/l/pt/developers/extend/apps/data/extending-objects) |-| **Relação** | Links bidirecionais entre objetos | [Relações](/l/pt/developers/extend/apps/data/relations) |-| **Função lógica** | TypeScript no lado do servidor com gatilhos | [Funções lógicas](/l/pt/developers/extend/apps/logic/logic-functions) |-| **Habilidade** | Instruções reutilizáveis para agentes de IA | [Habilidades e Agentes](/l/pt/developers/extend/apps/logic/skills-and-agents) |-| **Agente** | Assistentes de IA com prompts personalizados | [Habilidades e Agentes](/l/pt/developers/extend/apps/logic/skills-and-agents) |-| **Provedor de conexão** | Credenciais OAuth para APIs de terceiros | [Conexões](/l/pt/developers/extend/apps/logic/connections) |-| **Vista** | Vistas de lista de registros pré-configuradas | [Vistas](/l/pt/developers/extend/apps/layout/views) |-| **Item do menu de navegação** | Entradas personalizadas na barra lateral | [Itens do menu de navegação](/l/pt/developers/extend/apps/layout/navigation-menu-items) |-| **Layout da Página** | Abas e widgets na página de detalhes de um registro | [Layouts de página](/l/pt/developers/extend/apps/layout/page-layouts) |-| **Componente de front-end** | UI React em sandbox dentro do Twenty | [Componentes de front-end](/l/pt/developers/extend/apps/layout/front-components) |-| **Item do menu de comandos** | Ações rápidas e entradas Cmd+K | [Itens do menu de comandos](/l/pt/developers/extend/apps/layout/command-menu-items) |+| Entidade | Finalidade | Documentação |+| ------------------------------- | --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |+| **Aplicação** | Identidade da aplicação, função padrão, variáveis | [Configuração da aplicação](/l/pt/developers/extend/apps/config/application) |+| **Papel** | Conjuntos de permissões para objetos e campos | [Papéis e permissões](/l/pt/developers/extend/apps/config/roles) |+| **Objeto** | Tipos de registro personalizados com campos | [Objetos](/l/pt/developers/extend/apps/data/objects) |+| **Campo** | Adicionar campos a objetos de outros apps | [Extensão de objetos](/l/pt/developers/extend/apps/data/extending-objects) |+| **Relação** | Links bidirecionais entre objetos | [Relações](/l/pt/developers/extend/apps/data/relations) |+| **Função lógica** | TypeScript no lado do servidor com gatilhos | [Funções lógicas](/l/pt/developers/extend/apps/logic/logic-functions) |+| **Habilidade** | Instruções reutilizáveis para agentes de IA | [Habilidades e Agentes](/l/pt/developers/extend/apps/logic/skills-and-agents) |+| **Agente** | Assistentes de IA com prompts personalizados | [Habilidades e Agentes](/l/pt/developers/extend/apps/logic/skills-and-agents) |+| **Provedor de conexão** | Credenciais OAuth para APIs de terceiros | [Conexões](/l/pt/developers/extend/apps/logic/connections) |+| **Vista** | Vistas de lista de registros pré-configuradas | [Vistas](/l/pt/developers/extend/apps/layout/views) |+| **Item do menu de navegação** | Entradas personalizadas na barra lateral | [Itens do menu de navegação](/l/pt/developers/extend/apps/layout/navigation-menu-items) |+| **Layout da Página** | Abas e widgets na página de detalhes de um registro | [Layouts de página](/l/pt/developers/extend/apps/layout/page-layouts) |+| **Componente de front-end** | UI React em sandbox dentro do Twenty | [Componentes de front-end](/l/pt/developers/extend/apps/layout/front-components) |+| **Dependências compartilhadas** | Dependências compartilhadas pelos componentes de front-end do app, declaradas em package.json | [Dependências compartilhadas](/l/pt/developers/extend/apps/layout/front-components#sharing-dependencies-across-front-components) |+| **Item do menu de comandos** | Ações rápidas e entradas Cmd+K | [Itens do menu de comandos](/l/pt/developers/extend/apps/layout/command-menu-items) |## Sandboxingdiff --git a/packages/twenty-docs/l/pt/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/getting-started/project-structure.mdxindex 640d6c5bd81..0f2cc72f168 100644--- a/packages/twenty-docs/l/pt/developers/extend/apps/getting-started/project-structure.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/apps/getting-started/project-structure.mdx@@ -76,4 +76,4 @@ O scaffolder fixa `twenty-sdk` e `twenty-client-sdk` para a sua própria versãoManter qualquer um dos pacotes em `dependencies` o inclui no bundle de runtime do aplicativo instalado, onde ele é peso morto. `twenty dev:build` emite um aviso quando qualquer um deles ainda está listado em `dependencies`.-Adicione as dependências de runtime do próprio aplicativo (bibliotecas que as suas funções de lógica realmente importam em tempo de execução) em `dependencies`, como de costume.+Adicione as dependências de runtime do próprio aplicativo (bibliotecas que as suas funções de lógica realmente importam em tempo de execução) em `dependencies`, como de costume. Mantenha a árvore enxuta: `dependencies` são instaladas em uma camada de runtime limitada a 250MB descompactados, e um comando de sync ou install falha com um erro de tamanho de dependencies acima desse valor — bibliotecas de UI e ferramentas de desenvolvimento pertencem a `devDependencies`.diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/layout/front-components.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/layout/front-components.mdxindex 3975533076b..8b06ed75b2f 100644--- a/packages/twenty-docs/l/pt/developers/extend/apps/layout/front-components.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/apps/layout/front-components.mdx@@ -6,6 +6,10 @@ icon: window-maximizeComponentes de front-end são componentes React que renderizam diretamente dentro da UI do Twenty. Eles são executados em um **Web Worker isolado** usando Remote DOM — seu código é executado dentro de um iframe de origem opaca e em sandbox, mas sua interface ainda é renderizada de forma nativa na página em vez de ficar confinada a esse iframe.+<Warning>+Os componentes da frente ainda estão em desenvolvimento activo. Seu código roda contra um DOM parcial, não uma página real do navegador, então usos avançados podem falhar, geralmente silenciosamente. Veja [Limitação atual](#current-limitations).+</Warning>+## Onde os componentes de front-end podem ser usadosOs componentes de front-end podem ser renderizados em três locais dentro do Twenty:@@ -69,7 +73,7 @@ Clique nele para renderizar o componente inline.| Campo | Obrigatório | Descrição || --------------------- | ----------- | ---------------------------------------------------------------------------- |-| `universalIdentifier` | Sim | ID único e estável para este componente |+| `universalIdentifier` | sim | ID único e estável para este componente || `component` | Sim | Uma função de componente React || `name` | Não | Nome de Exibição || `description` | Não | Descrição do que o componente faz |@@ -516,6 +520,39 @@ export default defineFrontComponent({});```+### Armazenamento++`localStorage` e `sessionStorage` funcionam como em uma página normal, com a API síncrona padrão. Suas chaves são limitadas à instalação do seu app e ao usuário conectado: nenhum outro app pode lê-las, e outro usuário que entrar no mesmo navegador começará com um armazenamento vazio. Os valores gravados em `localStorage` permanecem no dispositivo entre recarregamentos; `sessionStorage` permanece durante a sessão do navegador.++```tsx src/front-components/note-draft.tsx+import { useState } from 'react';+import { defineFrontComponent } from 'twenty-sdk/define';++const NoteDraft = () => {+ const [draft, setDraft] = useState(() => localStorage.getItem('draft') ?? '');++ const handleChange = (nextDraft: string) => {+ setDraft(nextDraft);+ localStorage.setItem('draft', nextDraft);+ };++ return (+ <textarea value={draft} onChange={(event) => handleChange(event.target.value)} />+ );+};++export default defineFrontComponent({+ universalIdentifier: 'd0e1f2a3-b4c5-6789-def0-890123456789',+ name: 'note-draft',+ description: 'Keeps an unsaved note on this device',+ component: NoteDraft,+});+```++Twenty armazena os valores em nome do seu app, então uma gravação é aplicada localmente imediatamente e salva em segundo plano. Leituras nunca esperam pelo host. Nada é sincronizado: os valores não acompanham o usuário para outro navegador ou máquina, portanto use o [armazenamento de chave-valor](/l/pt/developers/extend/apps/logic/key-value-store) de uma função de lógica para qualquer coisa que precise sobreviver a uma troca de dispositivo.++As gravações têm limite, e cada limite contabiliza caracteres em vez de bytes: as chaves têm no máximo 512 caracteres, um único valor no máximo 262.144 caracteres e cada armazenamento no máximo 1.048.576 caracteres por app e usuário. Uma gravação que ultrapasse um limite gera um `QuotaExceededError`, como na API do navegador.+### Trabalhando com vários registrosUse `useSelectedRecordIds()` para lidar com vários registros selecionados. Isso é útil para operações em lote:@@ -597,6 +634,43 @@ export default defineFrontComponent({Veja a [seção de recursos públicos](/l/pt/developers/extend/apps/config/public-assets) para obter detalhes.+## Compartilhar dependências pela frente de componentes++Por padrão, cada componente frontal junta sua própria cópia das bibliotecas que importa, então um aplicativo com cinco componentes é React cinco vezes. Declarar as dependências compartilhadas no `pacote` do seu aplicativo. son\` para construir essas bibliotecas uma vez e ter cada componente do aplicativo carregá-las de um único arquivo em cache:++```json package.json+{+ "frontComponentSharedDependencies": ["react", "react-dom/client", "twenty-ui/input"]+}+```++Cada componente então importa suas dependências exatamente como antes — nada muda no seu código do componente:++```tsx src/front-components/counter.tsx+import { useState } from 'react';+import { defineFrontComponent } from 'twenty-sdk/define';++const Counter = () => {+ const [count, setCount] = useState(0);++ return <button onClick={() => setCount(count + 1)}>{count}</button>;+};++export default defineFrontComponent({+ universalIdentifier: '...',+ name: 'counter',+ component: Counter,+});+```++Algumas coisas que você precisa saber:++* **Um pacote de dependências compartilhado por aplicativo.** O pacote é construído a partir das dependências do seu aplicativo, então você mantém controle total das versões que você enviou.+* **Liste os especificadores exatos que você importa.** `vinte e input` e `vinte e seis/display` são duas referências; um nome de pacote só por si não cobre seus subcaminhos. A listagem do `react` cobre automaticamente o `react/jsx-runtime`.+* **Compartilhe `react-dom/client` ao lado de `react`.** Cada componente renderiza através de `createRoot`, então deixar de fora significa que cada componente ainda empacota React DOM.+* \*\*O pacote é armazenado em cache. \* É servido sob uma URL de hash de conteúdo com um cache imutável de longa duração, portanto, ele é baixado uma vez e reutilizado em todos os componentes do aplicativo até que uma de suas dependências seja alterada.+* **Componentes que importam nenhum dos pacotes compartilhados nunca baixá-lo.**+## EstilizaçãoComponentes de front-end suportam várias abordagens de estilização. Você pode usar:@@ -696,3 +770,72 @@ const Card = () => {Como `useTheme()` é um hook, você lê os tokens dentro do corpo do componente, então os valores sempre refletem o tema em tempo real. O mesmo mapa de tokens também é exportado como a constante `themeCssVariables`, mas prefira `useTheme()` em componentes de front-end — uma constante em nível de módulo que desreferencia `themeCssVariables` pode ser indefinida enquanto o manifesto do app é extraído.Para diferenciar explicitamente com base no esquema ativo, leia-o com `useColorScheme()` de `twenty-sdk/front-component`, que retorna 'light' ou 'dark'.++## Limitações atuais++Componentes frontais estão em desenvolvimento ativo. Eventos de renderização, estilo e manipulação funcionam bem. Tudo que alcance *passado* renderização (medindo um elemento, chamando um método DOM em um ref, portátil fora de sua árvore, tocando no armazenamento do navegador) está ausente ou incompleto hoje, e a maioria falha silenciosamente: nenhuma exceção e nenhum erro no TypeScript, uma vez que o scaffold é digitado contra o navegador completo DOM.++Se um desses blocos, [abra um issue](https://github.com/twentyhq/twenty/issues/new/choose) para que seja priorizado.++### Layout e medição++Nada se pode medir por si mesmo.++| API | O que acontece |+| ------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |+| `getBoundingClientRect()`, `getClientRects()` | Lançamento |+| `offsetWidth`, `clientWidth`, `scrollWidth`, `offsetTop`, ... | Silenciosamente `indefinido`, então `largura ?? 0` renda `0` e `largura > 600` é sempre falso |+| `ResizeObserver`, `IntersectionObserver` | `ReferenceError` (`typeof` guardas fazem trabalho) |+| `window.matchMedia()`, `window.getComputedStyle()` | Lançamento |+| `window.innerWidth`, `innerHeight`, `devicePixelRatio` | Silenciosamente `undefined` |+| `new MutationObserver(fn)` | Construtora, então `.observe()` lançamentos |++Então, remapeia `ResponsiveContainer`, Interface flutuante / Popper, virtualização de lista e arrastar para redimensionar ainda não funcionam. Faça o layout no CSS: sua folha de estilos atinge a página real, então flexbox, grade, `aspect-ratio`, `clamp()` e `@container` todos se comportam normalmente.++<Note>+`requestAnimationFrame`, `fetch`, `setTimeout` and `queueMicrotask` trabalham sem o prefixo `window.`. Apenas `window.requestAnimationFrame(...)` e amigos lançam.+</Note>++### DOM access++Um `ref` fornece um elemento da sandbox, não um `HTMLElement`.++| O que você escreve | O que acontece | Usar em vez disso |+| ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |+| `ref.current.focus()`, `.click()`, `.select()`, `.setSelectionRange()`, `.scrollIntoView()`, `video.play()` | Lançamento | Componentes controlados; leia valores de `event.target` |+| `element.classList.add(...)` | Lança (`classList` é `undefined`) | Construa a string `className` |+| `document.getElementById()`, `getElementsByClassName()`, `createTreeWalker()` | Lançamento | `querySelector()` / `querySelectorAll()`, que funcionam |+| `document.activeElement` | Sempre `indefinido` | Rastreie o foco com `onFocus` / `onBlur` |+| `canvas` | Não renderiza nada, sem erro | SVG ou desenhar fora da tela e mostrar o resultado em um elemento `img` |+| `createPortal(node, document.body)` | Não renderiza nada, enquanto `isConnected` reporta sucesso | Sobrepõe em linha com `posição: absoluto`, ou passa a biblioteca seu próprio elemento de contêiner |++A lacuna do portal é o motivo da Radix, da interface do usuário, MUI e da interface de reacção, que não tornam nada por padrão. A maioria aceita uma propriedade de container; aponta-a para um elemento que você renderizou.++### Eventos++Mouse, pointer, touch, drag, teclado, foco, `input`/`change`/`submit`, `scroll`/`wheel`/`contextmenu` e `animationend`/`transitionend` são encaminhados ao host, além de alguns específicos por elemento: `load`/`error` em `img`, área de transferência e composição em `input`/`textarea`, mídia em `video`/`audio`, `toggle` em `details`/`dialog`. Qualquer outra coisa (`onAuxClick`, `onSelect`, `onInvalid`, `onReset`, `onAnimationStart`, captura de ponteiro, `onLoad` fora de `img`) é descartada sem aviso.++`document.addEventListener()` e `janela. ddEventListener()` registra-se sem erro e nunca dispara, é por isso que um arrastar para o mesmo assim que o ponteiro deixa o elemento no qual ele iniciou. `event.preventDefault()` também não atravessa; formulário de envio, `dragover`/`drop` e cliques de links já estão guardados para você.++### Atributos e estilos++Cada elemento encaminha suas próprias propriedades para o DOM host (`href` em `a`, `src`/`alt` em `img`, `value`/`placeholder`/`disabled` em `input` e assim por diante), além de um conjunto comum em todos os elementos: `id`, `className`, `style`, `title`, `tabIndex`, `role`, `draggable` e qualquer atributo `aria-*` / `data-*` (com hífen, portanto `ariaLabel` é descartado). Qualquer coisa fora que seja silenciosamente descartada, então expressa estado personalizado como `data-*`.++O CSS do componente, seja de `import './styles.css'`, CSS-in-JS ou um elemento `style`, é injetado no `head` da página host **sem escopo**. Então os nomes das classes colidem com os próprios do Twenty (prefixe-os, e nunca escrevem bare `div { ... }` seletores) e `@media` coincidem com a janela do navegador ao invés do seu widget (use `@container` com seu próprio `container-type`). Propriedades `style` embutidas não são afetadas.++### Armazenamento e rede++`localStorage` e `sessionStorage` são fornecidos pela Twenty em vez do navegador: o componente é executado em um worker em uma origem opaca, portanto o host armazena os valores em nome do seu app. Veja [armazenamento](#storage) para saber mais sobre seu escopo e limites. IndexedDB, cookies, a Cache API e `BroadcastChannel` continuam indisponíveis. Para manter o estado entre dispositivos, chame uma [função de lógica](/l/pt/developers/extend/apps/logic/logic-functions) e use seu [armazenamento de chave-valor](/l/pt/developers/extend/apps/logic/key-value-store).++`fetch` funciona, com advertências:++* Chamadas para a API de Vinte e as rotas do seu aplicativo são procuradas pelo host, então prefira [`RestApiClient`](#calling-the-twenty-rest-api). Em chamadas de proxied, `AbortSignal` e as outras opções `RequestInit` são descartadas, e apenas os corpos `string` e `URLSearchParams` são suportados.+* Outras origens deixam o sandbox com `Origin: null`, então uma API de terceiros responde apenas se envia `Access-Control-Allow-Origin: *`. Chame-a de uma função lógica.+* `fetch('/rest/people')` nunca corresponde a 20 API, porque o sandbox não tem URL de página para resolver um caminho relativo contra.++### Outras lacunas++* **Conteúdo de arquivo.** Um `input` do tipo `file` fornece ao seu manipulador apenas os metadados do arquivo, não os bytes, portanto `FileReader` e uploads ainda não são possíveis.+* **Arrastar e soltar payloads.** Arraste eventos disparados, mas `event.dataTransfer` é `undefined`.+* **Node embutidos.** `fs`, `path` and `node:crypto` falham na compilação, então mova o nó para uma [função lógica](/l/pt/developers/extend/apps/logic/logic-functions). Criptografia Web, `fetch`, `TextEncoder` e `URL` estão disponíveis.+* **`iframe`** é sempre colocado novamente em sandbox sem `allow-same-origin`, portanto uma incorporação que dependa da própria sessão será renderizada como desconectada. Isso também não tem `onLoad`.diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/layout/navigation-menu-items.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/layout/navigation-menu-items.mdxindex 6a5c77cd689..6af8a9c3935 100644--- a/packages/twenty-docs/l/pt/developers/extend/apps/layout/navigation-menu-items.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/apps/layout/navigation-menu-items.mdx@@ -42,5 +42,5 @@ export default defineNavigationMenuItem({* `folderUniversalIdentifier` também está disponível em qualquer item para aninhá-lo dentro de um pai do tipo `FOLDER`.<Note>-**Armadilha comum:** criar um objeto sem uma visualização associada + item do menu de navegação torna esse objeto invisível para os usuários. A menos que seja um objeto técnico/interno, todo objeto personalizado deve ter uma visualização padrão *e* uma entrada na barra lateral apontando para ela.+**Armadilha comum:** criar um objeto sem um item de menu de navegação associado torna esse objeto inacessível a partir da barra lateral. A menos que seja um objeto técnico/interno, todo objeto personalizado deve ter uma entrada na barra lateral apontando para ele.</Note>diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/layout/overview.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/layout/overview.mdxindex e306d9063d7..0f4cd8acd83 100644--- a/packages/twenty-docs/l/pt/developers/extend/apps/layout/overview.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/apps/layout/overview.mdx@@ -55,3 +55,5 @@ A **camada de layout** de um app do Twenty é tudo o que o usuário vê: onde o| **Menu de comandos (Cmd+K)** | Uma ação rápida fixada ou comando oculto | `defineCommandMenuItem` |Os componentes de front-end são executados dentro de um Web Worker isolado usando Remote DOM — eles são renderizados *nativamente* na página (não dentro de um iframe), mas não podem acessar diretamente a página host ou o DOM. A comunicação com o Twenty acontece por meio de uma API de host com passagem de mensagens.++Eles ainda estão em desenvolvimento ativo: o sandbox implementa um DOM parcial, portanto usos avançados podem falhar. Veja as [limitações atuais](/l/pt/developers/extend/apps/layout/front-components#current-limitations).diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/layout/page-layouts.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/layout/page-layouts.mdxindex f136fdb0011..ba6014c3ada 100644--- a/packages/twenty-docs/l/pt/developers/extend/apps/layout/page-layouts.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/apps/layout/page-layouts.mdx@@ -53,10 +53,33 @@ export default definePageLayout({* `type` é um dos seguintes: `'RECORD_INDEX'`, `'RECORD_PAGE'`, `'DASHBOARD'` ou `'STANDALONE_PAGE'`. Use `'RECORD_PAGE'` para personalizar a visualização de detalhes de um objeto específico.* `objectUniversalIdentifier` especifica a qual objeto este layout se aplica.-* Cada `tab` define uma seção da página com um `title`, `position` e `layoutMode` (`VERTICAL_LIST` para páginas de registro, `GRID` para dashboards). Uma aba contendo um único widget o renderiza automaticamente em largura total; com vários widgets, eles são empilhados como cards.+* Cada `tab` define uma seção da página com um `title`, `position` e `layoutMode`: `VERTICAL_LIST` para páginas de registro e páginas independentes, `GRID` para dashboards. Em uma aba `VERTICAL_LIST`, um único widget é renderizado em largura total e ocupa toda a aba; com vários widgets, eles são empilhados como cards. Uma aba `GRID` sempre distribui seus widgets como cards em uma grade de 12 colunas, independentemente da quantidade, portanto escolha `VERTICAL_LIST` quando quiser que um único widget preencha a página.+* Defina `layoutMode` explicitamente. Omití-lo faz com que você obtenha `VERTICAL_LIST` em uma `STANDALONE_PAGE` e `GRID` em todos os outros casos, o que raramente é o que você deseja em uma página de registro.* Cada `widget` dentro de uma aba pode renderizar um [front component](/l/pt/developers/extend/apps/layout/front-components), uma lista de relações ou outros tipos de widget nativos.* `position` nas abas controla sua ordem. Use valores mais altos (por exemplo, 50) para colocar abas personalizadas após as nativas.+### Widgets de campos++Um widget `FIELD` renderiza um campo do registro. Para campos de relação, ele também pode incorporar uma lista de registros relacionados:++```ts+{+ universalIdentifier: 'c1c2c3c4-c5c6-4000-8000-000000000003',+ title: 'People → Opportunities',+ type: 'FIELD',+ configuration: {+ configurationType: 'FIELD',+ fieldMetadataId: PEOPLE_FIELD_UNIVERSAL_IDENTIFIER,+ fieldDisplayMode: 'TABLE',+ nestedRelationFieldMetadataId: OPPORTUNITIES_FIELD_UNIVERSAL_IDENTIFIER,+ },+}+```++* `fieldMetadataId` recebe o identificador universal de um campo no objeto do layout.+* `fieldDisplayMode` é um dentre `'FIELD'`, `'CARD'`, `'EDITOR'`, `'VIEW'` ou `'TABLE'`. `TABLE` incorpora uma visualização que lista os registros de um campo de relação um-para-muitos.+* `nestedRelationFieldMetadataId` é opcional e recebe o identificador universal de um campo de relação um-para-muitos no objeto de destino da relação, para listar registros a dois saltos de relação (por exemplo, uma página de Empresa listando as oportunidades das pessoas da empresa, ou uma página de Pessoa listando as oportunidades da empresa da pessoa). O primeiro salto pode ser um campo de relação um-para-muitos ou muitos-para-um, o segundo deve ser um-para-muitos (relações de junção não são compatíveis) e isso requer `fieldDisplayMode: 'TABLE'` — combiná-lo com qualquer outro modo de exibição é um erro de validação, já que um widget aninhado sempre é renderizado como uma visualização incorporada.+## definePageLayoutTabUse isto quando você quiser apenas **adicionar** uma aba a um layout existente — por exemplo, uma aba de analytics na página padrão de Company ou uma aba de resumo de IA anexada ao layout do seu próprio objeto.diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/layout/views.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/layout/views.mdxindex 9711341b86f..df8484d2423 100644--- a/packages/twenty-docs/l/pt/developers/extend/apps/layout/views.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/apps/layout/views.mdx@@ -41,16 +41,16 @@ export default defineView({## Propriedades opcionais-| Propriedade | Valores | Descrição |-| ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |-| `type` | `ViewType.TABLE` (padrão), `ViewType.KANBAN`, `ViewType.CALENDAR` | Como os registros são dispostos. (`FIELDS_WIDGET`, `TABLE_WIDGET`, `KANBAN_WIDGET` e `CALENDAR_WIDGET` também existem, mas são usados internamente por widgets de layout de página.) |-| `visibility` | `ViewVisibility.WORKSPACE` (padrão), `ViewVisibility.UNLISTED` | Se a visualização é listada em todo o espaço de trabalho ou oculta nos seletores. |-| `openRecordIn` | `ViewOpenRecordIn.SIDE_PANEL` (padrão), `ViewOpenRecordIn.RECORD_PAGE` | Onde clicar em um registro o abre. |-| `ordenações` | `{ fieldMetadataUniversalIdentifier, direction: ViewSortDirection.ASC \| DESC }[]` | Ordem de classificação padrão. |-| `isCompact` | `boolean` | Exibição compacta de linhas. |-| `mainGroupByFieldMetadataUniversalIdentifier` + `shouldHideEmptyGroups` | — | Agrupar registros (por exemplo, colunas kanban) por um campo. |-| `kanbanAggregateOperation`, `kanbanAggregateOperationFieldMetadataUniversalIdentifier`, `kanbanColumnWidth` | `AggregateOperations.*` | Agregações e dimensionamento de colunas kanban. |-| `calendarLayout`, `calendarFieldMetadataUniversalIdentifier`, `calendarEndFieldMetadataUniversalIdentifier` | `ViewCalendarLayout.DAY` / `WEEK` / `MONTH` | Visualizações de calendário: layout, o campo de data que posiciona os registros e um campo de data final opcional. |+| Propriedade | Valores | Descrição |+| ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |+| `type` | `ViewType.TABLE` (padrão), `ViewType.LIST`, `ViewType.KANBAN`, `ViewType.CALENDAR` | Como os registros são dispostos. (`FIELDS_WIDGET`, `TABLE_WIDGET`, `KANBAN_WIDGET`, `LIST_WIDGET` e `CALENDAR_WIDGET` também existem, mas são usados internamente por widgets de layout de página.) |+| `visibility` | `ViewVisibility.WORKSPACE` (padrão), `ViewVisibility.UNLISTED` | Se a visualização é listada em todo o espaço de trabalho ou oculta nos seletores. |+| `openRecordIn` | obsoleto | Não é mais lido: o local onde os registros são abertos agora é uma propriedade do [objeto](/l/pt/developers/extend/apps/data/objects) (`openRecordIn` em `defineObject()`), recorrendo à preferência de cada membro. |+| `ordenações` | `{ fieldMetadataUniversalIdentifier, direction: ViewSortDirection.ASC \| DESC }[]` | Ordem de classificação padrão. |+| `isCompact` | `boolean` | Exibição compacta de linhas. |+| `mainGroupByFieldMetadataUniversalIdentifier` + `shouldHideEmptyGroups` | — | Agrupar registros (por exemplo, colunas kanban) por um campo. |+| `kanbanAggregateOperation`, `kanbanAggregateOperationFieldMetadataUniversalIdentifier`, `kanbanColumnWidth` | `AggregateOperations.*` | Agregações e dimensionamento de colunas kanban. |+| `calendarLayout`, `calendarFieldMetadataUniversalIdentifier`, `calendarEndFieldMetadataUniversalIdentifier` | `ViewCalendarLayout.DAY` / `WEEK` / `MONTH` | Visualizações de calendário: layout, o campo de data que posiciona os registros e um campo de data final opcional. |Todos os enums acima são exportados de `twenty-sdk/define`.@@ -110,4 +110,4 @@ O campo `value` é sempre um valor serializável em JSON, mas o seu formato espe## Como as visualizações aparecem na UI-Uma visualização por si só não é acessível a partir da barra lateral. Para fazê-la aparecer lá, associe-a a um [item de menu de navegação](/l/pt/developers/extend/apps/layout/navigation-menu-items) do tipo `VIEW` que aponte para o `universalIdentifier` da visualização. Esse é o padrão canônico: cada objeto personalizado normalmente inclui uma visualização padrão + uma entrada na barra lateral que a abre.+Uma visualização por si só não é acessível a partir da barra lateral. Para fazê-la aparecer lá, associe-a a um [item de menu de navegação](/l/pt/developers/extend/apps/layout/navigation-menu-items) do tipo `VIEW` que aponte para o `universalIdentifier` da visualização. Esse é o padrão canônico: todo objeto personalizado recebe uma exibição de índice padrão gerada automaticamente no momento da criação, então você só precisa incluir o item da barra lateral que a abre.diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/logic/background-jobs.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/logic/background-jobs.mdxnew file mode 100644index 00000000000..16828826afa--- /dev/null+++ b/packages/twenty-docs/l/pt/developers/extend/apps/logic/background-jobs.mdx@@ -0,0 +1,165 @@+---+title: Tarefas em segundo plano+description: Entregue trabalhos longos ou com limitação de taxa aos workers do Twenty colocando na fila outra execução de função de lógica, em vez de fazer tudo inline.+icon: layer-group+---++Uma execução de função de lógica é limitada pelo seu `timeoutSeconds` (máximo de 900 segundos). Qualquer coisa que não consiga terminar nesse intervalo — uma re-sincronização completa, uma distribuição por registro, uma API de terceiros que impõe limitações de taxa — precisa ser dividida em execuções menores.++`enqueueJob` faz exatamente isso: solicita aos workers do Twenty que executem mais tarde uma das funções de lógica do seu aplicativo, em seu próprio processo, com seu próprio tempo limite. O chamador retorna imediatamente.++```text+ ┌─────────────────┐ enqueueJob(...) ┌──────────────┐ ┌────────────────────┐+ │ Logic function │ ─────────────────▶ │ Job queue │──▶│ Logic function │+ │ (returns now) │ │ (workers) │ │ (fresh run/timeout)│+ └─────────────────┘ └──────────────┘ └────────────────────┘+```++## Colocar uma execução na fila++Importe `enqueueJob` de `twenty-sdk/logic-function` e aponte-o para o `universalIdentifier` da função de lógica que você quer executar.++```ts src/logic-functions/sync-all-contacts.ts+import { enqueueJob } from 'twenty-sdk/logic-function';++await enqueueJob({+ logicFunctionUniversalIdentifier: '9f1c3d7e-51b8-4a29-8f0d-7c4e2a6b1d33',+ payload: { page: 1 },+});+```++A função de destino recebe `payload` como argumento do handler, exatamente como qualquer outro gatilho. Ela deve pertencer à **mesma aplicação** que quem a chama — colocar na fila a função de outra aplicação é rejeitado com `Logic function not found`.++<Note>+`enqueueJob` retorna assim que o job é aceito, não quando ele é executado. Ele não retorna o resultado do destino — faça o destino gravar o que produzir no [repositório de chave-valor](/l/pt/developers/extend/apps/logic/key-value-store) ou em um registro do workspace se você precisar ler isso de volta.+</Note>++## Opções do job++| Opção | Padrão | Intervalo | O que faz |+| ------------ | ------ | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |+| `retryLimit` | `0` | `0`–`10` | Tentativas extras se a execução lançar uma exceção. Só aumente isso para handlers que sejam seguros para serem executados duas vezes. |+| `delayMs` | `0` | `0`–`604800000` (7 dias) | Espere esse tempo antes de a execução se tornar elegível. |++```ts+await enqueueJob({+ logicFunctionUniversalIdentifier: '9f1c3d7e-51b8-4a29-8f0d-7c4e2a6b1d33',+ payload: { page: 1 },+ retryLimit: 3,+ delayMs: 60_000,+});+```++<Note>+**A prioridade ainda não é configurável.** Jobs em fila sempre são executados na prioridade mais baixa, então o trabalho da plataforma nunca é atrasado por jobs da aplicação. O controle sobre prioridade estará disponível em breve.+</Note>++A execução em fila herda o usuário ativo da função que a colocou na fila, portanto age com as mesmas permissões.++## Use assim: pagine uma sincronização longa++O formato clássico é uma função que coloca *a si mesma* na fila com o próximo cursor. Cada execução faz uma página de trabalho bem dentro do seu próprio tempo limite, e a cadeia para quando não resta nada.++```ts src/logic-functions/sync-contacts-page.ts+import { defineLogicFunction } from 'twenty-sdk/define';+import { enqueueJob } from 'twenty-sdk/logic-function';++const SYNC_CONTACTS_PAGE = '9f1c3d7e-51b8-4a29-8f0d-7c4e2a6b1d33';++const handler = async (params: { cursor?: string }) => {+ const { contacts, nextCursor } = await fetchContactsPage(params.cursor);++ await importContacts(contacts);++ if (nextCursor) {+ await enqueueJob({+ logicFunctionUniversalIdentifier: SYNC_CONTACTS_PAGE,+ payload: { cursor: nextCursor },+ delayMs: 2_000,+ });+ }++ return { imported: contacts.length, done: !nextCursor };+};++export default defineLogicFunction({+ universalIdentifier: SYNC_CONTACTS_PAGE,+ name: 'sync-contacts-page',+ timeoutSeconds: 120,+ handler,+});+```++## Ramificar por registro++Quando o trabalho é naturalmente por item, coloque um job por item na fila e deixe os workers processarem em paralelo em vez de fazer o loop inline.++```ts+const companies = await listCompaniesToEnrich();++await Promise.all(+ companies.map((company) =>+ enqueueJob({+ logicFunctionUniversalIdentifier: ENRICH_COMPANY,+ payload: { companyId: company.id },+ retryLimit: 2,+ }),+ ),+);+```++## Boas práticas para trabalho de longa duração++Duas regras cobrem quase todo job longo: **faça recursão em vez de loop** e **processe um fragmento limitado por execução**.++Uma execução que tenta fazer tudo é o modo de falha — ela atinge o tempo limite e, com uma nova tentativa, começa tudo de novo do zero. Em vez disso, defina o tamanho de um fragmento para que ele termine confortavelmente dentro de `timeoutSeconds`, persista sua posição e coloque a próxima execução na fila.++```ts src/logic-functions/enrich-companies-batch.ts+import { defineLogicFunction } from 'twenty-sdk/define';+import { enqueueJob, kv } from 'twenty-sdk/logic-function';++const ENRICH_COMPANIES_BATCH = '3f9d1c02-8a44-4f0e-b1d7-9c2e5a7b4f10';+const CHUNK_SIZE = 50;++const handler = async (params: { offset?: number }) => {+ const offset = params.offset ?? 0;+ const companies = await listCompaniesToEnrich({+ offset,+ limit: CHUNK_SIZE,+ });++ for (const company of companies) {+ await enrichCompany(company);+ }++ await kv.set('enrich:progress', { offset: offset + companies.length });++ if (companies.length === CHUNK_SIZE) {+ await enqueueJob({+ logicFunctionUniversalIdentifier: ENRICH_COMPANIES_BATCH,+ payload: { offset: offset + CHUNK_SIZE },+ });+ }++ return { processed: companies.length, done: companies.length < CHUNK_SIZE };+};++export default defineLogicFunction({+ universalIdentifier: ENRICH_COMPANIES_BATCH,+ name: 'enrich-companies-batch',+ timeoutSeconds: 300,+ handler,+});+```++O que torna isso robusto:++* **Defina o tamanho do fragmento a partir do item mais lento, não da média.** `CHUNK_SIZE × tempo do item em pior caso` precisa caber em `timeoutSeconds` com alguma folga, ou o final de um fragmento é perdido quando a execução é interrompida.+* **Deixe a condição de parada explícita.** Faça recursão apenas enquanto um fragmento completo for retornado. Uma cadeia que para apenas em "sem resultados" continuará para sempre se a origem algum dia retornar uma página curta no meio do caminho.+* **Persista o progresso antes de colocar a próxima execução na fila,** assim um elo com falha reinicia a partir do último fragmento concluído em vez do começo.+* **Mantenha cada fragmento idempotente.** Reprocessar um fragmento após uma nova tentativa não deve gerar escrita em dobro — faça as gravações com base no registro ou id externo que você está processando.+* **Prefira uma cadeia fragmentada em vez de uma grande ramificação** quando o trabalho aciona um serviço de terceiros com limitação de taxa: uma cadeia com `delayMs` se regula sozinha, enquanto milhares de jobs colocados na fila de uma vez se tornam elegíveis imediatamente.++<Warning>+Novas tentativas executam novamente o handler inteiro. Mantenha os handlers em fila idempotentes antes de definir `retryLimit` acima de `0`.+</Warning>diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/logic/connections.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/logic/connections.mdxindex 38711491bcf..941809ceeef 100644--- a/packages/twenty-docs/l/pt/developers/extend/apps/logic/connections.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/apps/logic/connections.mdx@@ -45,6 +45,9 @@ export default defineConnectionProvider({// Optional: a logic function in this app to run right after a connection is// established. See "Run a logic function on connect".// onConnectLogicFunction: { universalIdentifier: '3a2b1c0d-...-...' },+ // Optional: a logic function in this app to run right after a connection is+ // removed. See "Run a logic function on disconnect".+ // onDisconnectLogicFunction: { universalIdentifier: '4d5e6f70-...-...' },});```@@ -124,6 +127,42 @@ A partir daí, use `getConnection(connectedAccountId)` para ler o token de acess</Accordion>+<Accordion title="Execute uma função lógica ao desconectar" description="Limpar quando uma conexão for removida">++Tudo o que um app reivindica no momento da conexão precisa ser liberado quando a conexão é encerrada. Uma integração do Slack que reivindica um `team_id` ao conectar, por exemplo, precisa liberar essa reivindicação para que outro espaço de trabalho possa conectar a mesma equipe do Slack. Defina `onDisconnectLogicFunction` para fazer referência a uma função lógica no mesmo app, e ela será executada logo após o `ConnectedAccount` ser excluído.++```ts src/connection-providers/slack-connection.ts+export default defineConnectionProvider({+ universalIdentifier: '...',+ name: 'slack',+ displayName: 'Slack',+ type: 'oauth',+ oauth: {+ /* ... */+ },+ // Runs releaseSlackTeam after every Slack disconnection.+ onDisconnectLogicFunction: {+ universalIdentifier: '4470aba8-5ff5-4800-88db-2a427cd8677c',+ },+});+```++Assim como o hook de on-connect, ele é executado **assincronamente no espaço de trabalho que está sendo desconectado** e nunca bloqueia a desconexão. O handler recebe o mesmo formato de payload:++```ts+type OnDisconnectPayload = {+ connectionProviderId: string;+ connectionProviderName: string; // e.g. 'slack'+ connectedAccountId: string;+};+```++O `ConnectedAccount` já não existe mais quando o hook é executado, então `getConnection(connectedAccountId)` não retorna mais resultado. Tudo o que a limpeza precisar (um `team_id`, um id de assinatura externa) deve ter sido gravado no [key-value store](/l/pt/developers/extend/apps/logic/key-value-store) no momento da conexão, indexado por `connectedAccountId`.++O hook é disparado quando uma conexão é removida por conta própria. A desinstalação do app remove suas conexões por meio de uma cascata de banco de dados; portanto, o hook não é executado nesse caso. Declare um `uninstallLogicFunction` em `defineApplication` para esse caminho: ele é executado antes de os metadados do app serem excluídos, então ainda pode chamar `listConnections` e limpar o que tiver restado.++</Accordion>+<Accordion title="listConnections / getConnection" description="Use conexões a partir de uma função de lógica">Dentro de um handler de função de lógica, `listConnections({ providerName })` retorna as linhas `ConnectedAccount` deste app para o provedor fornecido, com tokens de acesso atualizados.diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/logic/logic-functions.mdxindex 319d35d0394..101e7cf6432 100644--- a/packages/twenty-docs/l/pt/developers/extend/apps/logic/logic-functions.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/apps/logic/logic-functions.mdx@@ -171,6 +171,10 @@ Por motivos de segurança, os cabeçalhos de resposta são restringidos a uma liO código de status deve ser um código de status HTTP válido (entre 100 e 599). Os nomes dos cabeçalhos de resposta são comparados sem distinção entre maiúsculas e minúsculas.</Note>+#### Respostas de erro da plataforma++Além das próprias respostas do seu handler, a plataforma responde diretamente às chamadas de rota em algumas situações: `404` quando a rota ou função não existe, `403` quando a aplicação está parada, `429` quando o limite de taxa de execução é atingido e `422` quando as `dependencies` de produção da aplicação são grandes demais para serem instaladas — consulte [limites de tamanho de dependencies](/l/pt/developers/extend/apps/getting-started/project-structure#dependencies).+#### Gatilho de rota de servidor`httpRouteTriggerSettings` expõe uma função em `/s/` e resolve o workspace a partir do host da solicitação — o que funciona quando cada workspace tem seu próprio domínio. Provedores de terceiros, entretanto, entregam os eventos de todos os workspaces para **uma** URL. Para esse caso, use `serverRouteTriggerSettings`.diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/logic/overview.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/logic/overview.mdxindex 073219dc4aa..bb734b4cf95 100644--- a/packages/twenty-docs/l/pt/developers/extend/apps/logic/overview.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/apps/logic/overview.mdx@@ -37,6 +37,9 @@ A **camada de lógica** de um app do Twenty é o código que *é executado* —<Card title="Armazenamento de chave-valor" icon="database" href="/l/pt/developers/extend/apps/logic/key-value-store">Persistir o estado entre execuções de funções de lógica — caches, cursores e declarações entre espaços de trabalho.</Card>+ <Card title="Tarefas em segundo plano" icon="layer-group" href="/l/pt/developers/extend/apps/logic/background-jobs">+ Adicione à fila a execução de uma função de lógica nos workers para contornar o limite de tempo de cada execução.+ </Card></CardGroup>## Tipos de gatilho em resumodiff --git a/packages/twenty-docs/l/pt/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/logic/skills-and-agents.mdxindex 14e6783d91e..e89febaea64 100644--- a/packages/twenty-docs/l/pt/developers/extend/apps/logic/skills-and-agents.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/apps/logic/skills-and-agents.mdx@@ -100,7 +100,7 @@ Observações sobre o esquema:</Accordion><Accordion title="runAgent" description="Executar um agente a partir de uma função de lógica">-`runAgent()` permite que uma função de lógica execute um dos agentes do seu app (com suas habilidades e ferramentas). Identifique o agente pelo `universalIdentifier` que você passou para `defineAgent()`:+`runAgent()` permite que uma função de lógica execute um dos agentes do seu app (com suas habilidades e ferramentas). Identifique o agente pelo `universalIdentifier` que você passou para `defineAgent()`. Passe uma string `prompt` ou um histórico de conversas como `messages` — não ambos:```ts src/logic-functions/run-enricher.tsimport { runAgent } from 'twenty-sdk/logic-function';@@ -111,7 +111,24 @@ const { result, error, success } = await runAgent({});```+Para bots de múltiplas interações (Slack, Discord, Teams, …), passe o histórico do tópico como `messages` em vez de um único `prompt`:++```ts src/logic-functions/reply-in-thread.ts+import { runAgent } from 'twenty-sdk/logic-function';++const { result, error, success } = await runAgent({+ agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123',+ messages: [+ { role: 'user', content: 'Who owns Acme?' },+ { role: 'assistant', content: 'Sarah owns the Acme account.' },+ { role: 'user', content: 'What was the last touchpoint?' },+ ],+});+```+Pontos-chave:+* Forneça **exatamente um** de `prompt` (string) ou `messages` (de 1 a 100 entradas+ de `{ role: 'user' | 'assistant', content: string }`).* O agente é executado sincronamente e pode ler/atualizar registros por conta própria por meio de suas próprias ferramentas — `runAgent()` é resolvido quando a execução é concluída.* Um app só pode executar os seus próprios agentes.* O [papel padrão](/l/pt/developers/extend/apps/config/roles) do app deve conceder o sinalizador de permissão `AI` — adicione `SystemPermissionFlag.AI` ao seu `permissionFlagUniversalIdentifiers` (ou defina `canAccessAllTools: true`).@@ -134,5 +151,43 @@ export default defineApplicationRole({**Evite loops:** se você chamar `runAgent()` a partir de um gatilho de evento de banco de dados `*.updated` e o agente atualizar o mesmo registro, delimite o gatilho com `updatedFields` para um campo que o agente nunca escreve (por exemplo, a URL de origem) ou verifique se algum campo de destino ainda está vazio antes de chamar `runAgent()`.</Warning>+### Executando em nome de um membro do workspace++Passe `runAsWorkspaceMemberId` quando a execução for acionada por uma pessoa — por exemplo, um chatbot respondendo a uma mensagem — para que o agente atue como esse membro em vez de como o app:++```ts src/logic-functions/answer-question.ts+const { result } = await runAgent({+ agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123',+ prompt: 'How many open opportunities do we have?',+ runAsWorkspaceMemberId: '20202020-0687-4c41-b707-ed1bfca972a7',+});+```++A execução então atua com a **própria função do membro**: ela pode fazer tudo o que esse+membro pode fazer e nada além disso, os registros que cria são atribuídos a ele, e+as permissões em nível de linha dele se aplicam. A função do agente não participa — ela+é o padrão do aplicativo para execuções sem ninguém por trás delas. Omita o campo para+execuções autônomas (jobs agendados, gatilhos de eventos de banco de dados): essas mantêm a+própria função do agente. O aplicativo atuante permanece vinculado ao contexto da execução+para rastreabilidade, sem restringir as permissões do membro.++Seu app é responsável por mapear a pessoa que acionou a execução para um membro do workspace. Nomear um requer um token de acesso do app, e o que um token pode+nomear depende de o token estar associado a um usuário ou não:++* Um token **sem nenhum usuário associado** pode nomear qualquer membro. Uma função lógica é executada+ com um, assim como tokens criados por meio de `client_credentials` ou a partir de uma API+ key.+* Um token emitido **em nome de um usuário**, como um front component recebe, só pode+ nomear o próprio membro desse usuário.++Qualquer outra coisa — uma sessão simples de usuário, uma API key sem um app token — não pode+nomear nenhum membro.++<Warning>+ `runAgent()` gera uma exceção quando o membro do workspace não pode ser resolvido — um+ membro desconhecido ou removido, ou um sem função. Ele nunca recorre à+ própria função do agente, pois isso concederia mais acesso do que o requisitante pediu.+</Warning>+</Accordion></AccordionGroup>diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/operations/publishing.mdxindex f8e6610f8a9..74ee7d5d17b 100644--- a/packages/twenty-docs/l/pt/developers/extend/apps/operations/publishing.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/apps/operations/publishing.mdx@@ -49,11 +49,7 @@ yarn twenty app:publish --private### Compartilhando um aplicativo implantado-<Warning>-Compartilhar aplicativos privados (tarball) entre espaços de trabalho é um recurso do plano **Enterprise**. A guia **Distribuição** exibirá um aviso de atualização em vez dos controles de compartilhamento até que seu espaço de trabalho tenha uma chave Enterprise válida. Vá para [Configurações > Painel de Administração > Enterprise](/settings/admin-panel#enterprise) para ativá-lo.-</Warning>--Aplicativos em tarball não são listados no marketplace público, então outros espaços de trabalho no mesmo servidor não os descobrirão ao navegar. Assim que o seu espaço de trabalho estiver no plano Enterprise, você pode compartilhar um app implantado desta forma:+Aplicativos em tarball não são listados no marketplace público, então outros espaços de trabalho no mesmo servidor não os descobrirão ao navegar. Para compartilhar um aplicativo implantado:1. Vá para **Configurações > Aplicações > Registros** e abra seu aplicativo2. Na guia **Distribuição**, clique em **Copiar link de compartilhamento**diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/operations/sync-and-recovery.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/operations/sync-and-recovery.mdxindex 134f246dac0..b8c4e7a60cf 100644--- a/packages/twenty-docs/l/pt/developers/extend/apps/operations/sync-and-recovery.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/apps/operations/sync-and-recovery.mdx@@ -121,5 +121,6 @@ Quando algo dá errado, o diff de metadados e os erros nomeados permitem localiz* **Erro de build do manifesto** — a CLI falha antes de sincronizar (`MANIFEST_BUILD_FAILED`, `TYPECHECK_FAILED`); corrija o código-fonte do seu app.* **Erro de sincronização / migração** — o build é bem-sucedido, mas aplicar o diff falha, nomeando a entidade e o `universalIdentifier`; corrija os metadados em conflito.+* **Erro no tamanho das dependências** — a sincronização ou instalação falha porque as `dependencies` de produção do app são grandes demais para serem instaladas como uma camada de runtime (`LOGIC_FUNCTION_DEPENDENCIES_SIZE_EXCEEDED`); mova para `devDependencies` os pacotes que suas funções de lógica não importam em tempo de execução (bibliotecas de UI, ferramentas de desenvolvimento).* **Erro de tempo de execução no código do app** — a sincronização é concluída com êxito, mas suas funções de lógica ou componentes se comportam de forma incorreta em tempo de execução; verifique os [logs de função](/l/pt/developers/extend/apps/operations/cli).* **Estado da instância local** — nenhuma das opções acima e o espaço de trabalho ainda parece incorreto; prossiga descendo na escada de recuperação.diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/operations/testing.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/operations/testing.mdxindex 6d388c0714a..5f2ec0414df 100644--- a/packages/twenty-docs/l/pt/developers/extend/apps/operations/testing.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/apps/operations/testing.mdx@@ -8,7 +8,7 @@ O SDK fornece APIs programáticas que permitem compilar, implantar, instalar e d## Usando pacotes npm-Você pode instalar e usar qualquer pacote npm no seu app. Tanto funções lógicas quanto componentes de front-end são empacotados com [esbuild](https://esbuild.github.io/), que incorpora todas as dependências na saída — nenhum `node_modules` é necessário em tempo de execução.+Você pode instalar e usar qualquer pacote npm no seu app. Tanto funções lógicas quanto componentes de front-end são empacotados com [esbuild](https://esbuild.github.io/), que incorpora suas dependências na saída — nenhum `node_modules` é necessário em tempo de execução.### Instalando um pacote@@ -56,14 +56,16 @@ export default defineFrontComponent({### Como o empacotamento funciona-A etapa de build usa o esbuild para produzir um único arquivo independente por função lógica e por componente de front-end. Todos os pacotes importados são incorporados ao bundle.+A etapa de build usa o esbuild para produzir um único arquivo independente por função lógica e por componente de front-end. Pacotes importados são incorporados ao bundle, exceto aqueles listados abaixo.**Funções lógicas** são executadas em um ambiente Node.js. Módulos nativos do Node (`fs`, `path`, `crypto`, `http`, etc.) estão disponíveis e não precisam ser instalados.-**Componentes de front-end** são executados em um Web Worker. Módulos nativos do Node **não** estão disponíveis — apenas APIs do navegador e pacotes npm que funcionam em um ambiente de navegador.+**Componentes de front-end** são executados em um Web Worker. Módulos internos do nó **não** estão disponíveis — apenas pacotes npm que funcionam em um ambiente de navegador. Note que a sandbox implementa um *parcial* DOM, para que um pacote possa ser construído de forma limpa e ainda falhar no tempo de execução; veja [Limitação atual](/l/pt/developers/extend/apps/layout/front-components#current-limitations).Ambos os ambientes têm `twenty-client-sdk/core` e `twenty-client-sdk/metadata` disponíveis como módulos pré-fornecidos — eles não são empacotados, mas resolvidos em tempo de execução pelo servidor.+Componentes de front-end também podem compartilhar dependências por meio de um [bundle de dependências compartilhadas](/l/pt/developers/extend/apps/layout/front-components#sharing-dependencies-across-front-components). Os pacotes listados no campo `frontComponentSharedDependencies` do package.json do app são compilados uma vez em um arquivo separado e carregados a partir dele em tempo de execução, em vez de serem incorporados em cada componente. Assim, um componente que importa apenas pacotes compartilhados praticamente não carrega código de dependência próprio.+## ConfiguraçãoO aplicativo gerado pelo scaffolder já inclui o Vitest. Se você configurá-lo manualmente, instale as dependências:diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/translations/overview.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/translations/overview.mdxindex 44c4a38c7ce..dd5e77a3931 100644--- a/packages/twenty-docs/l/pt/developers/extend/apps/translations/overview.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/apps/translations/overview.mdx@@ -55,9 +55,9 @@ const Card = ({ count, name }: { count: number; name: string }) => {### Quando usar qual-* **`<Trans>…</Trans>`** — texto estático em JSX. Use as propriedades `message` e`values`- para interpolação (`<Trans message="Hi {name}" values={{ name }} />`);- interpolar diretamente nos filhos não é estaticamente extracurável.+* **`Trans`** — texto estático em JSX. Use as props `message` e `values` para+ interpolação, como em `Trans message="Hi {name}" values={{ name }}`;+ a interpolação diretamente em children não pode ser extraída estaticamente.* **`useTranslate().t`** — strings dinâmicas dentro de um componente. Rerenderiza quando o usuáriomuda de linguagem. Prefere isso dentro de renderização.* **`t(...)`** (importado diretamente) — tradução ávida utilizável **em qualquer lugar**,@@ -85,8 +85,8 @@ twenty dev:translations-extract # collect strings into locales/twenty dev:translations-extract --locale fr-FR # also scaffold a target locale```-Extração coleta as duas strings do seu manifesto e `t()`/`msg()`/`\<Trans>-do código do seu front-component em `locales/\<locale>. son\`, chave por+A extração coleta tanto os rótulos do seu manifesto quanto as strings de `t()`/`msg()`/`Trans`+no código-fonte do seu front-component em `locales/\<locale>.json`, indexadas pelastring de origem. Preencha as traduções:```json@@ -108,8 +108,8 @@ usuário atual: os rótulos do manifesto são resolvidos no lado do servidor e osão incorporados em cada pacote de componente. No tempo de execução, um componente lê a localidadede seu contexto de execução (o idioma atual do host) e resolvecada seqüência de caracteres contra seu catálogo, voltando à fonte quando uma tradução-estiver faltando. Mudar idioma no host renderiza novamente as strings `\<Trans>e-`useTranslate().t\` ao vivo.+estiver faltando. Mudar o idioma no host faz com que as strings de `Trans` e+`useTranslate().t` sejam renderizadas novamente em tempo real.Como os catálogos são compilados no tempo de construção, atualizar uma tradução significareexecutar `vinte dev:build` (e redistribuir), o mesmo que qualquer outra mudança.@@ -120,6 +120,13 @@ contínuo `vinte dev` mostra strings de origem, então teste saída localizadacom uma compilação única.</Note>-`<Trans>` Crianças de texto podem span várias linhas — espaço em branco é recolhido o-da mesma forma que JSX o colapsa, so `<Trans>Bem-vindo\n de volta</Trans>` e a chave extraída-ambas se tornam `Bem-vindo de volta`.+O conteúdo de texto (children) de `Trans` pode se estender por várias linhas — os espaços em branco são colapsados da+mesma forma que o JSX os colapsa, portanto, ambos são extraídos para a chave `Welcome back`:++```tsx+<Trans>Welcome back</Trans>+<Trans>+ Welcome+ back+</Trans>+```diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/tutorials/document-generator/building-the-ui.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/tutorials/document-generator/building-the-ui.mdxindex c0431c59ac1..fabafcbfa7a 100644--- a/packages/twenty-docs/l/pt/developers/extend/apps/tutorials/document-generator/building-the-ui.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/apps/tutorials/document-generator/building-the-ui.mdx@@ -291,6 +291,9 @@ projeção em Markdown. O pipeline de geração lê essa projeção Markdown, enespaços reservados, o PDF, e a página da web compartilhável continuam funcionando inalterado —veja o[`template-record. leiaute-idade.ts`](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/examples/document-generator/src/page-layouts/template-record.page-layout.ts).+Widgets de `FIELD` também oferecem suporte a outros modos de exibição e opções, incluindo+a listagem de registros de uma relação aninhada a dois níveis de distância — veja a+[referência do widget de campo](/l/pt/developers/extend/apps/layout/page-layouts#field-widgets).Agora editores escrevem modelos em um editor de texto rico:<Frame caption="A aba Modelo: editor de texto rico nativo de 20 vinculado ao campo de corpo.">diff --git a/packages/twenty-docs/l/pt/developers/extend/extend.mdx b/packages/twenty-docs/l/pt/developers/extend/extend.mdxindex b8d4e6ea381..493541f040e 100644--- a/packages/twenty-docs/l/pt/developers/extend/extend.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/extend.mdx@@ -26,7 +26,7 @@ O Twenty foi projetado para ser extensível. Use nossas APIs, webhooks e o frame<Card title="Webhooks" icon="bell" href="/l/pt/developers/extend/webhooks">Receba notificações de eventos em tempo real</Card>- <Card title="Aplicativos" icon="puzzle-piece" href="/l/pt/developers/extend/apps/getting-started">+ <Card title="Aplicativos" icon="puzzle-piece" href="/desenvolvedores/estend/apps/getting-started/quick-start">Crie personalizações como código</Card></CardGroup>diff --git a/packages/twenty-docs/l/pt/developers/extend/oauth.mdx b/packages/twenty-docs/l/pt/developers/extend/oauth.mdxindex 311192df723..b68b69dae26 100644--- a/packages/twenty-docs/l/pt/developers/extend/oauth.mdx+++ b/packages/twenty-docs/l/pt/developers/extend/oauth.mdx@@ -8,12 +8,12 @@ A Twenty implementa OAuth 2.0 com código de autorização + PKCE para aplicaç## Quando usar OAuth-| Cenário | Método de autenticação |-| -------------------------------------------------- | --------------------------------------------------------------------------------------- |-| Scripts internos, automatização | [Chave de API](/l/pt/developers/extend/api#authentication) |-| Aplicação externa atuando em nome de um utilizador | **OAuth — Código de Autorização** |-| Servidor a servidor, sem contexto de utilizador | **OAuth — Credenciais do Cliente** |-| Aplicação Twenty com extensões de UI | [Aplicações](/l/pt/developers/extend/apps/getting-started) (OAuth é tratado automaticamente) |+| Cenário | Método de autenticação |+| -------------------------------------------------- | --------------------------------------------------------------------------------------------------- |+| Scripts internos, automatização | [Chave de API](/l/pt/developers/extend/api#authentication) |+| Aplicação externa atuando em nome de um utilizador | **OAuth — Código de Autorização** |+| Servidor a servidor, sem contexto de utilizador | **OAuth — Credenciais do Cliente** |+| Aplicação Twenty com extensões de UI | [Aplicações](/l/pt/developers/extend/apps/getting-started/quick-start) (OAuth é tratado automaticamente) |## Registar um clientediff --git a/packages/twenty-docs/l/pt/developers/introduction.mdx b/packages/twenty-docs/l/pt/developers/introduction.mdxindex 42fdf65dacb..56b245e20de 100644--- a/packages/twenty-docs/l/pt/developers/introduction.mdx+++ b/packages/twenty-docs/l/pt/developers/introduction.mdx@@ -6,7 +6,7 @@ description: Crie aplicativos, use a API, hospede por conta própria ou contribuimport { CardTitle } from "/snippets/card-title.mdx"<CardGroup cols={3}>- <Card href="/l/pt/developers/extend/apps/getting-started" img="/images/user-guide/halftone/dev-apps.png">+ <Card href="/desenvolvedores/estend/apps/getting-started/quick-start" img="/images/user-guide/halftone/dev-apps.png"><CardTitle>Aplicativos</CardTitle>Estenda o Twenty com objetos personalizados, lógica do lado do servidor, componentes de UI e agentes de IA — tudo como pacotes em TypeScript.</Card>diff --git a/packages/twenty-docs/l/pt/developers/self-host/capabilities/docker-compose.mdx b/packages/twenty-docs/l/pt/developers/self-host/capabilities/docker-compose.mdxindex 05324661a13..40af775288b 100644--- a/packages/twenty-docs/l/pt/developers/self-host/capabilities/docker-compose.mdx+++ b/packages/twenty-docs/l/pt/developers/self-host/capabilities/docker-compose.mdx@@ -109,7 +109,7 @@ curl http://localhost:3000### Expor o Twenty para Acesso Externo-Por padrão, o Twenty é executado em `localhost` na porta `3000`. Para acessá-lo via um domínio externo ou endereço IP, você precisa configurar o `SERVER_URL` no seu arquivo `.env`.+Por padrão, o Twenty é executado em `localhost` na porta `3000`. A interface acessa a API a partir da origem do próprio navegador, portanto pode ser carregada de qualquer nome de host que alcance o contêiner — ainda assim, defina `SERVER_URL` como sua URL pública: o servidor a utiliza para gerar links (e-mails, callbacks de OAuth) e para detectar HTTPS e definir cookies seguros.#### Compreendendo `SERVER_URL`@@ -229,7 +229,7 @@ Adicione ao seu crontab (`crontab -e`):1. Pare o aplicativo:```bash-docker compose stop twenty-server twenty-front+docker compose stop server worker```2. Restaure o banco de dados:diff --git a/packages/twenty-docs/l/pt/developers/self-host/capabilities/setup.mdx b/packages/twenty-docs/l/pt/developers/self-host/capabilities/setup.mdxindex 8d6f111bf97..a816d08746f 100644--- a/packages/twenty-docs/l/pt/developers/self-host/capabilities/setup.mdx+++ b/packages/twenty-docs/l/pt/developers/self-host/capabilities/setup.mdx@@ -204,7 +204,13 @@ No Console do Microsoft Azure habilite as seguintes APIs em "Permissões":* Microsoft Graph: profile* Microsoft Graph: offline_access-Nota: "Mail.ReadWrite" e "Mail.Send" são apenas obrigatórios se você quiser enviar emails usando nossas ações de fluxo de trabalho. Você pode usar "Mail.Read" em vez disso se quiser apenas receber emails.+<Note>+"Mail.ReadWrite" e "Mail.Send" são obrigatórios apenas se você quiser enviar emails usando nossas ações de fluxo de trabalho. Você pode usar "Mail.Read" em vez disso se quiser apenas receber emails.+</Note>++<Note>+"Calendars.ReadWrite" é obrigatório se você quiser criar eventos de calendário usando nossas ações de fluxo de trabalho. Se você quiser apenas sincronizar eventos de calendário, use "Calendars.Read".+</Note>### URIs de redirecionamento autorizados@@ -271,9 +277,9 @@ yarn command:prod cron:workflow:automated-cron-trigger2. Encontre a seção **Email**3. Configure suas configurações SMTP:-<ArticleTabs label1="Gmail" label2="Office365" label3="Smtp4dev">+<Tabs>- <ArticleTab>+ <Tab title="Gmail">Você precisará provisionar uma [Senha de App](https://support.google.com/accounts/answer/185833).* EMAIL_DRIVER=smtp@@ -282,9 +288,9 @@ yarn command:prod cron:workflow:automated-cron-trigger* EMAIL_SMTP_USER=gmail_email_address* EMAIL_SMTP_PASSWORD='gmail_app_password'- </ArticleTab>+ </Tab>- <ArticleTab>+ <Tab title="Office365">Lembre-se de que, se você tiver 2FA ativado, precisará providenciar uma [Senha de App](https://support.microsoft.com/en-us/account-billing/manage-app-passwords-for-two-step-verification-d6dc8c6d-4bf7-4851-ad95-6d07799387e9).* EMAIL_DRIVER=smtp@@ -293,9 +299,9 @@ yarn command:prod cron:workflow:automated-cron-trigger* EMAIL_SMTP_USER=office365_email_address* EMAIL_SMTP_PASSWORD='office365_password'- </ArticleTab>+ </Tab>- <ArticleTab>+ <Tab title="smtp4dev">**smtp4dev** é um servidor SMTP falso para desenvolvimento e teste.* Execute a imagem smtp4dev: `docker run --rm -it -p 8090:80 -p 2525:25 rnwood/smtp4dev`@@ -305,9 +311,9 @@ yarn command:prod cron:workflow:automated-cron-trigger* EMAIL_SMTP_HOST=localhost* EMAIL_SMTP_PORT=2525- </ArticleTab>+ </Tab>-</ArticleTabs>+</Tabs><Warning>**Modo somente ambiente:** Se você definir `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, adicione estas variáveis ao seu arquivo `.env`.@@ -380,3 +386,30 @@ LOGIC_FUNCTION_TYPE=DISABLED # default when NODE_ENV=production<Note>Ao usar `LOGIC_FUNCTION_TYPE=DISABLED` ou `CODE_INTERPRETER_TYPE=DISABLED`, qualquer tentativa de execução retornará um erro. Isso é útil se você quiser executar o Twenty sem esses recursos.</Note>++## API e front-end em hosts separados++Apenas relevante se você não permitir que o back-end sirva o front-end. Implantações de mesma origem+não precisam de nada aqui.++Declare todas as origens de navegador que se comunicam com a API, separadas por vírgula. `SERVER_URL`+e `FRONTEND_URL` já são confiáveis. O servidor registra um aviso quando um navegador+faz uma chamada a partir de uma origem não declarada.++```bash+AUTH_COOKIE_ALLOWED_ORIGINS=https://app.example.com+```++<Warning>+O front-end envia credenciais em todas as solicitações, e os navegadores rejeitam uma+resposta com credenciais vinda de uma origem não declarada, portanto o app não carrega até+que você defina isso.+</Warning>++Se os dois hosts estiverem em domínios registráveis diferentes (não apenas em+subdomínios diferentes), também defina `AUTH_COOKIE_SAME_SITE=none`, o que requer HTTPS.++Com o multi-workspace ativado, não liste aqui todos os subdomínios dos workspaces.+Em vez disso, roteie os caminhos da API (`/graphql`, `/metadata`, `/rest`, `/auth/`,+`/client-config`, `/file`) para o back-end em cada hostname de workspace, para que cada+workspace permaneça na mesma origem — é assim que o Twenty Cloud funciona.diff --git a/packages/twenty-docs/l/pt/developers/self-host/capabilities/upgrade-guide.mdx b/packages/twenty-docs/l/pt/developers/self-host/capabilities/upgrade-guide.mdxindex 7ffeb507797..15621b836ef 100644--- a/packages/twenty-docs/l/pt/developers/self-host/capabilities/upgrade-guide.mdx+++ b/packages/twenty-docs/l/pt/developers/self-host/capabilities/upgrade-guide.mdx@@ -25,11 +25,11 @@ Se você usa o Docker Compose, siga estas etapas:O servidor executa automaticamente todas as migrações de atualização necessárias na inicialização. Nenhum comando manual é necessário.-## Atualizações entre versões (v1.22+)+## Atualizações entre versões (v1.23+)-A partir da **v1.22**, o Twenty oferece suporte a atualizações entre versões. Você pode pular diretamente de qualquer versão compatível para a versão mais recente sem passar por cada versão intermediária.+A partir da **v1.23**, o Twenty oferece suporte a atualizações entre versões. Você pode pular diretamente de qualquer versão compatível para a versão mais recente sem passar por cada versão intermediária.-Por exemplo, a atualização da v1.22 diretamente para a v2.0 é totalmente suportada.+Por exemplo, a atualização da v1.23 diretamente para a v2.0 é totalmente suportada.## Atualizando para a v2.5+ — envelope de criptografia em repouso@@ -97,6 +97,6 @@ docker exec -it {server_container_name_or_id} yarn command:prod upgrade:status -Isso mostra apenas os espaços de trabalho que estão desatualizados ou com falha, juntamente com a mensagem de erro de cada falha.-## Antes da v1.22+## Antes da v1.23-Se a sua instância for anterior à v1.22, você deve atualizar incrementalmente por cada versão principal marcada (da v1.6 para a v1.7, depois da v1.7 para a v1.8 e assim por diante) até chegar à v1.22. A partir daí, você pode pular diretamente para a versão mais recente.+Se a sua instância for anterior à v1.23, você deve atualizar incrementalmente por cada versão principal marcada (da v1.6 para a v1.7, depois da v1.7 para a v1.8 e assim por diante) até chegar à v1.23. A partir daí, você pode pular diretamente para a versão mais recente.diff --git a/packages/twenty-docs/l/pt/getting-started/core-concepts/apps.mdx b/packages/twenty-docs/l/pt/getting-started/core-concepts/apps.mdxindex 29cedbedf0a..3068db9717a 100644--- a/packages/twenty-docs/l/pt/getting-started/core-concepts/apps.mdx+++ b/packages/twenty-docs/l/pt/getting-started/core-concepts/apps.mdx@@ -36,6 +36,6 @@ Tudo é detectado por meio de análise de AST em tempo de build — sem arquivosVocê escreve seu aplicativo como um projeto TypeScript na sua máquina. A CLI observa seus arquivos-fonte e os sincroniza em tempo real com um servidor Twenty em execução — edite um arquivo e veja a alteração na UI em segundos. O cliente de API tipado é regenerado automaticamente quando o esquema muda. Quando estiver pronto, `yarn twenty app:publish --private` faz o push para um servidor de produção, ou `yarn twenty app:publish` lista seu aplicativo no npm e no marketplace do Twenty.-<Card title="Crie seu primeiro aplicativo" icon="arrow-right" href="/l/pt/developers/extend/apps/getting-started">+<Card title="Crie seu primeiro aplicativo" icon="arrow-right" href="/l/pt/developers/extend/apps/getting-started/quick-start">Tutorial em três fases — gerar o esqueleto, executar um servidor local, sincronizar suas alterações.</Card>diff --git a/packages/twenty-docs/l/pt/user-guide/data-model/capabilities/relation-fields.mdx b/packages/twenty-docs/l/pt/user-guide/data-model/capabilities/relation-fields.mdxindex a0044af0318..7e781356d70 100644--- a/packages/twenty-docs/l/pt/user-guide/data-model/capabilities/relation-fields.mdx+++ b/packages/twenty-docs/l/pt/user-guide/data-model/capabilities/relation-fields.mdx@@ -41,8 +41,6 @@ Muitos registos no Objeto A podem estar ligados a muitos registos no Objeto B.As relações muitos-para-muitos utilizam um padrão de **objeto de junção**: um objeto intermediário que conecta ambos os lados. Com o recurso de relação de junção, Twenty exibe diretamente os registros finais vinculados, ocultando o objeto intermediário da IU.-<img src="/images/user-guide/fields/junction-relation-diagram.png" style={{width:'100%'}} />-<Warning>**Recurso beta**: As relações de junção devem ser ativadas em **Configurações → Comunidade → Recursos** antes do uso.</Warning>diff --git a/packages/twenty-docs/l/pt/user-guide/legal/how-tos/legal-faq.mdx b/packages/twenty-docs/l/pt/user-guide/legal/how-tos/legal-faq.mdxindex 53089d6b026..f20f4131717 100644--- a/packages/twenty-docs/l/pt/user-guide/legal/how-tos/legal-faq.mdx+++ b/packages/twenty-docs/l/pt/user-guide/legal/how-tos/legal-faq.mdx@@ -44,7 +44,7 @@ A IA pode ser totalmente desativada desligando todos os modelos de IA em SettingTodos os dados são criptografados em trânsito e em repouso. Os dados dos locatários são isolados por meio de uma configuração de esquema por locatário, e as chaves de criptografia são periodicamente rotacionadas.</Accordion><Accordion title="Que vinte funcionários ou subprocessadores podem acessar os espaços de trabalho do cliente, para que fins, e como o acesso é aprovado e registrado?">-As equipes de engenharia e suporte da Twenty podem acessar os workspaces dos clientes somente após o cliente relatar um problema e conceder acesso em Settings → General → Security.+As equipas de engenharia e de apoio da Twenty podem aceder aos espaços de trabalho dos clientes para investigar e resolver problemas. Os proprietários dos espaços de trabalho controlam isto: o acesso da equipa de apoio pode ser desativado a qualquer momento em Definições → Geral → Segurança e permanece desativado até que volte a ativá-lo.</Accordion><Accordion title="Qual é o seu processo de notificação de incidente e período de notificação alvo após um incidente de segurança confirmado que afeta nossos dados?">No caso de uma violação de dados pessoais confirmada afetando seus dados, notificaremos você sem um atraso indevido e em qualquer evento dentro de 48 horas após tomar conhecimento dele. Nossa notificação incluirá, na medida conhecida no momento: a natureza da violação, as categorias e o volume aproximado de dados e indivíduos afectados, consequências prováveis, e as medidas de reparação e mitigação tomadas ou planeadas. Iremos apresentar atualizações à medida que a investigação for avançando.@@ -64,7 +64,7 @@ Por padrão, os registros excluídos logicamente são mantidos por 14 dias, apóUm registro removido permanece nos backups por 30 dias, após os quais é excluído permanentemente.</Accordion><Accordion title="Quando um espaço de trabalho é fechado ou a exclusão completa é solicitada, qual linha do tempo exata se aplica aos dados de produção, anexos, logs e backups?">-Quando um workspace é excluído, seus dados são imediatamente removidos dos sistemas ativos. Os backups são retidos por 7 dias, após os quais todos os dados são excluídos permanentemente.+Quando um espaço de trabalho é eliminado, os respetivos dados são removidos dos sistemas em produção no prazo de aproximadamente 90 dias após a cessação do serviço, e geralmente muito antes. As cópias de segurança e de arquivo são então substituídas ou eliminadas num prazo adicional de 90 dias, após o qual todos os dados são permanentemente apagados. Durante ambos os períodos, os dados ficam isolados de qualquer utilização operacional. Mediante pedido, podemos fornecer uma certificação por escrito assim que a purga estiver concluída. Consulte a cláusula 4.9 do seu Acordo de Tratamento de Dados para conhecer todos os termos.</Accordion><Accordion title="Durante qualquer período de retenção de back-retention, são excluídos dados isolados do acesso operacional e usados?">Sim, durante qualquer período de retenção de back-retention, dados excluídos são isolados de uso operacional.@@ -108,4 +108,18 @@ Não, estão em vias de se tornar conformes com a iniciativa HIPAA.</Accordion></AccordionGroup>+## Licenciamento++<AccordionGroup>+<Accordion title="Se eu alterar o código para adicionar funcionalidades apenas para uso interno da minha equipa, tenho de publicar essas alterações?">+Não. Executar uma versão modificada para a sua própria equipa não é distribuição, portanto não surge qualquer obrigação de publicação. A cláusula de rede da AGPL aplica-se quando pessoas fora da sua organização interagem com a sua instância modificada através da rede.+</Accordion>+<Accordion title="Se eu criar um front end separado e usar Twenty como backend tal como está, tenho de publicar essas alterações?">+Não. O seu front end é um trabalho próprio e separado, e comunicar com o Twenty através das suas APIs não altera isso. Como o próprio Twenty não é modificado, não há nada a publicar.+</Accordion>+<Accordion title="Se eu alterar o código para adicionar funcionalidades para o revender, tenho de publicar essas alterações?">+Sim, como está a modificar código para o distribuir a terceiros, é obrigado a publicar essas alterações. Se não quiser publicar as suas alterações, pode obter uma licença Organization.+</Accordion>+</AccordionGroup>+Se você tiver mais dúvidas, consulte nossos [Termos e Condições](https://twenty.com/terms), nossa [Política de Privacidade](https://twenty.com/privacy-policy) e nosso [Trust Center](https://trust.twenty.com/). Se suas dúvidas ainda não tiverem sido respondidas, envie-as para [[email protected]](mailto:[email protected]) ou via chat de suporte.diff --git a/packages/twenty-docs/l/pt/user-guide/workflows/capabilities/use-branches-in-workflows.mdx b/packages/twenty-docs/l/pt/user-guide/workflows/capabilities/use-branches-in-workflows.mdxindex 494c885eaaf..987bc4158ee 100644--- a/packages/twenty-docs/l/pt/user-guide/workflows/capabilities/use-branches-in-workflows.mdx+++ b/packages/twenty-docs/l/pt/user-guide/workflows/capabilities/use-branches-in-workflows.mdx@@ -20,8 +20,6 @@ Para executar apenas uma ramificação com base em condições específicas, **a3. Defina condições em cada Filter para determinar quando essa ramificação deve continuar4. Somente as ramificações cujas condições do Filter forem atendidas prosseguirão-<img src="/images/user-guide/workflows/branches-with-filters.png" style={{width:'100%'}} />-### Como funcionam os nós Filter* Se a condição do Filter for **atendida**: A ramificação continua em execuçãodiff --git a/packages/twenty-docs/l/ro/developers/extend/apps/layout/front-components.mdx b/packages/twenty-docs/l/ro/developers/extend/apps/layout/front-components.mdxindex c4f7a6dc1f1..331349d5caf 100644--- a/packages/twenty-docs/l/ro/developers/extend/apps/layout/front-components.mdx+++ b/packages/twenty-docs/l/ro/developers/extend/apps/layout/front-components.mdx@@ -806,22 +806,22 @@ Un `ref` îți oferă un element din sandbox, nu un `HTMLElement`.| `element.classList.add(...)` | Aruncă o excepție (`classList` este `undefined`) | Construiește singur șirul `className` || `document.getElementById()`, `getElementsByClassName()`, `createTreeWalker()` | Aruncă o excepție | `querySelector()` / `querySelectorAll()`, care funcționează || `document.activeElement` | Întotdeauna `undefined` | Urmărește focusul cu `onFocus` / `onBlur` |-| `\<canvas>` | Nu redă nimic, fără eroare | SVG sau desenează offscreen și afișează un `<img src={dataUrl}>` |+| `canvas` | Nu redă nimic, fără eroare | SVG sau desenează în afara ecranului și afișează rezultatul într-un element `img` || `createPortal(node, document.body)` | Nu redă nimic, în timp ce `isConnected` raportează succes | Suprapuneri inline cu `position: absolute` sau transmite bibliotecii propriul tău element container |Golul portalului este motivul pentru care popover-urile Radix, Headless UI, MUI și react-select nu redau nimic în mod implicit. Majoritatea acceptă o proprietate de tip container; indică-i un element pe care l-ai redat.### Evenimente-Mouse, pointer, touch, drag, tastatură, focus, `input`/`change`/`submit`, `scroll`/`wheel`/`contextmenu` și `animationend`/`transitionend` trec către gazdă, plus câteva per element: `load`/`error` pe `<img>`, clipboard și compoziție pe `<input>`/`\<textarea>`, media pe `\<video>`/`\<audio>`, `toggle` pe `\<details>`/`\<dialog>`. Orice altceva (`onAuxClick`, `onSelect`, `onInvalid`, `onReset`, `onAnimationStart`, pointer capture, `onLoad` de pe `<img>`) este eliminat fără avertisment.+Mouse, pointer, touch, drag, tastatură, focus, `input`/`change`/`submit`, `scroll`/`wheel`/`contextmenu` și `animationend`/`transitionend` trec către gazdă, plus câteva per element: `load`/`error` pe `img`, clipboard și compoziție pe `input`/`textarea`, media pe `video`/`audio`, `toggle` pe `details`/`dialog`. Orice altceva (`onAuxClick`, `onSelect`, `onInvalid`, `onReset`, `onAnimationStart`, pointer capture, `onLoad` de pe `img`) este eliminat fără avertisment.`document.addEventListener()` și `window.addEventListener()` se înregistrează fără eroare și nu se declanșează niciodată, motiv pentru care un drag se oprește imediat ce pointerul părăsește elementul de pe care a început. `event.preventDefault()` nu trece nici el; trimiterea formularelor, `dragover`/`drop` și clicurile pe linkuri sunt deja protejate pentru tine.### Atribute și stilizare-Fiecare element își transmite propriile proprietăți către DOM-ul gazdă (`href` pe `\<a>`, `src`/`alt` pe `<img>`, `value`/`placeholder`/`disabled` pe `<input>` și așa mai departe), plus un set comun pe fiecare element: `id`, `className`, `style`, `title`, `tabIndex`, `role`, `draggable` și orice atribut `aria-*` / `data-*` (cu cratimă, astfel încât `ariaLabel` este ignorat). Orice în afara acestora este ignorat în tăcere, așa că exprimă starea personalizată ca `data-*`.+Fiecare element își transmite propriile proprietăți către DOM-ul gazdă (`href` pe `a`, `src`/`alt` pe `img`, `value`/`placeholder`/`disabled` pe `input` etc.), plus un set comun pe fiecare element: `id`, `className`, `style`, `title`, `tabIndex`, `role`, `draggable` și orice atribut `aria-*` / `data-*` (cu cratimă, astfel încât `ariaLabel` este omis). Orice în afara acestora este ignorat în tăcere, așa că exprimă starea personalizată ca `data-*`.-CSS-ul componentei, fie din `import './styles.css'`, CSS-in-JS sau un element `\<style>`, este injectat în `\<head>` al paginii gazdă **fără scope**. Astfel numele de clase intră în coliziune cu cele ale Twenty (prefixează-le și nu scrie niciodată un selector simplu `div { ... }`), iar `@media` se potrivește cu fereastra browserului, nu cu widgetul tău (folosește `@container` cu propriul tău `container-type`). Proprietățile `style` inline nu sunt afectate.+CSS-ul componentelor, fie din `import './styles.css'`, CSS-in-JS sau un element `style`, este injectat în `head`-ul paginii gazdă **fără scope (unscoped)**. Astfel numele de clase intră în coliziune cu cele ale Twenty (prefixează-le și nu scrie niciodată un selector simplu `div { ... }`), iar `@media` se potrivește cu fereastra browserului, nu cu widgetul tău (folosește `@container` cu propriul tău `container-type`). Proprietățile `style` inline nu sunt afectate.### Stocare și rețea@@ -835,7 +835,7 @@ CSS-ul componentei, fie din `import './styles.css'`, CSS-in-JS sau un element `\### Alte lacune-* **Conținutul fișierului.** `<input type="file">` oferă handlerului tău doar metadatele fișierului, nu și octeții, astfel încât `FileReader` și încărcările nu sunt încă posibile.+* **Conținutul fișierului.** Un `input` de tip `file` oferă handlerului tău doar metadatele fișierului, nu și octeții, astfel încât `FileReader` și încărcările nu sunt încă posibile.* **Payload-uri drag-and-drop.** Evenimentele de tip drag sunt declanșate, dar `event.dataTransfer` este `undefined`.* **Built-in-uri Node.** `fs`, `path` și `node:crypto` eșuează la build, așa că mută acea logică într-o [logic function](/l/ro/developers/extend/apps/logic/logic-functions). Web Crypto, `fetch`, `TextEncoder` și `URL` sunt disponibile.-* **`\<iframe>`** este întotdeauna pus din nou în sandbox fără `allow-same-origin`, astfel încât un embed care se bazează pe propria sesiune este randat ca delogat. Nu are nici `onLoad`.+* **`iframe`** este întotdeauna re-sandboxat fără `allow-same-origin`, astfel încât o încorporare care se bazează pe propria sesiune se afișează ca delogat. Nu are nici `onLoad`.diff --git a/packages/twenty-docs/l/ro/developers/extend/apps/translations/overview.mdx b/packages/twenty-docs/l/ro/developers/extend/apps/translations/overview.mdxindex 37a479fcf6d..f8251f7bc5a 100644--- a/packages/twenty-docs/l/ro/developers/extend/apps/translations/overview.mdx+++ b/packages/twenty-docs/l/ro/developers/extend/apps/translations/overview.mdx@@ -54,9 +54,9 @@ const Card = ({ count, name }: { count: number; name: string }) => {### Când să utilizaţi care-* **`<Trans>…</Trans>`** — text static în JSX. Utilizaţi `message` şi `values`- props pentru interpolare (`<Trans message="Hi {name}" values={{ name }} />`);- interpolând direct la copii nu poate fi extras static.+* **`Trans`** — text static în JSX. Folosește proprietățile `message` și `values` pentru+ interpolare, ca în `Trans message="Hi {name}" values={{ name }}`;+ interpolarea direct în elementele copil nu poate fi extrasă static.* **`useTranslate().t`** - șiruri dinamice în interiorul unei componente. Re-randează atunci când utilizatorulschimbă limba. Preferă acest lucru în redare.* **`t(...)`** (importat direct) - traducerea mai ușoară **oriunde**,@@ -84,9 +84,9 @@ twenty dev:translations-extract # collect strings into locales/twenty dev:translations-extract --locale fr-FR # also scaffold a target locale```-Extragerea colectează atât etichetele manifestului cât şi `t()`/`msg()`/`\<Trans>`-din sursa componentei front-line în `locales/\<locale>. son`, keyed by-source string. Completează traducerile:+Procesul de extragere colectează atât etichetele manifestului, cât și șirurile `t()`/`msg()`/`Trans`+din sursa front-component în `locales/\<locale>.json`, indexate după+șirul sursă. Completează traducerile:```json// locales/fr-FR.json@@ -107,8 +107,8 @@ Localnicii ca `{name}` sunt substituiți la timp - țineți-le în traducereasunt copite în fiecare pachet de componente. La runtime, o componentă citește localizareadin contextul de execuție (limba curentă a gazdei) și rezolvăfiecare șir din catalog, revenind la sursă atunci când lipsește o traducere-. Schimbarea limbii în șir rerandează `\<Trans>` și-șirurile `useTranslate().t` live.+. Schimbarea limbii în gazdă reafișează în timp real șirurile `Trans` și+`useTranslate().t`.Deoarece cataloagele sunt compilate la ora de construcție, actualizarea unei traduceri înseamnărepornirea `douăzeci dev:build` (și redistribuirea), la fel ca orice altă schimbare.@@ -119,6 +119,13 @@ ceasul continuu `douăzeci de dev` arată șirurile sursă, așa că testează rcu o singură construcție.</Note>-`<Trans>` text copii pot parcurge mai multe linii - spațiul alb este prăbușit-la fel cum JSX o destramă, Așa că '<Trans>Bun venit\n înapoi</Trans>' iar cheia-a fost extrasă devin 'Bine ați revenit'.+Elementele text copil ale `Trans` pot acoperi mai multe linii — spațiile albe sunt comprimate în+același mod în care JSX le comprimă, astfel încât ambele variante sunt extrase cu cheia `Welcome back`:++```tsx+<Trans>Welcome back</Trans>+<Trans>+ Welcome+ back+</Trans>+```diff --git a/packages/twenty-docs/l/ru/developers/contribute/capabilities/bug-and-requests.mdx b/packages/twenty-docs/l/ru/developers/contribute/capabilities/bug-and-requests.mdxindex 0fe580fd308..d68b1d81650 100644--- a/packages/twenty-docs/l/ru/developers/contribute/capabilities/bug-and-requests.mdx+++ b/packages/twenty-docs/l/ru/developers/contribute/capabilities/bug-and-requests.mdx@@ -22,7 +22,7 @@ info: Сообщайте о проблемах, предлагайте новы1. Проверьте [существующие обращения](https://github.com/twentyhq/twenty/issues) на предмет связанной работы2. Для новых функций сначала откройте обращение для обсуждения-3. Ознакомьтесь с нашим [Кодексом поведения](https://github.com/twentyhq/twenty/blob/main/CODE_OF_CONDUCT.md)+3. Ознакомьтесь с нашим [Кодексом поведения](https://github.com/twentyhq/twenty/blob/main/.github/CODE_OF_CONDUCT.md)### Сделайте форк и клонируйтеdiff --git a/packages/twenty-docs/l/ru/developers/contribute/contribute.mdx b/packages/twenty-docs/l/ru/developers/contribute/contribute.mdxindex 866fe1786ef..14e3a82cc20 100644--- a/packages/twenty-docs/l/ru/developers/contribute/contribute.mdx+++ b/packages/twenty-docs/l/ru/developers/contribute/contribute.mdx@@ -25,7 +25,7 @@ Twenty — проект с открытым исходным кодом, кот<Card title="Отчеты об ошибках и запросы" icon="bug" href="/l/ru/developers/contribute/capabilities/bug-and-requests">Сообщайте о проблемах или запрашивайте новые функции</Card>- <Card title="Разработка интерфейса" icon="browser" href="/l/ru/developers/contribute/capabilities/frontend-development">+ <Card title="Разработка интерфейса" icon="browser" href="/l/ru/developers/contribute/capabilities/frontend-development/folder-architecture-front">Внесите вклад в пользовательский интерфейс</Card></CardGroup>diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/config/application.mdxindex 6c79e0136e8..18e92785dce 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/config/application.mdx@@ -9,7 +9,7 @@ icon: rocket* **Идентификация** — универсальный идентификатор, отображаемое имя, описание.* **Разрешения** — от имени какой роли выполняются его логические функции и фронтенд-компоненты.* **Переменные** *(необязательно)* — пары ключ–значение, доступные вашему коду как переменные окружения.-* **Хуки предустановки / постустановки** *(необязательно)* — см. [Логические функции](/l/ru/developers/extend/apps/logic/logic-functions).+* **Хуки предустановки / постустановки / удаления** *(необязательно)* — см. [Логические функции](/l/ru/developers/extend/apps/logic/logic-functions).```ts src/application-config.tsimport { defineApplication } from 'twenty-sdk/define';@@ -34,8 +34,64 @@ export default defineApplication({* Поля `universalIdentifier` — это детерминированные идентификаторы, которые принадлежат вам. Сгенерируйте их один раз и сохраняйте неизменными между синхронизациями.* `applicationVariables` становятся переменными окружения для ваших функций и фронтенд-компонентов. В логических функциях (на стороне сервера) они доступны как `process.env.VARIABLE_NAME`. Во фронтенд-компонентах используйте `getApplicationVariable('VARIABLE_NAME')` из `twenty-sdk/front-component`. Переменные, помеченные как `isSecret: true`, внедряются только в логические функции. Фронтенд-компоненты получают только несекретные переменные.* Роль по умолчанию автоматически определяется из файла роли, помеченного с помощью [`defineApplicationRole()`](/l/ru/developers/extend/apps/config/roles) — вам не нужно ссылаться на неё из `defineApplication()`.-* Предустановочные и постустановочные функции обнаруживаются автоматически во время сборки манифеста — вам не нужно указывать их в `defineApplication()`.+* Функции предустановки, постустановки и удаления обнаруживаются автоматически во время сборки манифеста — вам не нужно указывать их в `defineApplication()`.* Явная передача `defaultRoleUniversalIdentifier` по-прежнему поддерживается для обратной совместимости, но считается устаревшей и вместо неё рекомендуется использовать `defineApplicationRole()`.+* `serverVariables` — это параметры конфигурации и секреты в области экземпляра (например, ключи API). В отличие от `applicationVariables`, значения для них не указываются в манифесте — оператор рабочего пространства заполняет их в настройках приложения, и они внедряются в логические функции только после того, как будут заданы.+* Оба типа переменных принимают `isDeprecated: true`. Используйте это, чтобы вывести переменную из обращения вместо её удаления: сохранение объявленного ключа сохраняет хранимое значение (удаление уничтожает значение, введённое пользователем), а переменная по-прежнему внедряется, поэтому код сможет обратиться к ней — `process.env.NEW_API_KEY ?? process.env.API_KEY`. Устаревшая переменная исчезает из настроек приложения, как только у неё больше нет значения, и никогда не учитывается при проверке конфигурации приложения, поэтому `isDeprecated` имеет приоритет над `isRequired`.+* Чтобы отобразить на вкладке **Settings** приложения пользовательский интерфейс настройки (вместо стандартного раздела настройки переменных), объявите фронтенд‑компонент с помощью [`defineSettingsFrontComponent()`](/l/ru/developers/extend/apps/layout/front-components#custom-settings-component) в отдельном файле. Для каждого приложения допускается только один такой компонент. Разделы, управляемые системой (автообновление, App URL, соединения), всегда остаются видимыми.++## Типы переменных++И `applicationVariables`, и `serverVariables` принимают необязательный `type` (а для `SELECT` / `MULTI_SELECT` — список `options`). Поддерживаемые типы: `TEXT` (по умолчанию), `BOOLEAN`, `NUMBER`, `NUMERIC`, `DATE`, `DATE_TIME`, `SELECT`, `MULTI_SELECT`, `ARRAY`, `RAW_JSON`, `RICH_TEXT`.++```ts src/application-config.ts+import { defineApplication, FieldType } from 'twenty-sdk/define';++export default defineApplication({+ // ...identity, role...+ applicationVariables: {+ MAX_POSTCARDS: {+ universalIdentifier: '5f4497e4-9030-4085-85eb-2c48b8d53713',+ description: 'Maximum postcards per batch',+ type: FieldType.NUMBER,+ value: 10,+ },+ DEFAULT_REGION: {+ universalIdentifier: '76c5c321-b6b6-46eb-b4fc-f9f04bb04227',+ description: 'Default shipping region',+ type: FieldType.SELECT,+ options: [+ { label: 'Europe', value: 'eu' },+ { label: 'United States', value: 'us' },+ ],+ value: 'eu',+ },+ },+});+```++Свойство `type` влияет только на **отображение и валидацию** — оно выбирает соответствующий ввод в UI настроек рабочего пространства (переключатель, числовое поле, раскрывающийся список, выбор даты, JSON‑редактор, …) и позволяет сборке проверить вашу конфигурацию (например, `SELECT` / `MULTI_SELECT` должны объявить непустой список `options`). Оно **не** меняет то, как значение попадает в ваш код.++Значения **всегда внедряются как строки** — это заложено в природу переменных окружения (`process.env.*` содержит только строки). Когда выполняется ваша логическая функция, исполнитель сериализует каждое значение в соответствии с объявленным `type` при построении `process.env`, так что строковый формат остается единым, независимо от того, как было задано значение (значение по умолчанию в манифесте, UI настроек или предыдущая версия):++| Тип | строка в `process.env` |+| ------------------------------------- | --------------------------------------------------- |+| `TEXT`, `SELECT`, `DATE`, `DATE_TIME` | непреобразованное значение (`"eu"`, `"2026-01-01"`) |+| `BOOLEAN` | `"true"` / `"false"` |+| `NUMBER`, `NUMERIC` | десятичная строка (`"10"`, `"2.5"`) |+| `MULTI_SELECT`, `ARRAY` | JSON‑массив (`'["email","postcard"]'`) |+| `RAW_JSON`, `RICH_TEXT` | JSON‑объект (`'{"retries":3}'`) |++Преобразуйте строку обратно в ожидаемый вами тип:++```ts+const maxCards = Number(process.env.MAX_POSTCARDS); // "10" -> 10+const enabled = process.env.ENABLE_TRACKING === 'true'; // "true" -> true+const channels = JSON.parse(process.env.ENABLED_CHANNELS ?? '[]'); // '["email"]' -> ["email"]+const config = JSON.parse(process.env.PROVIDER_CONFIG ?? '{}'); // '{"retries":3}' -> { retries: 3 }+```++Это же относится к фронтенд‑компонентам, читающим значения через `getApplicationVariable('VARIABLE_NAME')` — возвращаемое значение является строкой; при необходимости преобразуйте его.## Роль функции по умолчанию@@ -55,10 +111,14 @@ export default defineApplication({| ------------------ | ------------------------------------------------------------------------------------------------------------------- || `author` | Имя автора или название компании || `category` | Категория приложения для фильтрации в маркетплейсе |-| `logoUrl` | Путь к логотипу вашего приложения (например, `public/logo.png`) |-| `screenshots` | Массив путей к скриншотам (например, `public/screenshot-1.png`) |+| `logo` | Путь к вашему логотипу приложения в `public/` (например, `public/logo.png`) |+| `galleryImages` | Массив путей галереи изображений в комплекте `public/` (например, `public/screenshot-1.png`) || `aboutDescription` | Расширенное описание в Markdown для вкладки "About". Если опущено, маркетплейс использует `README.md` пакета из npm || `websiteUrl` | Ссылка на ваш сайт || `termsUrl` | Ссылка на условия предоставления услуг || `emailSupport` | Адрес электронной почты поддержки || `issueReportUrl` | Ссылка на систему отслеживания проблем |++<Note>+«logoUrl» и «screenshots» являются устаревшими псевдонимами «logo» и «galleryImages». Внешние абсолютные URL-адреса (`http://` или `https://`) не поддерживаются для этих полей: они удаляются с предупреждением на время сборки. Вместо этого объедините изображения в папку `public/` вашего приложения.+</Note>diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/config/install-hooks.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/config/install-hooks.mdxindex 3888623f41d..4e65e4a0cf6 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/config/install-hooks.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/config/install-hooks.mdx@@ -1,12 +1,12 @@---title: Установочные хуки-description: Запускайте логику до или после установки — заполняйте исходные данные, создавайте резервные копии записей, проверяйте корректность обновления.+description: Выполняйте логику во время жизненного цикла установки, обновления или удаления — выполняйте начальное заполнение данными, создавайте резервные копии записей, проверяйте корректность обновления, очищайте внешние ресурсы.icon: wrench----Установочные хуки — это специальные логические функции, которые выполняются во время установки или обновления. Они используют то же окружение выполнения обработчика, что и обычные [logic functions](/l/ru/developers/extend/apps/logic/logic-functions) и получают `InstallPayload`, но объявляются с помощью собственных функций определения — `definePostInstallLogicFunction()` и `definePreInstallLogicFunction()` — и существуют вне обычной модели триггеров (HTTP, cron, события базы данных).+Установочные хуки — это специальные логические функции, которые выполняются во время жизненного цикла установки, обновления или удаления. Они используют то же окружение выполнения обработчика, что и обычные [logic functions](/l/ru/developers/extend/apps/logic/logic-functions), но объявляются с помощью собственных функций определения и существуют вне обычной модели триггеров (HTTP, cron, события базы данных). Установочные хуки получают `InstallPayload` (`{ previousVersion?: string; newVersion: string }` — `previousVersion` имеет значение `undefined` при новой установке); хук удаления получает `UninstallPayload` (`{ version?: string }` — версия, которая удаляется).-Каждое приложение может определить **не более одной функции pre-install** и **не более одной функции post-install**. Сборка манифеста завершится ошибкой, если будет обнаружено более одной функции любого из этих типов.+Каждое приложение может определить **не более одного** хука каждого типа (предустановочный, постустановочный, хук удаления). Сборка манифеста завершится ошибкой, если будет обнаружено более одного хука любого типа.```┌─────────────────────────────────────────────────────────────┐@@ -19,111 +19,59 @@ icon: wrench└─────────────────────────────────────────────────────────────┘```-<AccordionGroup>-<Accordion title="definePostInstallLogicFunction" description="Выполняется после применения миграции метаданных рабочего пространства">+## Краткий обзор-Послеустановочная функция автоматически запускается после того, как установка вашего приложения в рабочем пространстве завершена. Сервер выполняет её **после** того, как метаданные приложения синхронизированы и клиент SDK сгенерирован, так что рабочее пространство полностью готово к использованию, а новая схема уже применена. Типичные сценарии использования включают предзаполнение данных по умолчанию, создание начальных записей, настройку параметров рабочего пространства или выделение ресурсов в сторонних сервисах.+| | `definePreInstallLogicFunction` | `definePostInstallLogicFunction` |+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |+| Запуски | До миграции метаданных — **предыдущая** схема и данные остаются нетронутыми | После миграции и генерации SDK — **новая** схема уже применяется |+| Выполнение | Всегда синхронное; блокирует установку | Асинхронно по умолчанию (постановка в очередь, 3 повторные попытки); синхронный режим по желанию через `shouldRunSynchronously: true` |+| При ошибке | Установка **прерывается** до любых изменений схемы | Асинхронный режим: до 3 повторных попыток. Синхронный режим: вызывающая сторона получает `POST_INSTALL_ERROR` (изменения схемы **не** откатываются) |+| Типичное использование | Создать резервную копию или исправить данные, которые были бы потеряны при миграции; отклонить рискованное обновление, выбросив исключение | Наполнить данными по умолчанию, настроить рабочее пространство, зарегистрировать внешние ресурсы |-```ts src/logic-functions/post-install.ts-import { definePostInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';+**Общее практическое правило:** по умолчанию используйте post-install. Обращайтесь к pre-install только тогда, когда сама миграция разрушительна и вам нужно перехватить предыдущее состояние, прежде чем оно исчезнет.-const handler = async (payload: InstallPayload): Promise<void> => {- console.log('Post install logic function executed successfully!', payload.previousVersion);-};+| Вы хотите... | Использовать |+| -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |+| Инициализировать данные, настроить рабочее пространство, зарегистрировать внешние ресурсы | `post-install` |+| Длительные операции, которые не должны блокировать ответ установки | `post-install` (асинхронный режим по умолчанию, с повторными попытками воркера) |+| Быстрая настройка, на которую вызывающая сторона полагается сразу после завершения установки | `post-install` с `shouldRunSynchronously: true` |+| Прочитать или сохранить данные, которые предстоящая миграция может потерять | `pre-install` |+| Отклонить обновление, которое повредит существующие данные | `pre-install` (бросьте исключение из обработчика) |+| Согласование при каждом обновлении | Любой хук с `shouldRunOnVersionUpgrade: true` |-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:+* Конфиг — это конфиг `defineLogicFunction` без настроек триггера, но с `shouldRunOnVersionUpgrade`.+* **Когда запускается**: по умолчанию только при чистой установке. Установите `shouldRunOnVersionUpgrade: true`, чтобы также запускать его при обновлениях. Используйте `previousVersion` / `newVersion`, чтобы разветвлять логику в зависимости от пути обновления.+* **Идемпотентность имеет значение**: асинхронный post-install может быть повторно выполнен, и любой хук будет запускаться повторно при обновлениях, если включён `shouldRunOnVersionUpgrade`.+* Обычное окружение logic-функций (`APPLICATION_ID`, `APP_ACCESS_TOKEN`, `API_URL`) инъецируется, поэтому вы можете вызывать Twenty API с токеном своего приложения.+* Хук автоматически прикрепляется к манифесту приложения на этапе сборки (`preInstallLogicFunction` / `postInstallLogicFunction`) — ничего не нужно указывать в [`defineApplication()`](/l/ru/developers/extend/apps/config/application).+* Значение `timeoutSeconds` по умолчанию — 300, чтобы позволить выполнять более длительные задачи настройки, такие как инициализация данных.+* **Не выполняется в dev-режиме**: `yarn twenty dev` пропускает процесс установки и синхронизирует файлы напрямую, поэтому хуки там никогда не запускаются. Вместо этого запускайте их вручную:```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` определяет, *как* выполняется post-install.- * `shouldRunSynchronously: false` *(по умолчанию)* — хук **помещается в очередь сообщений** с `retryLimit: 3` и выполняется асинхронно в воркере. Ответ на установку возвращается сразу после постановки задания в очередь, поэтому медленный или дающий сбой обработчик не блокирует вызывающую сторону. Воркер выполнит до трёх повторных попыток. **Используйте это для длительных задач** — наполнение большими наборами данных, вызовы медленных сторонних API, подготовка внешних ресурсов — всего, что может выйти за разумное окно ответа HTTP.- * `shouldRunSynchronously: true` — хук выполняется **непосредственно в процессе установки** (тот же исполнитель, что и для pre-install). Запрос установки блокируется, пока обработчик не завершится, и если он генерирует исключение, вызывающая сторона установки получает `POST_INSTALL_ERROR`. Автоматических повторов нет. **Используйте это для быстрых задач, которые должны завершиться до отправки ответа** — например, выдача ошибки валидации пользователю или быстрая настройка, на которую клиент будет полагаться сразу после возврата вызова установки. Имейте в виду, что к моменту запуска post-install миграция метаданных уже применена, поэтому сбой в синхронном режиме **не** откатывает изменения схемы — он лишь выявляет ошибку.-* Убедитесь, что ваш обработчик идемпотентен. В асинхронном режиме очередь может выполнить до трёх повторных попыток; в любом режиме хук может запускаться снова при обновлениях, когда `shouldRunOnVersionUpgrade: true`.-* Переменные окружения `APPLICATION_ID`, `APP_ACCESS_TOKEN` и `API_URL` доступны внутри обработчика (как и в любой другой логической функции), поэтому вы можете вызывать API Twenty с токеном доступа приложения, ограниченным вашим приложением.-* Для каждого приложения допускается только одна послеустановочная функция. Сборка манифеста завершится ошибкой, если будет обнаружено более одной такой функции.-* Параметры функции `universalIdentifier`, `shouldRunOnVersionUpgrade` и `shouldRunSynchronously` автоматически добавляются в манифест приложения в поле `postInstallLogicFunction` во время сборки — вам не нужно указывать их в [`defineApplication()`](/l/ru/developers/extend/apps/config/application).-* Тайм-аут по умолчанию установлен на 300 секунд (5 минут), чтобы позволить выполнять более длительные задачи настройки, такие как инициализация данных.-* **Не выполняется в режиме разработки**: когда приложение зарегистрировано локально (через `yarn twenty dev`), сервер полностью пропускает процесс установки и синхронизирует файлы напрямую через наблюдатель CLI — поэтому post-install никогда не запускается в режиме разработки, независимо от `shouldRunSynchronously`. Используйте `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-, и post-install получают один и тот же тип `InstallPayload`: `{ previousVersion?: string; newVersion: string }`. Импортируйте его один раз и используйте повторно в обоих хуках.-* **Когда запускается хук**: выполняется непосредственно перед миграцией метаданных рабочего пространства (`synchronizeFromManifest`). Перед выполнением сервер запускает чисто добавочную «урезанную синхронизацию», которая регистрирует в метаданных рабочего пространства pre-install функцию **новой** версии — ничего больше не затрагивается — а затем выполняет её. Поскольку эта синхронизация только добавляет, объекты, поля и данные предыдущей версии остаются нетронутыми к моменту запуска вашего обработчика: вы можете безопасно читать и сохранять состояние до миграции.-* **Модель выполнения**: pre-install выполняется **синхронно** и **блокирует установку**. Если обработчик генерирует исключение, установка прерывается до применения каких-либо изменений схемы — рабочее пространство остаётся на предыдущей версии в согласованном состоянии. Это сделано намеренно: pre-install — ваш последний шанс отказать в рискованном обновлении.-* Как и в случае с post-install, для каждого приложения допускается только одна предустановочная функция. Она автоматически добавляется в манифест приложения в поле `preInstallLogicFunction` во время сборки.-* **Не выполняется в режиме разработки**: как и post-install, процесс установки полностью пропускается для локально зарегистрированных приложений, поэтому pre-install никогда не запускается при `yarn twenty dev`. Используйте `yarn twenty dev:function:exec --preInstall`, чтобы запустить это вручную.--</Accordion>-<Accordion title="Pre-install и post-install: когда что использовать" description="Выбор подходящего хука установки">--Оба хука являются частью одного и того же процесса установки и получают один и тот же `InstallPayload`. Разница в том, **когда** они запускаются относительно миграции метаданных рабочего пространства, и это определяет, к каким данным можно безопасно обращаться.--Pre-install всегда **синхронный** (он блокирует установку и может её прервать). Post-install **по умолчанию асинхронный** — ставится в очередь воркера с автоматическими повторами — но может перейти к синхронному выполнению с `shouldRunSynchronously: true`. См. аккордеон `definePostInstallLogicFunction` выше о том, когда использовать каждый режим.--**Используйте `post-install` для всего, что требует наличия новой схемы.** Это распространённый случай:--* Наполнение данными по умолчанию (создание начальных записей, стандартных представлений, демонстрационного контента) для недавно добавленных объектов и полей.-* Регистрация вебхуков в сторонних сервисах теперь, когда у приложения уже есть учётные данные.-* Вызов вашего собственного API для завершения настройки, зависящей от синхронизированных метаданных.-* Идемпотентная логика «убедиться, что это существует», которая должна приводить состояние в соответствие при каждом обновлении — совместите с `shouldRunOnVersionUpgrade: true`.+<AccordionGroup>+<Accordion title="definePostInstallLogicFunction" description="Выполняется после применения миграции метаданных рабочего пространства">-Пример — создать запись `PostCard` по умолчанию после установки:+Запускается после завершения установки приложения: метаданные синхронизированы, SDK-клиент сгенерирован, новая схема доступна для запросов. Пример — инициализировать запись по умолчанию при новой установке:```ts src/logic-functions/post-install.tsimport { definePostInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';-import { createClient } from './generated/client';+import { CoreApiClient } from 'twenty-client-sdk/core';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!' },+ const client = new CoreApiClient();+ await client.mutation({+ createPostCard: {+ __args: { data: { name: 'Welcome to Postcard', content: 'Your first card!' } },+ id: true,+ },});};@@ -133,22 +81,28 @@ export default definePostInstallLogicFunction({description: 'Seeds a welcome post card after install.',timeoutSeconds: 300,shouldRunOnVersionUpgrade: false,+ shouldRunSynchronously: false,handler,});```-**Используйте `pre-install`, когда миграция в противном случае уничтожит или повредит существующие данные.** Поскольку pre-install работает с *предыдущей* схемой и при сбое откатывает обновление, это правильное место для всего рискованного:+Флаг `shouldRunSynchronously` управляет моделью выполнения:++* `false` *(по умолчанию)* — ставится в очередь сообщений (`retryLimit: 3`) и выполняется воркером. Ответ установки возвращается, как только задача поставлена в очередь. **Используйте для длительных операций** — инициализация больших наборов данных, медленные сторонние API.+* `true` — выполняется непосредственно в процессе установки. Запрос на установку блокируется до завершения обработчика; выброшенная ошибка возвращается вызывающей стороне как `POST_INSTALL_ERROR` (без повторных попыток). **Используйте для быстрых операций, которые обязательно должны завершиться до ответа.** На этом этапе миграция уже применена, поэтому сбой не откатывает изменения схемы — он только сообщает об ошибке.++</Accordion>+<Accordion title="definePreInstallLogicFunction" description="Выполняется до применения миграции метаданных рабочего пространства">-* **Резервное копирование данных, которые будут удалены или реструктурированы** — например, вы удаляете поле в v2 и вам нужно скопировать его значения в другое поле или экспортировать их в хранилище до запуска миграции.-* **Архивирование записей, которые новое ограничение сделает недопустимыми** — например, поле становится `NOT NULL`, и вам сначала нужно удалить или исправить строки со значениями null.-* **Проверка совместимости и отказ от обновления, если текущие данные нельзя корректно мигрировать** — выбросьте исключение из обработчика, и установка прервётся без внесения изменений. Это безопаснее, чем обнаружить несовместимость в середине миграции.-* **Переименование или изменение ключей данных** перед изменением схемы, которое привело бы к потере связи.+Запускается до миграции метаданных, в контексте **предыдущей** схемы — подходящее место, чтобы создать резервную копию данных, которые были бы потеряны при миграции, или отклонить рискованное обновление. Перед выполнением сервер запускает чисто добавочную «урезанную синхронизацию», которая регистрирует только pre-install функцию новой версии; всё остальное — объекты, поля и данные предыдущей версии — остаётся нетронутым во время выполнения вашего обработчика.-Пример — архивировать записи перед разрушительной миграцией:+Pre-install всегда **синхронный** и блокирует установку. Если обработчик генерирует исключение, установка прерывается до применения каких-либо изменений схемы — рабочее пространство остаётся на предыдущей версии в согласованном состоянии. Это сделано намеренно: pre-install — ваш последний шанс отказать в рискованном обновлении.++Пример — скопировать значения устаревшего поля перед тем, как миграция его удалит:```ts src/logic-functions/pre-install.tsimport { definePreInstallLogicFunction, type InstallPayload } from 'twenty-sdk/define';-import { createClient } from './generated/client';+import { CoreApiClient } from 'twenty-client-sdk/core';const handler = async ({ previousVersion, newVersion }: InstallPayload): Promise<void> => {// Only the 1.x → 2.x upgrade drops the legacy `notes` field.@@ -156,24 +110,24 @@ const handler = async ({ previousVersion, newVersion }: InstallPayload): Promisereturn;}- const client = createClient();- const legacyRecords = await client.postCard.findMany({- where: { notes: { isNotNull: true } },+ const client = new CoreApiClient();+ const { postCards } = await client.query({+ postCards: {+ __args: { filter: { notes: { isNot: null } } },+ edges: { node: { id: true, notes: 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 },- }),- ),- );+ // Copy legacy `notes` into `description` before the migration drops the+ // column. If this fails, the upgrade aborts and the workspace stays on v1.+ for (const { node } of postCards.edges) {+ await client.mutation({+ updatePostCard: {+ __args: { id: node.id, data: { description: node.notes } },+ id: true,+ },+ });+ }};export default definePreInstallLogicFunction({@@ -186,21 +140,49 @@ export default definePreInstallLogicFunction({});```-**Общее правило:**+</Accordion>+</AccordionGroup>-| Вы хотите... | Использовать |-| ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |-| Наполнить данными по умолчанию, настроить рабочее пространство, зарегистрировать внешние ресурсы | `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**. Обращайтесь к pre-install только тогда, когда сама миграция разрушительна и вам нужно перехватить предыдущее состояние, прежде чем оно исчезнет.-</Note>+`defineUninstallLogicFunction` объявляет хук, который выполняется, когда пользователь удаляет ваше приложение. Он выполняется **до того**, как метаданные, данные и код приложения будут удалены — после запуска миграции удаления уже нечему будет выполняться — поэтому ваш обработчик все еще может запрашивать объекты и записи приложения. Используйте его для очистки внешних ресурсов: отмены выделения ресурсов API, удаления оставшихся ботов, отзыва вебхуков.-</Accordion>-</AccordionGroup>+Заметки:++* Хук работает по принципу «по возможности»: он выполняется синхронно, но сбой только логируется и **никогда не блокирует удаление** — очистка не должна делать удаление приложения невозможным.+* Он получает `UninstallPayload` (`{ version?: string }` — версия, которая удаляется).+* Он **не** выполняется при откате неуспешной новой установки — приложение так и не было полностью установлено.+* Хук не может выполниться после того, как приложение удалено, поэтому внешняя очистка, которая зависит от данных приложения (например, ID ботов, сохраненные в записях), должна выполняться здесь, а не во внешнем запланированном задании.+* Как и установочные хуки, он **не выполняется в режиме разработки** — вместо этого запустите его вручную:++```bash filename="Terminal"+yarn twenty dev:function:exec --uninstall+```++```ts src/logic-functions/uninstall.ts+import { defineUninstallLogicFunction, type UninstallPayload } from 'twenty-sdk/define';+import { CoreApiClient } from 'twenty-client-sdk/core';++const handler = async (_payload: UninstallPayload): Promise<void> => {+ const client = new CoreApiClient();+ const { meetingBots } = await client.query({+ meetingBots: { edges: { node: { id: true, externalBotId: true } } },+ });++ // Delete the provider-side bots so nothing keeps recording after uninstall.+ for (const { node } of meetingBots.edges) {+ await fetch(`https://api.recorder.example/bots/${node.externalBotId}`, {+ method: 'DELETE',+ headers: { Authorization: `Bearer ${process.env.RECORDER_API_KEY}` },+ });+ }+};++export default defineUninstallLogicFunction({+ universalIdentifier: 'b2c3d4e5-6789-01bc-def0-234567890abc',+ name: 'uninstall',+ description: 'Deletes remaining recorder bots when the app is uninstalled.',+ timeoutSeconds: 300,+ handler,+});+```diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/config/overview.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/config/overview.mdxindex 1fcd33b6574..fa9c8d3bb11 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/config/overview.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/config/overview.mdx@@ -23,6 +23,11 @@ icon: screwdriver-wrench└──────────────────────────────────┘┌──────────────────────────────────┐│ Post-install hook │ after metadata migration+ └──────────────────────────────────┘+ │+ ▼ (at uninstall time)+ ┌──────────────────────────────────┐+ │ Uninstall hook │ before app removal└──────────────────────────────────┘```@@ -36,7 +41,7 @@ icon: screwdriver-wrench`defineRole` — определите, что логические функции вашего приложения могут читать и записывать.</Card><Card title="Установочные хуки" icon="wrench" href="/l/ru/developers/extend/apps/config/install-hooks">- `definePreInstallLogicFunction` и `definePostInstallLogicFunction` — создавайте резервные копии данных, заполняйте значения по умолчанию, проверяйте обновления.+ `definePreInstallLogicFunction`, `definePostInstallLogicFunction` и `defineUninstallLogicFunction` — создавайте резервные копии данных, заполняйте значения по умолчанию, проверяйте обновления, выполняйте очистку при удалении.</Card></CardGroup>@@ -44,7 +49,7 @@ icon: screwdriver-wrench* **Приложение** — это точка входа. У каждого приложения есть ровно один вызов `defineApplication()`, и он указывает на одну **роль** по умолчанию.* **Роль** управляет тем, что логические функции и фронтенд‑компоненты приложения могут читать и записывать. Следуйте принципу наименьших привилегий: выдавайте только те разрешения, которые вашему коду действительно нужны.-* **Установочные хуки** запускаются при установке или обновлении — предустановочный до миграции метаданных (чтобы можно было отклонить рискованное обновление), постустановочный после миграции (чтобы можно было заполнить данные по умолчанию в соответствии с новой схемой).+* **Установочные хуки** запускаются при установке или обновлении — предустановочный до миграции метаданных (чтобы можно было отклонить рискованное обновление), постустановочный после миграции (чтобы можно было заполнить данные по умолчанию в соответствии с новой схемой). Хук удаления запускается непосредственно перед тем, как приложение будет удалено, поэтому он может очистить внешние ресурсы, пока данные приложения ещё доступны для чтения.<Note>Установочные хуки используют то же окружение выполнения, что и [логическая функция](/l/ru/developers/extend/apps/logic/logic-functions) — тот же формат обработчика, те же переменные окружения, тот же типизированный клиент API, — но объявляются через собственные функции `define` и находятся вне обычной модели триггеров (HTTP, cron, события базы данных).diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/config/public-assets.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/config/public-assets.mdxindex d4310442cec..e17649d3216 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/config/public-assets.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/config/public-assets.mdx@@ -11,7 +11,7 @@ icon: folder-open* **Публично доступными** — после синхронизации с сервером ресурсы доступны по публичному URL. Для доступа к ним аутентификация не требуется.* **Доступными в компонентах фронтенда** — используйте URL ресурсов для отображения изображений, значков или любого медиа внутри ваших компонентов React.* **Доступными в логических функциях** — используйте URL ресурсов в письмах, ответах API или любой серверной логике.-* **Используются для метаданных маркетплейса** — поля `logoUrl` и `screenshots` в `defineApplication()` ссылаются на файлы из этой папки (например, `public/logo.png`). Они отображаются в маркетплейсе при публикации вашего приложения.+* \*\*Используется для метаданных на marketplace — поля `logo` и `galleryImages` в файле `defineApplication()` из этой папки (например, `public/logo.png`). Они отображаются в маркетплейсе при публикации вашего приложения. Внешние абсолютные URL-адреса игнорируются для этих полей — вместо этого объединяйте изображения в `public/`. Каждое изображение не должно превышать 10 МБ.* **Автосинхронизация в режиме разработки** — когда вы добавляете, обновляете или удаляете файл в `public/`, он автоматически синхронизируется с сервером. Перезапуск не требуется.* **Включены в сборки** — `yarn twenty dev:build` упаковывает все публичные ресурсы в выходной дистрибутив.diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/config/roles.mdxindex 62dad55b7bc..3b3b5480e63 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/config/roles.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/config/roles.mdx@@ -202,4 +202,4 @@ export default 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).+* Смотрите рабочий пример: [`examples/hello-world/src/roles/default-role.ts`](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/examples/hello-world/src/roles/default-role.ts).diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/data/objects.mdxindex 0e2a71b5b1d..f8a68de75a1 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/data/objects.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/data/objects.mdx@@ -79,6 +79,7 @@ export default defineObject({* `universalIdentifier` должен быть уникальным и стабильным между развёртываниями.* Каждому полю требуются `name`, `type`, `label` и собственный стабильный `universalIdentifier`.* Массив `fields` необязателен — вы можете определять объекты без пользовательских полей.+* `openRecordIn` определяет, где открываются записи этого объекта при щелчке: `ObjectOpenRecordIn.USER_CHOICE` (по умолчанию, в соответствии с индивидуальными настройками каждого участника рабочего пространства в Settings → Experience), `ObjectOpenRecordIn.SIDE_PANEL` или `ObjectOpenRecordIn.RECORD_PAGE`. Закрепите его на `RECORD_PAGE` для записей, которым для полноценного использования нужна целая страница (как у рабочих процессов и дашбордов), или на `SIDE_PANEL` для записей, которые уместны только в виде быстрой боковой панели (как события календаря).* Встроенным полям, определённым здесь, **не** нужен `objectUniversalIdentifier` — он наследуется от родительского объекта. Используйте [`defineField()`](/l/ru/developers/extend/apps/data/extending-objects), чтобы добавить поля к объектам, которые вам не принадлежат.* Вы можете сгенерировать заготовки новых объектов с помощью `yarn twenty dev:add object`, который проведёт вас через настройку названий, полей и связей. См. [Architecture → Scaffolding entities](/l/ru/developers/extend/apps/getting-started/scaffolding).@@ -86,6 +87,22 @@ export default defineObject({**Базовые поля добавляются автоматически.** Когда вы определяете пользовательский объект, Twenty создаёт для вас стандартные поля, такие как `id`, `name`, `createdAt`, `updatedAt`, `createdBy`, `updatedBy` и `deletedAt`. Вам не нужно объявлять их в массиве `fields` — только ваши пользовательские поля. Вы можете переопределить базовое поле, объявив поле с тем же именем, но это редко бывает хорошей идеей.</Note>+## Типы полей++Полный набор значений `FieldType`, экспортируемых из `twenty-sdk/define`:++| Категория | Типы |+| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |+| Текст | `TEXT`, `RICH_TEXT`, `ARRAY` (строк), `RAW_JSON` |+| Числовые | `NUMBER` (`universalSettings.dataType`: `'float'` / `'int'` / `'bigint'`), `NUMERIC` (произвольная точность), `RATING`, `POSITION` |+| Даты | `DATE`, `DATE_TIME` |+| Выбор | `BOOLEAN`, `SELECT`, `MULTI_SELECT` |+| Составные | `FULL_NAME`, `ADDRESS`, `EMAILS`, `PHONES`, `LINKS`, `CURRENCY`, `ACTOR`, `FILES` |+| Идентификаторы и связи | `UUID`, `RELATION`, `MORPH_RELATION` (см. [Relations](/l/ru/developers/extend/apps/data/relations)) |+| Система | `TS_VECTOR` (вектор полнотекстового поиска, управляется сервером) |++Составные типы хранят несколько подполей (например, `FULL_NAME` = имя + фамилия; `CURRENCY` = `amountMicros` + `currencyCode`). `SELECT` и `MULTI_SELECT` требуют массива `options`, как в примере выше.+## Значения по умолчаниюСтроковые значения по умолчанию должны быть заключены в одинарные кавычки **внутри** строки — `defaultValue: "'Draft'"`, а не `defaultValue: "Draft"`. Именно поэтому поле `status` выше использует `` `'${PostCardStatus.DRAFT}'` ``.@@ -122,4 +139,4 @@ export default defineObject({* **Свяжите этот объект с другими** — см. [Relations](/l/ru/developers/extend/apps/data/relations) для двунаправленного шаблона связей.* **Добавляйте поля к объектам из других приложений** — см. [Extending Objects](/l/ru/developers/extend/apps/data/extending-objects) о `defineField()`.-* **Отобразите этот объект в интерфейсе** — см. [Views](/l/ru/developers/extend/apps/layout/views) и [Navigation Menu Items](/l/ru/developers/extend/apps/layout/navigation-menu-items), чтобы поместить его в боковую панель.+* **Отображать этот объект в интерфейсе** — см. [пункты меню навигации](/l/ru/developers/extend/apps/layout/navigation-menu-items), чтобы добавить пункт бокового меню; см. [представления](/l/ru/developers/extend/apps/layout/views), чтобы добавить пользовательские настройки списков.diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/data/system-fields.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/data/system-fields.mdxnew file mode 100644index 00000000000..4420abbd44a--- /dev/null+++ b/packages/twenty-docs/l/ru/developers/extend/apps/data/system-fields.mdx@@ -0,0 +1,211 @@+---+title: Обращение к системным метаданным+description: Определяйте детерминированные универсальные идентификаторы метаданных, которые Twenty автоматически подготавливает для каждого объекта, чтобы ваше приложение могло ссылаться на них без жёсткого кодирования.+icon: gears+---++Каждый объект в Twenty содержит **системные метаданные**, которые вы сами никогда не объявляете, например набор полей и основное представление списка с его столбцами. Сервер создаёт всё это при подготовке объекта, и этот набор растёт по мере развития Twenty.++Поскольку вы это не объявляете, у вас нет константы `universalIdentifier`, которую можно импортировать. Вместо этого сервер **выводит** каждый идентификатор детерминированным образом, а `twenty-sdk` предоставляет тот же механизм вывода, чтобы ваш манифест мог получить точное значение, которое использует сервер.++## Системные поля++Скалярные поля, присутствующие в каждом объекте, ни одно из которых вы не объявляете с помощью [`defineField()`](/l/ru/developers/extend/apps/data/extending-objects):++`id`, `createdAt`, `updatedAt`, `deletedAt`, `createdBy`, `updatedBy`, `position`, `searchVector`++Тогда как сослаться на `createdAt` как на столбец в [представлении](/l/ru/developers/extend/apps/layout/views)?++### Проблема++Начиная с Twenty 2.19, универсальный идентификатор системного поля **детерминированно выводится** сервером из трех входных данных: универсального идентификатора приложения, универсального идентификатора объекта и имени поля. Придумать id и захардкодить его не получится: он не соответствует ничему на сервере, и синхронизация отклоняет висящую ссылку:++```+Dev sync failed: viewField: INVALID_VIEW_DATA: Field metadata not found+```++### Решение++<Note>+ `getFieldUniversalIdentifier` доступен, начиная с `twenty-sdk` версии 2.21.+</Note>++Используйте `getFieldUniversalIdentifier`, чтобы получить в точности то же значение, которое использует сервер. Он принимает три входных параметра и возвращает универсальный идентификатор поля:++```ts+import { getFieldUniversalIdentifier } from 'twenty-sdk/define';++const createdAtFieldId = getFieldUniversalIdentifier({+ applicationUniversalIdentifier: APPLICATION_UNIVERSAL_IDENTIFIER,+ objectUniversalIdentifier: MY_OBJECT_UNIVERSAL_IDENTIFIER,+ name: 'createdAt',+});+```++* `applicationUniversalIdentifier` — это идентификатор вашего приложения, тот, который вы передаете в [`defineApplication()`](/l/ru/developers/extend/apps/config/application).+* `objectUniversalIdentifier` — это идентификатор объекта, к которому принадлежит поле.+* `name` — это имя системного поля, одно из значений, перечисленных выше.++### Пример: столбец createdAt в представлении++Типичный случай — добавление столбца `createdAt` в представление одного из ваших пользовательских объектов. Разрешите id поля и ссылайтесь на него так же, как на любой другой `fieldMetadataUniversalIdentifier`:++```ts src/views/example-view.ts+import {+ defineView,+ getFieldUniversalIdentifier,+} from 'twenty-sdk/define';++const APPLICATION_UNIVERSAL_IDENTIFIER =+ '0b04e15c-27b2-4741-9046-b32e07469072';+const MY_OBJECT_UNIVERSAL_IDENTIFIER =+ 'c782b61c-70fd-4c88-9cd6-4e61ab8d7591';++export default defineView({+ universalIdentifier: '70f10d44-144a-4da8-8c6f-3ec2422138c0',+ name: 'All records',+ objectUniversalIdentifier: MY_OBJECT_UNIVERSAL_IDENTIFIER,+ icon: 'IconList',+ position: 0,+ fields: [+ {+ universalIdentifier: '75a90bc4-d901-4df4-85e0-af29db5e0104',+ fieldMetadataUniversalIdentifier: getFieldUniversalIdentifier({+ applicationUniversalIdentifier: APPLICATION_UNIVERSAL_IDENTIFIER,+ objectUniversalIdentifier: MY_OBJECT_UNIVERSAL_IDENTIFIER,+ name: 'createdAt',+ }),+ position: 0,+ isVisible: true,+ size: 200,+ },+ ],+});+```++Тот же разрешенный id работает везде, где ожидается `fieldMetadataUniversalIdentifier`: поля представления, фильтры, сортировки, группировки и виджеты макета страницы.++<Note>+ Разрешайте id, не хардкодьте его. Поскольку сервер выводит значение из+ id приложения, id объекта и имени поля, вызов+ `getFieldUniversalIdentifier` сохраняет вашу ссылку корректной, даже если эти+ входные данные изменятся, и предотвращает расхождение, если способ вывода когда-нибудь изменится.+</Note>++### Системные поля связей++<Note>+ `getSystemRelationFieldUniversalIdentifier` доступен в `twenty-sdk`, начиная с версии 2.23, и требует сервер Twenty версии 2.23 или новее.+</Note>++Помимо перечисленных выше скалярных системных полей, сервер также подготавливает четыре **системных поля связей** для каждого объекта: `timelineActivities`, `attachments`, `noteTargets` и `taskTargets`, каждое из которых указывает на соответствующий стандартный объект связи.++Таким образом, эти поля не разрешаются с помощью `getFieldUniversalIdentifier`: их идентификатор выводится **безотносительно имени** из объекта, содержащего поле, и объекта, на который поле указывает. Таким образом, переименование объекта никогда не изменяет идентификаторы его полей связей.++Используйте `getSystemRelationFieldUniversalIdentifier`, чтобы разрешить их:++```ts+import {+ getSystemRelationFieldUniversalIdentifier,+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS,+} from 'twenty-sdk/define';++// rocket.attachments — the relation field hosted on your custom object+const rocketAttachmentsFieldId = getSystemRelationFieldUniversalIdentifier({+ applicationUniversalIdentifier: APPLICATION_UNIVERSAL_IDENTIFIER,+ objectUniversalIdentifier: ROCKET_OBJECT_UNIVERSAL_IDENTIFIER,+ relationTargetObjectUniversalIdentifier:+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.attachment.universalIdentifier,+});+```++* `objectUniversalIdentifier` — это объект, **содержащий** поле.+* `relationTargetObjectUniversalIdentifier` — это объект, на который **указывает** поле.++Направление кодируется порядком аргументов. Чтобы получить обратную сторону (например, `attachment.targetRocket`, morph‑поле, которое сервер создаёт на стандартном объекте связи), поменяйте их местами:++```ts+// attachment.targetRocket — the reverse morph field on Attachment+const attachmentTargetRocketFieldId =+ getSystemRelationFieldUniversalIdentifier({+ applicationUniversalIdentifier: APPLICATION_UNIVERSAL_IDENTIFIER,+ objectUniversalIdentifier:+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.attachment.universalIdentifier,+ relationTargetObjectUniversalIdentifier: ROCKET_OBJECT_UNIVERSAL_IDENTIFIER,+ });+```++Как и в случае со скалярными системными полями, разрешённый id работает везде, где ожидается `fieldMetadataUniversalIdentifier`.++## Системные представления++<Note>+ `getSystemViewUniversalIdentifier` и `getSystemViewFieldUniversalIdentifier`+ доступны в `twenty-sdk`, начиная с версии 2.26, и требуют сервер Twenty+ версии 2.26 или новее.+</Note>++Сервер также подготавливает **системное представление** для каждого объекта: основное представление списка (`All {objectLabelPlural}`, с ключом `ViewKey.INDEX` (полученным с помощью `SYSTEM_VIEW_KEYS.INDEX`)), с одним столбцом на каждое отображаемое поле. Как и у системных полей связей, их идентификаторы выводятся **без использования имён**, поэтому переименование объекта или поля никогда их не меняет.++Используйте `getSystemViewUniversalIdentifier`, чтобы получить идентификатор представления:++```ts+import {+ getSystemViewUniversalIdentifier,+ SYSTEM_VIEW_KEYS,+} from 'twenty-sdk/define';++const rocketIndexViewId = getSystemViewUniversalIdentifier({+ objectMetadataApplicationUniversalIdentifier: APPLICATION_UNIVERSAL_IDENTIFIER,+ objectUniversalIdentifier: ROCKET_OBJECT_UNIVERSAL_IDENTIFIER,+ viewKey: SYSTEM_VIEW_KEYS.INDEX,+});+```++* `objectMetadataApplicationUniversalIdentifier` — это приложение, которому принадлежит **объект**, и именно по нему задаётся пространство имён представления.+* `objectUniversalIdentifier` — это объект, который отображается в представлении.+* `viewKey` — это дискриминатор системного представления: `SYSTEM_VIEW_KEYS.INDEX` для основного представления списка, `SYSTEM_VIEW_KEYS.FIELDS_WIDGET` для представления виджета полей на странице записи. Он определяет способ вычисления представления; только `INDEX` также сохраняется в строке представления.++Полученный идентификатор подходит везде, где ожидается `viewUniversalIdentifier`, например для пункта боковой панели [`NavigationMenuItemType.VIEW`](/l/ru/developers/extend/apps/layout/navigation-menu-items). Чтобы просто открыть основной список объекта, предпочитайте `NavigationMenuItemType.OBJECT` с `targetObjectUniversalIdentifier`: здесь не нужен вывод идентификатора.++`getSystemViewFieldUniversalIdentifier` определяет идентификатор одного **столбца** в системном представлении по самому представлению и отображаемому в нём полю:++```ts+import { getSystemViewFieldUniversalIdentifier } from 'twenty-sdk/define';++const rocketNameColumnId = getSystemViewFieldUniversalIdentifier({+ fieldMetadataApplicationUniversalIdentifier: APPLICATION_UNIVERSAL_IDENTIFIER,+ viewUniversalIdentifier: rocketIndexViewId,+ fieldMetadataUniversalIdentifier: ROCKET_NAME_FIELD_UNIVERSAL_IDENTIFIER,+});+```++Обратите внимание на первый аргумент: пространство имён столбца задаётся приложением, которому принадлежит **поле, отображаемое в нём**, а не приложением, которому принадлежит представление. Поле, которое ваше приложение добавляет к стандартному объекту, получает свой столбец, выводимый в пространстве имён вашего приложения, на представлении, принадлежащем Twenty.++<Warning>+ Системные представления и их столбцы **принадлежат серверу**: разрешайте их идентификаторы, чтобы ссылаться на них, но никогда не объявляйте их сами. `key` в+ [`defineView()`](/l/ru/developers/extend/apps/layout/views) устарел и+ игнорируется, поэтому представление из манифеста никогда не может заявить ключ `INDEX`, а сервер уже подготавливает столбец для каждого добавленного вами поля, так что объявление собственного+ `defineViewField()` для того же поля в системном представлении конфликтует с ним.+</Warning>++## Стандартные объекты Twenty++Для **стандартного** объекта Twenty (Person, Company, Opportunity, …) вам не нужно ничего выводить: идентификаторы как полей, так и представлений — это заранее вычисленные константы, которые вы можете импортировать напрямую.++```ts+import { STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS } from 'twenty-sdk/define';++// STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.fields.createdAt.universalIdentifier+// STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.fields.updatedAt.universalIdentifier+// STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.views.allPeople.universalIdentifier+```++Используйте указанные выше вспомогательные функции, когда объект — это объект, который **ваше приложение** определяет с помощью [`defineObject()`](/l/ru/developers/extend/apps/data/objects), где такой константы не существует.++<Note>+ `name` — это **поле по умолчанию**, а не системное поле. У него есть собственный захардкоженный+ универсальный идентификатор, и он не разрешается через+ `getFieldUniversalIdentifier`. В определяемых вами объектах ссылайтесь на поле+ `name` по идентификатору, который вы задали ему в `defineObject()`.+</Note>diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/concepts.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/concepts.mdxindex 4ce03674161..a983d4e8a99 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/concepts.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/concepts.mdx@@ -34,22 +34,23 @@ your-app/## Типы сущностей-| Сущность | Назначение | Документация |-| ------------------------- | ------------------------------------------------------- | ------------------------------------------------------------------------------- |-| **Приложение** | Идентификация приложения, роль по умолчанию, переменные | [Конфигурация приложения](/l/ru/developers/extend/apps/config/application) |-| **Роль** | Наборы прав для объектов и полей | [Роли и разрешения](/l/ru/developers/extend/apps/config/roles) |-| **Объект** | Пользовательские типы записей с полями | [Объекты](/l/ru/developers/extend/apps/data/objects) |-| **Поле** | Добавляйте поля к объектам из других приложений | [Расширение объектов](/l/ru/developers/extend/apps/data/extending-objects) |-| **Связь** | Двунаправленные связи между объектами | [Связи](/l/ru/developers/extend/apps/data/relations) |-| **Логическая функция** | Серверный TypeScript с триггерами | [Логические функции](/l/ru/developers/extend/apps/logic/logic-functions) |-| **Навык** | Повторно используемые инструкции для ИИ-агента | [Навыки и агенты](/l/ru/developers/extend/apps/logic/skills-and-agents) |-| **Агент** | ИИ-агенты с пользовательскими промптами | [Навыки и агенты](/l/ru/developers/extend/apps/logic/skills-and-agents) |-| **Провайдер подключения** | Учётные данные OAuth для сторонних API | [Подключения](/l/ru/developers/extend/apps/logic/connections) |-| **Представление** | Преднастроенные представления списков записей | [Представления](/l/ru/developers/extend/apps/layout/views) |-| **Пункт меню навигации** | Пользовательские элементы боковой панели | [Элементы меню навигации](/l/ru/developers/extend/apps/layout/navigation-menu-items) |-| **Макет страницы** | Вкладки и виджеты на странице сведений о записи | [Макеты страниц](/l/ru/developers/extend/apps/layout/page-layouts) |-| **Компонент фронтенда** | Изолированный в песочнице интерфейс React внутри Twenty | [Компоненты фронтенда](/l/ru/developers/extend/apps/layout/front-components) |-| **Элемент меню команд** | Быстрые действия и элементы Cmd+K | [Элементы меню команд](/l/ru/developers/extend/apps/layout/command-menu-items) |+| Сущность | Назначение | Документация |+| ------------------------- | -------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |+| **Приложение** | Идентификация приложения, роль по умолчанию, переменные | [Конфигурация приложения](/l/ru/developers/extend/apps/config/application) |+| **Роль** | Наборы прав для объектов и полей | [Роли и разрешения](/l/ru/developers/extend/apps/config/roles) |+| **Объект** | Пользовательские типы записей с полями | [Объекты](/l/ru/developers/extend/apps/data/objects) |+| **Поле** | Добавляйте поля к объектам из других приложений | [Расширение объектов](/l/ru/developers/extend/apps/data/extending-objects) |+| **Связь** | Двунаправленные связи между объектами | [Связи](/l/ru/developers/extend/apps/data/relations) |+| **Логическая функция** | Серверный TypeScript с триггерами | [Логические функции](/l/ru/developers/extend/apps/logic/logic-functions) |+| **Навык** | Повторно используемые инструкции для ИИ-агента | [Навыки и агенты](/l/ru/developers/extend/apps/logic/skills-and-agents) |+| **Агент** | ИИ-агенты с пользовательскими промптами | [Навыки и агенты](/l/ru/developers/extend/apps/logic/skills-and-agents) |+| **Провайдер подключения** | Учётные данные OAuth для сторонних API | [Подключения](/l/ru/developers/extend/apps/logic/connections) |+| **Представление** | Преднастроенные представления списков записей | [Представления](/l/ru/developers/extend/apps/layout/views) |+| **Пункт меню навигации** | Пользовательские элементы боковой панели | [Элементы меню навигации](/l/ru/developers/extend/apps/layout/navigation-menu-items) |+| **Макет страницы** | Вкладки и виджеты на странице сведений о записи | [Макеты страниц](/l/ru/developers/extend/apps/layout/page-layouts) |+| **Компонент фронтенда** | Изолированный в песочнице интерфейс React внутри Twenty | [Компоненты фронтенда](/l/ru/developers/extend/apps/layout/front-components) |+| **Общие зависимости** | Зависимости, общие для фронтенд-компонентов приложения, указанные в package.json | [Общие зависимости](/l/ru/developers/extend/apps/layout/front-components#sharing-dependencies-across-front-components) |+| **Элемент меню команд** | Быстрые действия и элементы Cmd+K | [Элементы меню команд](/l/ru/developers/extend/apps/layout/command-menu-items) |## Изоляция в песочнице@@ -69,7 +70,7 @@ your-app/├─────────────────────────────────────────────────────────┤│ Install flow ││ upload → [pre-install] → metadata migration → │-│ generate SDK → [post-install] │+│ generate SDK → [post-install] → … → [uninstall] │├─────────────────────────────────────────────────────────┤│ Publish ││ npm publish → appears in Twenty marketplace │@@ -78,13 +79,13 @@ your-app/* **`yarn twenty dev`** — следит за исходными файлами и синхронизирует изменения в реальном времени с подключённым сервером Twenty. Типизированный клиент API автоматически пересоздаётся при изменении схемы.* **`yarn twenty dev:build`** — компилирует TypeScript, упаковывает логические функции и фронтенд-компоненты с помощью esbuild и формирует манифест.-* **Хуки до/после установки** — необязательные функции, которые выполняются во время установки. См. раздел [Install Hooks](/l/ru/developers/extend/apps/config/install-hooks) для подробностей.+* **Хуки до/после установки и удаления** — необязательные функции, которые выполняются во время установки или непосредственно перед удалением. См. раздел [Install Hooks](/l/ru/developers/extend/apps/config/install-hooks) для подробностей.## Следующие шаги<CardGroup cols={2}><Card title="Конфигурация" icon="screwdriver-wrench" href="/l/ru/developers/extend/apps/config/overview">- Идентификация приложения, роль по умолчанию и хуки установки.+ Идентификация приложения, роль по умолчанию, а также хуки установки и удаления.</Card><Card title="Данные" icon="database" href="/l/ru/developers/extend/apps/data/overview">Объекты, поля и двунаправленные связи.diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/project-structure.mdxindex 218f0a61582..aa07847efab 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/project-structure.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/project-structure.mdx@@ -14,26 +14,41 @@ my-twenty-app/default-role.ts # Permissions for logic functionsconstants/universal-identifiers.ts # Auto-generated UUIDs and metadata+ front-components/+ main-page.tsx # Welcome page component+ navigation-menu-items/+ main-page.navigation-menu-item.ts # Sidebar entry for the welcome page+ page-layouts/+ main-page.page-layout.ts # Standalone page hosting the component__tests__/- setup-test.ts- app-install.integration-test.ts- .github/workflows/ci.yml # GitHub Actions- public/ # Static assets- vitest.config.ts # Test runner config+ application-config.test.ts # Unit test+ global-setup.ts # Integration test setup (sync + uninstall)+ schema.integration-test.ts # Integration test against a live server+ .github/workflows/+ ci.yml # Lint, typecheck, unit + integration tests+ cd.yml # Deploy + install on push to main+ publish.yml # Publish to npm on version tags (with provenance)+ public/+ logo.svg # Static assets+ vitest.config.ts # Integration test runner config+ vitest.unit.config.ts # Unit test runner configtsconfig.json, tsconfig.spec.json.nvmrc, .yarnrc.yml, .oxlintrc.json- README.md, LLMS.md+ README.md, AGENTS.md, CLAUDE.md, CHANGELOG.md, SETUP.md```## Ключевые файлы-| Файл / Папка | Назначение |-| ---------------------------------------- | ------------------------------------------------------------------------------------ |-| `src/application-config.ts` | **Обязательно.** Основной файл конфигурации для вашего приложения. |-| `src/default-role.ts` | Роль по умолчанию, контролирующая, к чему имеют доступ ваши логические функции. |-| `src/constants/universal-identifiers.ts` | Автоматически генерируемые UUID и метаданные (отображаемое имя, описание). |-| `src/__tests__/` | Интеграционные тесты (настройка + пример теста). |-| `public/` | Статические ресурсы (изображения, шрифты), обслуживаемые вместе с вашим приложением. |+| Файл / Папка | Назначение |+| -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |+| `src/application-config.ts` | **Обязательно.** Основной файл конфигурации для вашего приложения. |+| `src/default-role.ts` | Роль по умолчанию, контролирующая, к чему имеют доступ ваши логические функции. |+| `src/constants/universal-identifiers.ts` | Автоматически генерируемые UUID и метаданные (отображаемое имя, описание). |+| `src/front-components/`, `src/navigation-menu-items/`, `src/page-layouts/` | Стартовая приветственная страница: фронтенд-компонент, отображаемый отдельным макетом страницы и доступный из боковой панели. |+| `src/__tests__/` | Модульный тест плюс интеграционный тест (с его глобальной настройкой), которые синхронизируют приложение с реальным сервером. |+| `public/` | Статические ресурсы (изображения, шрифты), обслуживаемые вместе с вашим приложением. |+| `AGENTS.md` / `CLAUDE.md` | Руководство для ИИ-агентов, пишущих код для приложения. |+| `CHANGELOG.md` / `SETUP.md` | Журнал значимых изменений и инструкции по настройке для локальной разработки. |<Note>**Организация файлов — на ваше усмотрение.** Приведенные выше папки являются соглашениями — SDK обнаруживает сущности с помощью AST-анализа вызовов `export default defineEntity(...)` независимо от того, где расположен файл.@@ -47,15 +62,18 @@ my-twenty-app/{"dependencies": {},"devDependencies": {- "twenty-client-sdk": "^2.13.0",- "twenty-sdk": "^2.13.0"+ "twenty-client-sdk": "2.20.0",+ "twenty-sdk": "2.20.0",+ "twenty-ui": "1.0.0-alpha.1"}}```+Генератор заготовок фиксирует версии `twenty-sdk` и `twenty-client-sdk` на своей собственной версии — сохраняйте их синхронизацию при обновлении.+* **`twenty-sdk`** поставляет `twenty` CLI и инструменты сборки/скэффолдинга. Он выполняется только на этапах разработки и сборки и никогда не импортируется во время выполнения опубликованного приложения.* **`twenty-client-sdk`** *действительно* импортируется кодом вашего приложения (`CoreApiClient`, `MetadataApiClient`, `RestApiClient`), но Twenty предоставляет его во время выполнения — функции логики получают его из сгенерированного слоя SDK, а фронтенд‑компоненты получают его из модулей, отдаваемых сервером. Установленная вами копия используется только для проверки типов и сборки на этапе деплоя, поэтому её не нужно включать в развертываемый бандл.-Если любой из пакетов находится в `dependencies`, он попадает в бандл среды выполнения установленного приложения, где он является лишним грузом. `twenty build` выдаёт предупреждение, если любой из них всё ещё указан в `dependencies`.+Если любой из пакетов находится в `dependencies`, он попадает в бандл среды выполнения установленного приложения, где он является лишним грузом. `twenty dev:build` выдаёт предупреждение, если любой из них всё ещё указан в `dependencies`.-Добавляйте собственные зависимости среды выполнения вашего приложения (библиотеки, которые ваши функции логики действительно импортируют во время выполнения) в `dependencies`, как обычно.+Добавляйте собственные зависимости среды выполнения вашего приложения (библиотеки, которые ваши функции логики действительно импортируют во время выполнения) в `dependencies`, как обычно. Держите дерево лёгким: `dependencies` устанавливаются в слой выполнения с ограничением 250 МБ в распакованном виде, и операция синхронизации или установки завершается ошибкой размера зависимостей при превышении этого лимита — UI-библиотеки и инструменты разработки должны находиться в `devDependencies`.diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/quick-start.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/quick-start.mdxindex 151bab193fc..7591a455496 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/quick-start.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/quick-start.mdx@@ -6,17 +6,17 @@ description: Создайте своё первое приложение Twenty## Требования-* **Node.js 24+** — [Скачать здесь](https://nodejs.org/)+* **Node.js 24.5+** — [Скачать здесь](https://nodejs.org/)* **Yarn 4** — поставляется вместе с Node.js через Corepack. Включите его, выполнив `corepack enable`* **Docker** — [Скачать здесь](https://www.docker.com/products/docker-desktop/). Требуется для запуска локального экземпляра Twenty. Пропустите, если у вас уже запущен Twenty в другом месте.Создание приложения Twenty включает три фазы. Генератор каркаса объединяет их в одну команду для идеального сценария (happy path), но каждая фаза — отдельная концепция: когда что-то идёт не так, понимание того, на какой фазе вы находитесь, подскажет, что исправить.-| Фаза | Что вы делаете | Инструмент | Результат |-| ----------------------- | ------------------------------------------------- | ----------------------------- | -------------------------------------- |-| **1. Создание каркаса** | Сгенерировать исходный код приложения | `npx create-twenty-app` | Проект TypeScript на диске |-| **2. Запустить сервер** | Запустить сервер Twenty для синхронизации | Docker + `yarn twenty server` | Запущенный экземпляр Twenty |-| **3. Синхронизация** | Синхронизируйте код с сервером в реальном времени | `yarn twenty dev` | Ваши изменения появляются в интерфейсе |+| Фаза | Что вы делаете | Инструмент | Результат |+| ----------------------- | ------------------------------------------------- | ----------------------------------- | -------------------------------------- |+| **1. Создание каркаса** | Сгенерировать исходный код приложения | `npx create-twenty-app` | Проект TypeScript на диске |+| **2. Запустить сервер** | Запустить сервер Twenty для синхронизации | Docker + `yarn twenty docker:start` | Запущенный экземпляр Twenty |+| **3. Синхронизация** | Синхронизируйте код с сервером в реальном времени | `yarn twenty dev` | Ваши изменения появляются в интерфейсе |---@@ -28,7 +28,7 @@ description: Создайте своё первое приложение Twentynpx create-twenty-app@latest my-twenty-app```-Вам будет предложено ввести имя и описание — нажмите **Enter**, чтобы принять значения по умолчанию. Это создаст проект TypeScript в `my-twenty-app/` с начальным файлом `application-config.ts`, ролью по умолчанию, рабочим процессом CI и интеграционным тестом.+Генератор работает в неинтерактивном режиме: имя каталога становится именем приложения. Передайте `--display-name` и `--description`, чтобы настроить создаваемые метаданные (вы также можете отредактировать их позже в `src/constants/universal-identifiers.ts`). Это создаёт проект TypeScript в `my-twenty-app/` с начальным файлом `application-config.ts`, ролью по умолчанию, рабочими процессами CI/CD и интеграционным тестом.**После этой фазы:** у вас есть исходный код приложения на вашем компьютере. Он ещё не запущен — это фаза 2.@@ -38,28 +38,14 @@ npx create-twenty-app@latest my-twenty-appВашему приложению нужен сервер Twenty для синхронизации. Сервер — это полноценный экземпляр Twenty — UI, GraphQL API, PostgreSQL — работающий локально в Docker. Ваш локальный код загружает свои определения на этот сервер, благодаря чему они появляются в интерфейсе.-Генератор каркаса предложит запустить его за вас:+Генератор запускает её за вас: при запущенном Docker он скачивает образ `twentycrm/twenty-app-dev`, запускает его на порту `2020` и аутентифицирует CLI в предварительно заполненном демо‑workspace (`[email protected]`) — вход не требуется.-> **Хотите настроить локальный экземпляр 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]`+Чтобы вместо этого подключиться к существующему серверу Twenty, передайте `--url \<your-server-url>`. Удалённые серверы аутентифицируются через OAuth: открывается браузер, чтобы вы могли войти в систему и нажать **Authorize**, после чего CLI получает доступ к вашему workspace. (Локально вы тоже можете включить OAuth с помощью `--authentication-method oauth` — войдите, используя `[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>@@ -117,28 +103,32 @@ yarn twenty dev### Разовая синхронизация для CI и скриптов-Передайте `--once`, чтобы выполнить одну сборку и синхронизацию и завершить работу — тот же конвейер, без наблюдателя:+Используйте `plan` и `apply`, чтобы один раз запустить тот же конвейер без наблюдателя:```bash filename="Terminal"-yarn twenty dev --once+yarn twenty plan # preview the metadata changes without applying them+yarn twenty apply # show the plan, then apply it```-| Команда | Поведение | Когда использовать |-| ---------------------------------- | ----------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |-| `yarn twenty dev` | Отслеживает и повторно синхронизирует при каждом изменении. Продолжает работать, пока вы его не остановите. | Интерактивная локальная разработка. |-| `yarn twenty dev --once` | Одна сборка и синхронизация, завершает работу с кодом `0` при успехе и `1` при ошибке. | CI, хуки pre-commit, AI-агенты, скриптовые рабочие процессы. |-| `yarn twenty dev --once --dry-run` | Создает и выводит изменения метаданных **без их применения**. | Проверка того, какие изменения внесет синхронизация, прежде чем зафиксировать их. |+| Команда | Поведение | Когда использовать |+| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |+| `yarn twenty dev` | Отслеживает и повторно синхронизирует при каждом изменении. Продолжает работать, пока вы его не остановите. | Интерактивная локальная разработка. |+| `yarn twenty apply` | Одна сборка и синхронизация, завершает работу с кодом `0` при успехе и `1` при ошибке. Запрашивает подтверждение при разрушительных изменениях (передайте `--force`, чтобы пропустить). | CI, хуки pre-commit, AI-агенты, скриптовые рабочие процессы. |+| `yarn twenty plan` | Создает и выводит изменения метаданных **без их применения**. | Проверка того, какие изменения внесет синхронизация, прежде чем зафиксировать их. |++Все режимы требуют аутентифицированного удалённого сервера. Смотрите раздел [Syncing & recovery](/l/ru/developers/extend/apps/operations/sync-and-recovery#previewing-changes-plan) для получения дополнительной информации о `plan`.-Оба режима требуют аутентифицированного удалённого репозитория. Смотрите раздел [Syncing & recovery](/l/ru/developers/extend/apps/operations/sync-and-recovery#previewing-changes-dry-run) для получения дополнительной информации о `--dry-run`.+<Note>+`yarn twenty dev --once` и `yarn twenty dev --once --dry-run` являются устаревшими псевдонимами для `yarn twenty apply` и `yarn twenty plan`.+</Note>### Параметры режима разработки-| Флаг | Описание |-| ------------------------------------- | ----------------------------------------------------------------------------------------------- |-| `--once` | Выполнить сборку и синхронизацию один раз, затем завершить работу. |-| `--dry-run` | С опцией `--once` можно просмотреть изменения метаданных, не применяя их. Ничего не записывает. |-| `--debounceMs \<ms>` | Установить задержку дебаунса изменений файлов в миллисекундах (по умолчанию: `2000`). |-| `--verbose` / `--debug` | Показывать подробные журналы сборки, запросы синхронизации и трассировки ошибок. |+| Флаг | Описание |+| ------------------------------------- | ------------------------------------------------------------------------------------- |+| `--force` | Применяет разрушительные изменения (удаления) без подтверждения. |+| `--debounceMs \<ms>` | Установить задержку дебаунса изменений файлов в миллисекундах (по умолчанию: `1000`). |+| `--verbose` / `--debug` | Показывать подробные журналы сборки, запросы синхронизации и трассировки ошибок. |## Что вы можете создать@@ -159,7 +149,7 @@ yarn twenty dev --once<CardGroup cols={2}><Card title="Конфигурация" icon="screwdriver-wrench" href="/l/ru/developers/extend/apps/config/overview">- Идентификация приложения, роль по умолчанию, хуки установки, публичные ресурсы.+ Идентификация приложения, роль по умолчанию, хуки установки и удаления, публичные ресурсы.</Card><Card title="Данные" icon="database" href="/l/ru/developers/extend/apps/data/overview">Объекты, поля и двунаправленные связи.diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/scaffolding.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/scaffolding.mdxindex a217ebc3692..be5c8f2dac6 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/scaffolding.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/scaffolding.mdx@@ -22,18 +22,22 @@ 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` | `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 pageLayoutTab` | `src/page-layout-tabs/\<name>.ts` |+| Элемент меню команд | `yarn twenty dev:add commandMenuItem` | `src/command-menu-items/\<name>.ts` |+| Поле представления | `yarn twenty dev:add viewField` | `src/view-fields/\<name>.ts` |+| Провайдер подключения | `yarn twenty dev:add connectionProvider` | `src/connection-providers/\<name>.ts` |## Что генерирует скэффолдерdiff --git a/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/troubleshooting.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/troubleshooting.mdxindex e93b06c639c..f0b6080e19f 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/troubleshooting.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/troubleshooting.mdx@@ -5,10 +5,10 @@ icon: wrench---* **Ошибки Docker** — убедитесь, что Docker Desktop (или демон) запущен перед выполнением `yarn twenty docker:start`. Сообщение об ошибке укажет правильную команду запуска для вашей ОС.-* **Неподходящая версия Node** — нужна 24+. Проверьте с помощью `node -v`.+* **Неверная версия Node** — требуется 24.5+ (`engines.node: ^24.5.0`). Проверьте с помощью `node -v`.* **Отсутствует Yarn 4** — выполните `corepack enable`.* **Зависимости повреждены** — `rm -rf node_modules && yarn install`.* **Ошибки `twenty-sdk` после обновления до v2.8.0** — он был перенесен из `dependencies` в `devDependencies` в v2.8.0. См. [Структура проекта → Зависимости](/l/ru/developers/extend/apps/getting-started/project-structure#dependencies).-* **`twenty build` предупреждает о `twenty-client-sdk` в разделе `dependencies`** — он предоставляется Twenty во время выполнения, поэтому его следует перенести в `devDependencies` рядом с `twenty-sdk`. См. [Структура проекта → Зависимости](/l/ru/developers/extend/apps/getting-started/project-structure#dependencies).+* **`twenty dev:build` предупреждает о `twenty-client-sdk` в разделе `dependencies`** — он предоставляется Twenty во время выполнения, поэтому его следует перенести в `devDependencies` рядом с `twenty-sdk`. См. [Структура проекта → Зависимости](/l/ru/developers/extend/apps/getting-started/project-structure#dependencies).Застряли? Попросите помощи на [Discord-сервере Twenty](https://discord.com/channels/1130383047699738754/1130386664812982322).diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/layout/command-menu-items.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/layout/command-menu-items.mdxindex f491bbc310f..8b0f12ad5b5 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/layout/command-menu-items.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/layout/command-menu-items.mdx@@ -13,7 +13,6 @@ 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',@@ -22,51 +21,23 @@ export default defineCommandMenuItem({## Поля конфигурации-| Поле | Обязательно | Описание |-| --------------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |-| `universalIdentifier` | Да | Стабильный уникальный идентификатор для команды |-| `label` | Да | Полная метка, отображаемая в меню команд (Cmd+K) |-| `frontComponentUniversalIdentifier` | Да | `universalIdentifier` фронтенд-компонента, который открывается этой командой |-| `shortLabel` | Нет | Короткая метка, отображаемая на закреплённой кнопке быстрого действия |-| `icon` | Нет | Имя значка, отображаемое рядом с меткой (например, `'IconBolt'`, `'IconSend'`) |-| `isPinned` | Нет | При значении `true` показывает команду как кнопку быстрого действия в правом верхнем углу страницы |-| `availabilityType` | Нет | Определяет, где отображается команда: `'GLOBAL'` (доступна всегда), `'RECORD_SELECTION'` (только при выборе записей) или `'FALLBACK'` (показывается, когда другие команды не подходят) |-| `availabilityObjectUniversalIdentifier` | Нет | Ограничивает команду страницами определённого типа объектов (например, только для записей Company) |-| `conditionalAvailabilityExpression` | Нет | Логическое выражение, которое динамически управляет видимостью (см. ниже) |+| Поле | Обязательно | Описание |+| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |+| `universalIdentifier` | Да | Стабильный уникальный идентификатор для команды |+| `label` | Да | Полная метка, отображаемая в меню команд (Cmd+K) |+| `frontComponentUniversalIdentifier` | Да | `universalIdentifier` фронтенд-компонента, который открывается этой командой |+| `shortLabel` | Нет | Короткая метка, отображаемая на закреплённой кнопке быстрого действия |+| `icon` | Нет | **Устарело** — игнорируется в пользу значка приложения; при установке этого параметра сборка выводит предупреждение |+| `isPinned` | Нет | При значении `true` показывает команду как кнопку быстрого действия в правом верхнем углу страницы |+| `availabilityType` | Нет | Определяет, где отображается команда: `'GLOBAL'` (доступна всегда), `'GLOBAL_OBJECT_CONTEXT'` (только на страницах с объектным контекстом — индексные страницы и карточки записей), `'RECORD_SELECTION'` (только при выборе записей) или `'FALLBACK'` (показывается, когда другие команды не подходят) |+| `availabilityObjectUniversalIdentifier` | Нет | Ограничивает команду страницами определённого типа объектов (например, только для записей Company) |+| `conditionalAvailabilityExpression` | Нет | Логическое выражение, которое динамически управляет видимостью (см. ниже) |## Команды без интерфейсаЭлемент командного меню в паре с [фронтенд-компонентом без интерфейса](/l/ru/developers/extend/apps/layout/front-components#headless-vs-non-headless) — идиоматичный способ предоставить действие в один клик: выполнить код, перейти или подтвердить и выполнить. Страница Front Components описывает [SDK Command components](/l/ru/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,-});-```+Типичный сценарий: headless-компонент рендерит `<Command execute={...} />` (см. [полный пример](/l/ru/developers/extend/apps/layout/front-components#sdk-command-components)), и пункт меню команды указывает на него:```ts src/command-menu-items/run-action.command-menu-item.tsimport { defineCommandMenuItem } from 'twenty-sdk/define';@@ -74,7 +45,6 @@ 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',});```diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/layout/front-components.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/layout/front-components.mdxindex 31341b02986..6edc4166af2 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/layout/front-components.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/layout/front-components.mdx@@ -4,19 +4,25 @@ description: Создавайте компоненты React, которые оicon: window-maximize----Фронтенд-компоненты — это компоненты React, которые отображаются непосредственно внутри интерфейса Twenty. Они выполняются в изолированном Web Worker с использованием Remote DOM — ваш код изолирован (sandboxed), но рендерится нативно на странице, а не в iframe.+Фронтенд-компоненты — это компоненты React, которые отображаются непосредственно внутри интерфейса Twenty. Они выполняются в **изолированном Web Worker** с использованием Remote DOM — ваш код исполняется внутри изолированного iframe с непрозрачным источником (opaque-origin), но его UI всё равно нативно рендерится на странице, а не ограничивается этим iframe.++<Warning>+Конструкции передней части все еще активно развиваются. Ваш код запускается с частичным DOM, а не с реальной страницей браузера, так что использование расширенного кода может привести к ошибке, часто молчанию. См. [Текущие ограничения](#current-limitations).+</Warning>## Где можно использовать фронт-компоненты-Фронт-компоненты могут отображаться в двух местах внутри Twenty:+Фронт-компоненты могут отображаться в трёх местах внутри Twenty:* **Боковая панель** — фронт-компоненты с интерфейсом открываются в правой боковой панели. Это поведение по умолчанию, когда фронт-компонент запускается из меню команд.* **Виджеты (дашборды и страницы записей)** — фронт-компоненты можно встраивать как виджеты в [макеты страниц](/l/ru/developers/extend/apps/layout/page-layouts). При настройке дашборда или макета страницы записи пользователи могут добавить виджет фронт-компонента.+* **Настройки приложения (App settings)** — если определить фронт-компонент с помощью [`defineSettingsFrontComponent()`](#custom-settings-component), он будет отображаться как раздел на вкладке **Settings** приложения, заменяя стандартный интерфейс настройки переменных.-Сам по себе фронт-компонент недоступен из интерфейса — его нужно *сделать доступным*. Сделать это можно двумя способами:+Сам по себе фронт-компонент недоступен из интерфейса — его нужно *сделать доступным*. Сделать это можно тремя способами:* **Связать его с [элементом командного меню](/l/ru/developers/extend/apps/layout/command-menu-items)** — регистрирует его в командном меню (Cmd+K) и, при необходимости, как закреплённое быстрое действие.* **Встроить его как виджет в [макет страницы](/l/ru/developers/extend/apps/layout/page-layouts)** — размещает его на странице деталей записи или на дашборде.+* **Определить его с помощью [`defineSettingsFrontComponent()`](#custom-settings-component)** — отображает его как раздел на вкладке **Settings** приложения, заменяя стандартный интерфейс настройки переменных.## Простой пример@@ -49,14 +55,13 @@ 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`) быстрое действие появится в правом верхнем углу страницы:+После синхронизации с помощью `yarn twenty dev` (или однократного запуска `yarn twenty apply`) быстрое действие появится в правом верхнем углу страницы:<div style={{textAlign: 'center'}}><img src="/images/docs/developers/extends/apps/quick-action.png" alt="Кнопка быстрого действия в правом верхнем углу" />@@ -78,6 +83,34 @@ export default defineCommandMenuItem({Помимо команд, вы можете встроить фронт-компонент непосредственно на страницу записи, добавив его как виджет в **макет страницы**. См. [макеты страниц](/l/ru/developers/extend/apps/layout/page-layouts) для подробностей.+## Пользовательский компонент настроек++Чтобы заменить автоматически сгенерированный интерфейс настройки переменных на вкладке **Settings** вашего приложения собственным компонентом, определите его с помощью `defineSettingsFrontComponent` вместо `defineFrontComponent`. Он использует те же [поля конфигурации](#configuration-fields) (за исключением `isHeadless`, которое не принимается, поскольку компонент настроек всегда отрисовывает видимый интерфейс пользователя) и дополнительно помечает компонент как интерфейс настроек приложения.++Компонент отрисовывается как раздел **внутри** вкладки Settings, а не как замена всей вкладки. Управляемые системой Twenty разделы — автообновление, App URL и подключения — всегда отрисовываются над ним и не могут быть переопределены приложением.++```tsx src/front-components/app-settings.tsx+import { defineSettingsFrontComponent } from 'twenty-sdk/define';++const AppSettings = () => {+ return (+ <div style={{ padding: '20px' }}>+ <h2>My app settings</h2>+ {/* render your own configuration UI here */}+ </div>+ );+};++export default defineSettingsFrontComponent({+ universalIdentifier: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',+ name: 'app-settings',+ description: "Custom UI for the app's Settings tab",+ component: AppSettings,+});+```++Для каждого приложения допускается только один фронт-компонент настроек; объявление более одного приведет к ошибке сборки. Если он присутствует, вкладка **Settings** приложения отрисовывает этот компонент вместо стандартного интерфейса конфигурации переменных.+## Headless и non-headlessФронт-компоненты поддерживают два режима отображения, управляемых опцией `isHeadless`:@@ -88,11 +121,11 @@ export default defineCommandMenuItem({```tsx src/front-components/sync-tracker.tsximport { defineFrontComponent } from 'twenty-sdk/define';-import { useRecordId, enqueueSnackbar } from 'twenty-sdk/front-component';+import { useSelectedRecordIds, enqueueSnackbar } from 'twenty-sdk/front-component';import { useEffect } from 'react';const SyncTracker = () => {- const recordId = useRecordId();+ const [recordId] = useSelectedRecordIds();useEffect(() => {enqueueSnackbar({ message: `Tracking record ${recordId}`, variant: 'info' });@@ -116,19 +149,19 @@ export default defineFrontComponent({Пакет `twenty-sdk` предоставляет четыре вспомогательных компонента Command, предназначенных для headless фронт-компонентов. Каждый компонент выполняет действие при монтировании, обрабатывает ошибки, показывая уведомление snackbar, и автоматически размонтирует фронт-компонент по завершении.-Импортируйте их из `twenty-sdk/command`:+Импортируйте их из `twenty-sdk/front-component`:* **`Command`** — запускает асинхронный колбэк через проп `execute`.* **`CommandLink`** — переходит по пути внутри приложения. Пропы: `to`, `params`, `queryParams`, `options`.* **`CommandModal`** — открывает модальное окно подтверждения. Если пользователь подтвердит, выполняет колбэк `execute`. Пропы: `title`, `subtitle`, `execute`, `confirmButtonText`, `confirmButtonAccent`.-* **`CommandOpenSidePanelPage`** — открывает страницу боковой панели. Пропсы зависят от `page` — например, `ViewRecord` принимает `recordId` + `objectNameSingular`, другие страницы принимают `pageTitle` + `pageIcon`.+* **`CommandOpenSidePanelPage`** — открывает страницу боковой панели. Пропсы зависят от `page` — например, `ViewRecord` принимает `recordId` + `objectNameSingular` (а также необязательный id `tab`, чтобы открыть запись на определённой вкладке), другие страницы принимают `pageTitle` + `pageIcon`.Полный пример headless фронт-компонента, использующего `Command` для запуска действия из меню команд:```tsx src/front-components/run-action.tsximport { defineFrontComponent } from 'twenty-sdk/define';-import { Command } from 'twenty-sdk/command';-import { CoreApiClient } from 'twenty-sdk/clients';+import { Command } from 'twenty-sdk/front-component';+import { CoreApiClient } from 'twenty-client-sdk/core';const RunAction = () => {const execute = async () => {@@ -160,7 +193,6 @@ 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',});```@@ -169,7 +201,7 @@ export default defineCommandMenuItem({```tsx src/front-components/delete-draft.tsximport { defineFrontComponent } from 'twenty-sdk/define';-import { CommandModal } from 'twenty-sdk/command';+import { CommandModal } from 'twenty-sdk/front-component';const DeleteDraft = () => {const execute = async () => {@@ -196,33 +228,64 @@ export default defineFrontComponent({});```-## Вызов логической функции+И пример использования `CommandOpenSidePanelPage` для открытия текущей записи в боковой панели на определённой вкладке. `tab` — это id вкладки в макете страницы (в стандартных макетах используются id вроде `company-tab-emails` или `company-tab-timeline`; в пользовательских макетах используется собственный id вкладки). Если такого id нет в макете записи, откроется вкладка по умолчанию:-Front-компоненты выполняются в браузере в изолированном Web Worker, в то время как [логические функции](/l/ru/developers/extend/apps/logic/logic-functions) выполняются на стороне сервера. Между ними нет прямого внутрипроцессного вызова — вместо этого front-компонент обращается к логической функции по HTTP.+```tsx src/front-components/open-company-emails.tsx+import { defineFrontComponent } from 'twenty-sdk/define';+import {+ CommandOpenSidePanelPage,+ SidePanelPages,+ useSelectedRecordIds,+} from 'twenty-sdk/front-component';-Логическая функция, объявленная с `httpRouteTriggerSettings`, доступна по HTTP по своему пути маршрута. Twenty внедряет в воркер базовый URL, с которого обслуживаются ваши функции, в виде `TWENTY_FUNCTIONS_URL` вместе с `TWENTY_APP_ACCESS_TOKEN`, который аутентифицирует вызов. Пока что нет отдельного клиентского SDK для вызова ваших собственных функций, поэтому вызывайте их с помощью обычного `fetch`:+const OpenCompanyEmails = () => {+ const selectedRecordIds = useSelectedRecordIds();+ const recordId = selectedRecordIds.length === 1 ? selectedRecordIds[0] : null;-> **В Twenty Cloud логические функции с HTTP-триггером обслуживаются на выделенном домене для каждого рабочего пространства** по адресу `https://\<your-workspace-subdomain>.twenty.com\<path>` — именно к этому и разрешается `TWENTY_FUNCTIONS_URL`. Для внешних вызовов скопируйте точный URL из настроек **HTTP trigger** функции или на вкладке **Settings** приложения.+ if (!recordId) {+ return null;+ }-<Warning>- Устаревший маршрут функции `/s/` **не рекомендуется к использованию** и будет **деактивирован 2026-07-24**. Вместо этого используйте `TWENTY_FUNCTIONS_URL` (выше) и перенесите все жестко заданные URL вида `/s/` до этой даты. Маршрут `/s/` по-прежнему доступен при самостоятельном размещении (self-hosting).-</Warning>+ return (+ <CommandOpenSidePanelPage+ page={SidePanelPages.ViewRecord}+ recordId={recordId}+ objectNameSingular="company"+ tab="company-tab-emails"+ resetNavigationStack={false}+ />+ );+};++export default defineFrontComponent({+ universalIdentifier: 'b8c9d0e1-f2a3-4567-bcde-678901234567',+ name: 'open-company-emails',+ description: 'Opens the current company on its Emails tab',+ component: OpenCompanyEmails,+ isHeadless: true,+});+```++## Вызов логической функции++Front-компоненты выполняются в браузере в Web Worker, изолированном внутри iframe с непрозрачным источником (opaque-origin), в то время как [логические функции](/l/ru/developers/extend/apps/logic/logic-functions) выполняются на стороне сервера. Между ними нет прямого внутрипроцессного вызова — вместо этого front-компонент обращается к логической функции по HTTP.++Логическая функция, объявленная с `httpRouteTriggerSettings`, доступна по HTTP по своему пути маршрута. `RestApiClient` рассматривает пути, начинающиеся с `/s/`, как маршруты приложения, разрешает их в URL, по которому обслуживаются ваши функции, и аутентифицирует их с помощью `TWENTY_APP_ACCESS_TOKEN`.++> **В Twenty Cloud логические функции с HTTP-триггером обслуживаются на выделенном домене для каждого рабочего пространства** по адресу `https://\<your-workspace-subdomain>.withtwenty.com\<path>`. Для внешних вызовов скопируйте точный URL из настроек **HTTP trigger** функции или на вкладке **Settings** приложения.Безголовый front-компонент может выполнить вызов при монтировании через компонент `Command`, а затем автоматически размонтироваться:```tsx src/front-components/sync-prs.tsx+import { RestApiClient } from 'twenty-client-sdk/rest';import { defineFrontComponent } from 'twenty-sdk/define';-import { Command } from 'twenty-sdk/command';+import { Command } from 'twenty-sdk/front-component';const SyncPrs = () => {const execute = async () => {- await fetch(`${process.env.TWENTY_FUNCTIONS_URL}/github/fetch-prs`, {- method: 'POST',- headers: {- Authorization: `Bearer ${process.env.TWENTY_APP_ACCESS_TOKEN}`,- 'Content-Type': 'application/json',- },- body: JSON.stringify({ owner: 'twentyhq', repo: 'twenty' }),+ await new RestApiClient().post('/s/github/fetch-prs', {+ owner: 'twentyhq',+ repo: 'twenty',});};@@ -238,7 +301,7 @@ export default defineFrontComponent({});```-Путь, добавляемый к `TWENTY_FUNCTIONS_URL`, — это значение `httpRouteTriggerSettings.path` логической функции. Сохраните `isAuthRequired: true`; `TWENTY_APP_ACCESS_TOKEN`, который Twenty выпускает для вашего компонента, аутентифицирует запрос:+Путь, передаваемый в `RestApiClient`, — это значение `httpRouteTriggerSettings.path` логической функции с префиксом `/s`. Сохраните `isAuthRequired: true`; `TWENTY_APP_ACCESS_TOKEN`, который Twenty выпускает для вашего компонента, аутентифицирует запрос:```ts src/logic-functions/fetch-prs.logic-function.tsimport { defineLogicFunction } from 'twenty-sdk/define';@@ -263,21 +326,22 @@ export default defineLogicFunction({```<Note>-`TWENTY_FUNCTIONS_URL` и `TWENTY_APP_ACCESS_TOKEN` внедряются автоматически — см. [переменные приложения](#application-variables). Поскольку секретные переменные приложения никогда не раскрываются front-компонентам, храните ключи API и другую конфиденциальную логику в логической функции, а не во front-компоненте.+`TWENTY_APP_ACCESS_TOKEN` внедряется автоматически — см. [переменные приложения](#application-variables). Поскольку секретные переменные приложения никогда не раскрываются front-компонентам, храните ключи API и другую конфиденциальную логику в логической функции, а не во front-компоненте.</Note>### Вызов REST API Twenty-Чтобы читать или изменять записи Twenty из фронт-компонента, используйте `RestApiClient` из `twenty-client-sdk/rest`. Он принадлежит к тому же семейству клиентов, что и `CoreApiClient` и `MetadataApiClient`, но нацелен на REST API Twenty (`/rest/...`) вместо GraphQL API, считывая базовый URL из `TWENTY_API_URL`.+Чтобы вызывать HTTP-маршруты приложения или читать и изменять записи Twenty из фронт-компонента, используйте `RestApiClient` из `twenty-client-sdk/rest`. Он отправляет пути вида `/s/...` на базовый URL функций вашего рабочего пространства, а все остальные пути, включая `/rest/...`, — на `TWENTY_API_URL`.-| Метод | Описание |-| --------------------------------- | ----------------------------------------- |-| `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-методом |+| Метод | Описание |+| --------------------------------- | ----------------------------------------------------------------- |+| `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-методом |+| `resolveUrl(path, options?)` | Разрешает путь в его полный URL без отправки запроса (для ссылок) |В `options` принимаются `headers`, `query` (объект с параметрами строки запроса; значения, равные null или undefined, пропускаются) и `AbortSignal` через `signal`. Объект `body`, не являющийся `FormData`, автоматически сериализуется в JSON. При получении `401` клиент один раз обновляет токен доступа через хост и повторяет запрос.@@ -316,13 +380,13 @@ try {import { defineFrontComponent } from 'twenty-sdk/define';import {useUserId,- useRecordId,+ useSelectedRecordIds,useFrontComponentId,} from 'twenty-sdk/front-component';const RecordInfo = () => {const userId = useUserId();- const recordId = useRecordId();+ const [recordId] = useSelectedRecordIds();const componentId = useFrontComponentId();return (@@ -377,14 +441,27 @@ export default defineFrontComponent({Секретные переменные (`isSecret: true`) **не** доступны фронтенд-компонентам. Они доступны только в [логических функциях](/l/ru/developers/extend/apps/logic/logic-functions), которые выполняются на стороне сервера. Это предотвращает отправку в браузер конфиденциальных значений, таких как ключи API.</Warning>+`getApplicationVariable` всегда возвращает **строку** (или `undefined`), независимо от объявленного для переменной `type`. Строка сериализуется единообразно в зависимости от типа (логические значения как `"true"` / `"false"`, числа как десятичные строки, массивы / объекты как JSON) в том же формате, который используется для логической функции `process.env` — разбирайте её самостоятельно (`Number(...)`, `JSON.parse(...)`, `=== 'true'`). См. [типы переменных](/l/ru/developers/extend/apps/config/application#variable-types).+Следующие системные переменные всегда доступны через `process.env`:| Переменная | Описание || ------------------------- | ----------------------------------------------------------------------------- |-| `TWENTY_FUNCTIONS_URL` | Базовый URL, с которого обслуживаются функции HTTP-логики вашего приложения || `TWENTY_API_URL` | Базовый URL основного API Twenty || `TWENTY_APP_ACCESS_TOKEN` | Краткоживущий токен с областью действия, ограниченной ролью вашего приложения |+### `TWENTY_FUNCTIONS_URL`++Twenty также внедряет `TWENTY_FUNCTIONS_URL` во фронт-компоненты и логические функции: это базовый URL, по которому обслуживаются HTTP-триггерные логические функции вашего приложения.++Он существует, потому что этот URL не всегда совпадает с самим сервером Twenty. В Twenty Cloud маршруты приложения обслуживаются на выделенном домене для каждого рабочего пространства (`https://\<your-workspace-subdomain>.withtwenty.com` или основном общедоступном домене приложения, если он настроен), чтобы ответы, сформированные приложением, отдавались с изолированного источника, а не с источника приложения Twenty. Самостоятельно развёрнутые и локальные экземпляры обслуживают маршруты приложения с префиксом `/s` на самом сервере и могут вовсе не задавать эту переменную. Поскольку базовый URL различается для каждого рабочего пространства и экземпляра, ваш код не может жёстко прописать его — сервер внедряет правильное значение во время выполнения.++Вам редко нужно читать его напрямую. Вызывайте свои маршруты через `RestApiClient` с путём, начинающимся с `/s/`, и клиент разрешит URL за вас: он убирает префикс `/s` и обращается к `TWENTY_FUNCTIONS_URL`, а если переменная не задана, использует `\<TWENTY_API_URL>/s`. Используйте `resolveUrl('/s/\<path>')`, чтобы получить абсолютный URL без отправки запроса, например для ссылки. Читайте переменную напрямую только при ручной сборке URL:++```ts+const routeUrl = `${process.env.TWENTY_FUNCTIONS_URL || `${process.env.TWENTY_API_URL}/s`}/documents/generate`;+```+## API взаимодействия с хостомКомпоненты фронтенда могут вызывать навигацию, модальные окна и уведомления с помощью функций из `twenty-sdk`:@@ -403,12 +480,11 @@ export default defineFrontComponent({```tsx src/front-components/archive-record.tsximport { 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';+import { enqueueSnackbar, closeSidePanel, useSelectedRecordIds } from 'twenty-sdk/front-component';+import { CoreApiClient } from 'twenty-client-sdk/core';const ArchiveRecord = () => {- const recordId = useRecordId();+ const [recordId] = useSelectedRecordIds();const handleArchive = async () => {const client = new CoreApiClient();@@ -444,15 +520,48 @@ export default defineFrontComponent({});```+### Хранилище++`localStorage` и `sessionStorage` работают так же, как на обычной странице, с использованием стандартного синхронного API. Ваши ключи ограничены рамками установки приложения и учетной записью вошедшего пользователя: ни одно другое приложение не может их прочитать, а другой пользователь, вошедший в тот же браузер, начинает с пустого хранилища. Значения, записанные в `localStorage`, остаются на устройстве при перезагрузках; `sessionStorage` действует в течение браузерной сессии.++```tsx src/front-components/note-draft.tsx+import { useState } from 'react';+import { defineFrontComponent } from 'twenty-sdk/define';++const NoteDraft = () => {+ const [draft, setDraft] = useState(() => localStorage.getItem('draft') ?? '');++ const handleChange = (nextDraft: string) => {+ setDraft(nextDraft);+ localStorage.setItem('draft', nextDraft);+ };++ return (+ <textarea value={draft} onChange={(event) => handleChange(event.target.value)} />+ );+};++export default defineFrontComponent({+ universalIdentifier: 'd0e1f2a3-b4c5-6789-def0-890123456789',+ name: 'note-draft',+ description: 'Keeps an unsaved note on this device',+ component: NoteDraft,+});+```++Twenty хранит значения от имени вашего приложения, поэтому запись применяется локально сразу же и сохраняется в фоновом режиме. Операции чтения никогда не блокируются ожиданием хоста. Ничто не синхронизируется: значения не следуют за пользователем в другой браузер или на другой компьютер, поэтому используйте [хранилище ключ-значение](/l/ru/developers/extend/apps/logic/key-value-store) логической функции для всего, что должно пережить смену устройства.++Записи ограничены, и для каждого лимита считаются символы, а не байты: ключи могут содержать не более 512 символов, одно значение — не более 262144 символов, а каждое хранилище — не более 1048576 символов на приложение и пользователя. Запись, нарушающая лимит, выбрасывает `QuotaExceededError`, как и браузерный API.+### Работа с несколькими записямиИспользуйте `useSelectedRecordIds()` для обработки нескольких выбранных записей. Это полезно для массовых операций:```tsx src/front-components/bulk-export.tsx-import { defineFrontComponent, numberOfSelectedRecords } from 'twenty-sdk/define';+import { defineFrontComponent } 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';+import { CoreApiClient } from 'twenty-client-sdk/core';const BulkExport = () => {const selectedRecordIds = useSelectedRecordIds();@@ -490,12 +599,19 @@ export default defineFrontComponent({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,- },+});+```++Сделайте его доступным через [элемент командного меню](/l/ru/developers/extend/apps/layout/command-menu-items), доступный только при выборе записей:++```ts src/command-menu-items/bulk-export.command-menu-item.ts+import { defineCommandMenuItem } from 'twenty-sdk/define';++export default defineCommandMenuItem({+ universalIdentifier: 'd0e1f2a3-b4c5-6789-defa-012345678902',+ label: 'Bulk Export',+ availabilityType: 'RECORD_SELECTION',+ frontComponentUniversalIdentifier: 'd0e1f2a3-b4c5-6789-defa-012345678901',});```@@ -518,6 +634,43 @@ export default defineFrontComponent({См. [раздел о публичных ресурсах](/l/ru/developers/extend/apps/config/public-assets) для подробностей.+## Распространение зависимостей между фронт-компонентами++По умолчанию, каждая передняя часть объединяет свою собственную копию импортируемых библиотек, так что приложение с пятью компонентами поставляет React пять раз. Объявление общих зависимостей в пакете вашего приложения. son\`, чтобы собрать эти библиотеки один раз и загрузить каждый компонент приложения из одного кэшированного файла:++```json package.json+{+ "frontComponentSharedDependencies": ["react", "react-dom/client", "twenty-ui/input"]+}+```++Затем каждый компонент импортирует его зависимости точно так же, как и раньше: ничего не изменяется в коде компонента:++```tsx src/front-components/counter.tsx+import { useState } from 'react';+import { defineFrontComponent } from 'twenty-sdk/define';++const Counter = () => {+ const [count, setCount] = useState(0);++ return <button onClick={() => setCount(count + 1)}>{count}</button>;+};++export default defineFrontComponent({+ universalIdentifier: '...',+ name: 'counter',+ component: Counter,+});+```++Несколько важных моментов:++* **Один общий набор зависимостей для каждого приложения.** Пакет построен из зависимостей вашего приложения, так что вы сохраняете полный контроль над версиями, которые вы поставляете.+* **Перечислите точные спецификаторы, которые вы импортируете.** `twenty-ui/input` и `twenty-ui/display` являются двумя записями; только имя пакета не содержит подпусков. Список `react` автоматически охватывает `react/jsx-runtime`.+* **Поделиться `react-dom/client` вместе с `react`.** Каждый компонент проделывает `createRoot`, поэтому оставив его, значит каждый компонент всё ещё объединяет React DOM.+* \*\*Набор кэширован. \* Он обслуживается под content-hash URL с длительным неизменяемым кэшем, так что загружается один раз и повторно используется всеми компонентами приложения до тех пор, пока одна из зависимостей не изменится.+* **Компоненты, импортирующие ни один из общих пакетов никогда не загружают его.**+## СтилизацияКомпоненты фронтенда поддерживают несколько подходов к стилизации. Вы можете использовать:@@ -617,3 +770,72 @@ const Card = () => {Поскольку `useTheme()` — это хук, вы читаете токены внутри тела компонента, поэтому значения всегда соответствуют активной теме. Та же карта токенов также экспортируется как константа `themeCssVariables`, но в компонентах фронтенда предпочтительнее использовать `useTheme()` — модульная константа, разыменующая `themeCssVariables`, может быть `undefined`, пока извлекается манифест приложения.Чтобы явно разветвлять логику по активной цветовой схеме, считайте её с помощью `useColorScheme()` из `twenty-sdk/front-component`, который возвращает `'light'` или `'dark'`.++## Нынешние ограничения++Активно разрабатываются передние компоненты. Рендеринг, стиль и обработка событий хорошо работают. Все, что достигает *прошлого* рендеринга (измерение элемента, вызов метода DOM на ref, портирование за пределами дерева, прикосновение к хранилищу браузера) сегодня отсутствует или незавершено и большинство из них бесшумно: без исключения, и никакой ошибки TypeScript, так как строительные площадки набраны в полном DOM браузере.++Если один из этих блоков вас, [откройте задачу](https://github.com/twentyhq/twenty/issues/new/choose), чтобы получить приоритет.++### Макет и измерение++Ничто не может измерять сам себя.++| API | Что происходит |+| ------------------------------------------------------------- | --------------------------------------------------------------------------- |+| `getBoundingClientRect()`, `getClientRects()` | Бросает |+| `offsetWidth`, `clientWidth`, `scrollWidth`, `offsetTop`, ... | Тихо `undefined`, так `width ?? 0-й урожай `0`и`ширина > 600\` всегда false |+| `ResizeObserver`, `IntersectionObserver` | `Справочная ошибка` (защита `typeof` делает работу) |+| `window.matchMedia()`, `window.getComputedStyle()` | Бросает |+| `window.innerWidth`, `innerHeight`, `devicePixelRatio` | Молчально «неопределенно» |+| `new MutationObserver(fn)` | Построит, затем выбрасывает `.observe()` |++Таким образом, перекодирует `ResponsiveContainer`, плавающий UI / Popper, список виртуализации и перетаскивание не работают. Сделайте макет в CSS вместо: ваш стиль достигает реальной страницы, так что flexbox, сетка, `aspect-ratio`, `clamp()` и `@container` все ведут себя нормально.++<Note>+`requestAnimationFrame`, `fetch`, `setTimeout` и `queueMicrotask` работают без префикса `window.`. Только `window.requestAnimationFrame(...)` и брошенные друзья.+</Note>++### DOM access++`ref` дает вам элемент песочницы, а не `HTMLElement`.++| Что вы пишете | Что происходит | Использовать вместо |+| ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------- |+| `ref.current.focus()`, `.click()`, `.select()`, `.setSelectionRange()`, `.scrollIntoView()`, `video.play()` | Бросает | Контролируемые компоненты; читать значения из `event.target` |+| `element.classList.add(...)` | Броски (`classList` `undefined`) | Создайте строку `className` самостоятельно |+| `document.getElementById()`, `getElementsByClassName()`, `createTreeWalker()` | Бросает | `querySelector()` / `querySelectorAll()`, который работает |+| `document.activeElement` | Всегда `неопределённые` | Отслеживать фокус с с помощью «onFocus» / «onBlur» |+| `canvas` | Отображает ничего, без ошибок | SVG или рисуйте вне экрана и показывайте результат в элементе `img` |+| `createPortal(node, document.body)` | Отображает ничего, в то время как «isConnected» сообщает об успехе | Наслоения в строке `position: absolute` или передайте библиотеке свой собственный элемент контейнера |++Портал зазор поэтому всплывающие окна Radix, Headless UI, MUI и react-select не отображаются по умолчанию. Большинство из них принимают реквизиты контейнера; указывайте их на отображаемый элемент.++### События++События мыши, указателя, касания, перетаскивания, клавиатуры, фокуса, `input`/`change`/`submit`, `scroll`/`wheel`/`contextmenu` и `animationend`/`transitionend` передаются хосту, плюс несколько на элемент: `load`/`error` на `img`, буфер обмена и композиция на `input`/`textarea`, медиа на `video`/`audio`, `toggle` на `details`/`dialog`. Все остальное (`onAuxClick`, `onSelect`, `onInvalid`, `onReset`, `onAnimationStart`, захват указателя, `onLoad` у `img`) отбрасывается без предупреждения.++`document.addEventListener()` и `window. ddEventListener()` регистрируется без ошибок и никогда не стреляет, поэтому перетаскивание останавливается, как только указатель покидает начатый элемент. `event.preventDefault()` тоже не пересекается; форма представления, `dragover`/`drop` и ссылки уже охраняются для вас.++### Атрибуты и стиль++Каждый элемент передает свои собственные свойства хостовому DOM (`href` на `a`, `src`/`alt` на `img`, `value`/`placeholder`/`disabled` на `input` и так далее), плюс общий набор на каждом элементе: `id`, `className`, `style`, `title`, `tabIndex`, `role`, `draggable` и любой атрибут `aria-*` / `data-*` (через дефис, поэтому `ariaLabel` отбрасывается). Всё, что за пределами тихо отбрасывается, поэтому выражать пользовательское состояние как `data-*`.++CSS компонента, будь то из `import './styles.css'`, CSS-in-JS или элемента `style`, внедряется в `head` хостовой страницы **без области видимости**. Таким образом, имена классов конфликтуют с собственным Twenty's (префикс их), и никогда не пишут пустые `div { ... }` селекторы), а `@media` совпадает с вашим окном браузера вместо виджета (используйте `@container` с вашим собственным `container-type`). Встроенные свойства не затронуты.++### Хранилище и сеть++`localStorage` и `sessionStorage` предоставляются Twenty, а не браузером: компонент выполняется в воркере с непрозрачным источником (origin), поэтому хост хранит значения от имени вашего приложения. См. раздел [storage](#storage) для получения информации об области действия и ограничениях. IndexedDB, cookies, Cache API и `BroadcastChannel` по-прежнему недоступны. Чтобы сохранять состояние между устройствами, вызовите [логическую функцию](/l/ru/developers/extend/apps/logic/logic-functions) и используйте ее [хранилище ключ-значение](/l/ru/developers/extend/apps/logic/key-value-store).++`fetch` работает с сохранениями:++* Звонки к Twenty API и маршрутам вашего приложения проксируются узлом, поэтому предпочитайте [`RestApiClient`](#calling-the-twenty-rest-api). В случае проксируемых вызовов `AbortSignal` и другие опции `RequestInit` удаляются, и поддерживаются только тела `string` и `URLSearchParams`.+* Другие источники оставляют песчаник с `Origin: null`, так что сторонний API отвечает, только если он посылает `Access-Control-Allow-Origin: *`. Вызовите его из логической функции.+* `fetch('/rest/people')` никогда не совпадает с двадцать API, потому что песочница не имеет URL страницы для разрешения относительного пути.++### Другие пробелы++* **Содержимое файла.** Элемент `input` с типом `file` предоставляет вашему обработчику только метаданные файла, а не байты, поэтому `FileReader` и загрузки пока невозможны.+* **Перетащите приложения.** Перетаскивайте события, но `event.dataTransfer` `неопределённый`.+* **Узел встроенный** `fs`, `path` и `node:crypto` не срабатывают сборки, так что переместитесь с помощью [logic функции](/l/ru/developers/extend/apps/logic/logic-functions). Веб-криптовалюты, `fetch`, `TextEncoder` и `URL`.+* **`iframe`** всегда повторно изолируется без `allow-same-origin`, поэтому встраиваемый контент, зависящий от собственной сессии, отображается как неавторизованный. У него также нет `onLoad`.diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/layout/navigation-menu-items.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/layout/navigation-menu-items.mdxindex 5162532b2d1..4dd9bda1daa 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/layout/navigation-menu-items.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/layout/navigation-menu-items.mdx@@ -35,10 +35,12 @@ export default defineNavigationMenuItem({* `position` управляет порядком в боковой панели.+* Перечисление также содержит `NavigationMenuItemType.RECORD`, используемый внутренне для добавляемых пользователем в «Избранное» записей — он не может использоваться из манифеста приложения (нет поля для ссылки на запись).+* `icon` и `color` являются необязательными и настраивают внешний вид элемента.* `folderUniversalIdentifier` также доступен для любого элемента, чтобы поместить его внутрь родительского элемента типа `FOLDER`.<Note>-**Распространенная ошибка:** создание объекта без связанного представления и элемента навигационного меню делает этот объект невидимым для пользователей. Если только это не технический/внутренний объект, у каждого настраиваемого объекта должно быть представление по умолчанию *и* элемент боковой панели, указывающий на него.+**Распространенная ошибка:** создание объекта без связанного элемента навигационного меню делает этот объект недоступным через боковую панель. Если только это не технический/внутренний объект, у каждого настраиваемого объекта должен быть элемент боковой панели, указывающий на него.</Note>diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/layout/overview.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/layout/overview.mdxindex 1bfccb8dab3..9a50069d719 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/layout/overview.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/layout/overview.mdx@@ -45,12 +45,15 @@ icon: table-columns## Где отображается приложение-| Область отображения | Что определяет | Сущность |-| ---------------------------------------- | ---------------------------------------------------------------------------------------- | ----------------------------------------- |-| **Боковая панель** | Пользовательский элемент, который ссылается на сохранённое представление или внешний URL | `defineNavigationMenuItem` |-| **Список записей** | Сохранённая конфигурация для объекта — видимые столбцы, порядок, фильтры, группы | `defineView` |-| **Страница деталей записи** | Вкладки и виджеты на странице записи (вашего собственного объекта или стандартного) | `definePageLayout`, `definePageLayoutTab` |-| **Внутри любого из перечисленного выше** | Пользовательский React‑виджет — кнопки, формы, панели мониторинга, интеграции | `defineFrontComponent` |-| **Меню команд (Cmd+K)** | Закреплённое быстрое действие или скрытая команда | `defineCommandMenuItem` |+| Область отображения | Что определяет | Сущность |+| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- |+| **Боковая панель** | Пользовательский элемент, который ссылается на сохранённое представление или внешний URL | `defineNavigationMenuItem` |+| **Список записей** | Сохранённая конфигурация для объекта — видимые столбцы, порядок, фильтры, группы | `defineView` |+| **Страница деталей записи** | Вкладки и виджеты на странице записи (вашего собственного объекта или стандартного) | `definePageLayout`, `definePageLayoutTab` |+| **Внутри любого из перечисленного выше** | Пользовательский React‑виджет — кнопки, формы, панели мониторинга, интеграции | `defineFrontComponent` |+| **Настройки приложения** | Настраиваемый раздел конфигурации на вкладке «Настройки» приложения, используемый вместо стандартного интерфейса переменных | `defineSettingsFrontComponent` |+| **Меню команд (Cmd+K)** | Закреплённое быстрое действие или скрытая команда | `defineCommandMenuItem` |Фронтенд‑компоненты выполняются внутри изолированного Web Worker с использованием Remote DOM — они отображаются *нативно* на странице (не внутри iframe), но не могут напрямую обращаться к хостовой странице или DOM. Взаимодействие с Twenty происходит через хостовый API обмена сообщениями.++Они все еще находятся в активной разработке: песочница реализует частичный DOM, поэтому сложные варианты использования могут завершаться сбоем. См. раздел [Текущие ограничения](/l/ru/developers/extend/apps/layout/front-components#current-limitations).diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/layout/page-layouts.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/layout/page-layouts.mdxindex 98899a84fd3..6211cc7a984 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/layout/page-layouts.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/layout/page-layouts.mdx@@ -31,7 +31,7 @@ export default definePageLayout({title: 'Hello World',position: 50,icon: 'IconWorld',- layoutMode: PageLayoutTabLayoutMode.CANVAS,+ layoutMode: PageLayoutTabLayoutMode.VERTICAL_LIST,widgets: [{universalIdentifier: 'aa4234e0-2e5f-4c02-a96a-573449e2351d',@@ -51,12 +51,35 @@ export default definePageLayout({### Основные моменты-* `type` обычно равен `'RECORD_PAGE'` для настройки детального представления конкретного объекта.+* `type` — одно из значений `'RECORD_INDEX'`, `'RECORD_PAGE'`, `'DASHBOARD'` или `'STANDALONE_PAGE'`. Используйте `'RECORD_PAGE'` для настройки детального представления конкретного объекта.* `objectUniversalIdentifier` указывает, к какому объекту применяется этот макет.-* Каждая `tab` определяет раздел страницы с `title`, `position` и `layoutMode` (`CANVAS` для свободного макета).+* Каждая `tab` определяет раздел страницы с `title`, `position` и `layoutMode`: `VERTICAL_LIST` для страниц записей и автономных страниц, `GRID` для панелей мониторинга. Во вкладке `VERTICAL_LIST` один виджет отображается на всю ширину и занимает всю вкладку; при нескольких виджетах они располагаются в виде карточек. Вкладка `GRID` всегда раскладывает свои виджеты в виде карточек на 12‑колоночной сетке, независимо от их количества, так что выбирайте `VERTICAL_LIST`, когда нужно, чтобы один виджет заполнял страницу.+* Явно задайте `layoutMode`. Если его не указывать, вы получите `VERTICAL_LIST` на `STANDALONE_PAGE` и `GRID` в остальных случаях, что редко бывает нужно на странице записи.* Каждый `widget` внутри вкладки может отображать [front component](/l/ru/developers/extend/apps/layout/front-components), список связей или другие встроенные типы виджетов.* `position` у вкладок управляет их порядком. Используйте большие значения (например, 50), чтобы разместить пользовательские вкладки после встроенных.+### Виджеты полей++Виджет `FIELD` отображает одно поле записи. Для полей связи он также может встраивать список связанных записей:++```ts+{+ universalIdentifier: 'c1c2c3c4-c5c6-4000-8000-000000000003',+ title: 'People → Opportunities',+ type: 'FIELD',+ configuration: {+ configurationType: 'FIELD',+ fieldMetadataId: PEOPLE_FIELD_UNIVERSAL_IDENTIFIER,+ fieldDisplayMode: 'TABLE',+ nestedRelationFieldMetadataId: OPPORTUNITIES_FIELD_UNIVERSAL_IDENTIFIER,+ },+}+```++* `fieldMetadataId` принимает универсальный идентификатор поля в объекте макета.+* `fieldDisplayMode` может иметь одно из следующих значений: `'FIELD'`, `'CARD'`, `'EDITOR'`, `'VIEW'` или `'TABLE'`. `TABLE` встраивает представление, отображающее записи поля связи «один‑ко‑многим».+* `nestedRelationFieldMetadataId` является необязательным и принимает универсальный идентификатор поля связи «один‑ко‑многим» на целевом объекте связи, чтобы перечислять записи на два перехода связи дальше (например, страница Company, перечисляющая сделки людей этой компании, или страница Person, перечисляющая сделки компании этого человека). Первый переход может быть полем связи «один‑ко‑многим» или «многие‑к‑одному», второй обязан быть «один‑ко‑многим» (соединительные связи не поддерживаются), и это требует `fieldDisplayMode: 'TABLE'` — комбинирование его с любым другим режимом отображения является ошибкой валидации, поскольку вложенный виджет всегда отображается как встраиваемое представление.+## definePageLayoutTabИспользуйте это, когда вы хотите только **добавить** вкладку к существующему макету — например, вкладку аналитики на стандартной странице Company или вкладку с AI-сводкой, прикреплённую к макету вашего собственного объекта.@@ -77,7 +100,7 @@ export default definePageLayoutTab({title: 'Hello World',position: 1000,icon: 'IconWorld',- layoutMode: PageLayoutTabLayoutMode.CANVAS,+ layoutMode: PageLayoutTabLayoutMode.VERTICAL_LIST,widgets: [{universalIdentifier: 'b1b2b3b4-b5b6-4000-8000-000000000002',diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/layout/views.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/layout/views.mdxindex 6f5e23f77cb..56b659133ed 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/layout/views.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/layout/views.mdx@@ -4,10 +4,12 @@ description: Поставляйте предварительно настроеicon: list----**Представление** — это сохранённая конфигурация того, как отображаются записи объекта: какие поля появляются, их порядок, видимость, а также применённые фильтры и группы. Используйте `defineView()` для поставки предварительно настроенных представлений вместе с вашим приложением — обычно это представление списка по умолчанию для каждого создаваемого вами пользовательского объекта.+**Представление** — это сохранённая конфигурация того, как отображаются записи объекта: какие поля появляются, их порядок, видимость, а также применённые фильтры и группы. Используйте `defineView()` для поставки преднастроенных представлений вместе с вашим приложением.++Каждый объект автоматически получает свое основное представление списка (таблицу "All ...", которую открывает пункт навигации `OBJECT`), подготавливаемое сервером — включая объекты, создаваемые вашим приложением, с одним столбцом для каждого поля, объявленного вашим приложением. Представления, которые вы определяете с помощью `defineView()`, всегда являются **дополнительными** представлениями поверх этого представления по умолчанию.```ts src/views/example-view.ts-import { defineView, ViewKey } from 'twenty-sdk/define';+import { defineView } from 'twenty-sdk/define';import { EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER } from '../objects/example-object';import { NAME_FIELD_UNIVERSAL_IDENTIFIER } from '../objects/example-object';@@ -16,7 +18,6 @@ export default defineView({name: 'All example items',objectUniversalIdentifier: EXAMPLE_OBJECT_UNIVERSAL_IDENTIFIER,icon: 'IconList',- key: ViewKey.INDEX,position: 0,fields: [{@@ -33,17 +34,32 @@ export default defineView({## Основные моменты* `objectUniversalIdentifier` указывает, к какому объекту применяется это представление. Это может быть пользовательский объект, который вы определили, или стандартный объект Twenty.-* `key` определяет тип представления — `ViewKey.INDEX` — это основное представление списка для объекта.-* `fields` управляет тем, какие столбцы отображаются и в каком порядке. Каждое поле ссылается на `fieldMetadataUniversalIdentifier`.-* Также вы можете определить `filters`, `filterGroups`, `groups` и `fieldGroups` для более продвинутых конфигураций.+* Основное представление списка объекта принадлежит серверу: `key` устарел и игнорируется, поэтому представление из манифеста никогда не сможет на него претендовать. Добавьте элемент навигации `VIEW`, если вы хотите, чтобы до вашего представления можно было добраться в один клик из боковой панели.+* `fields` управляет тем, какие столбцы отображаются и в каком порядке. Каждое поле ссылается на `fieldMetadataUniversalIdentifier`. Чтобы сослаться на автоматически созданное системное поле, такое как `createdAt`, см. раздел [Targeting System Metadata](/l/ru/developers/extend/apps/data/system-fields).+* Также вы можете определить `filters`, `filterGroups`, `sorts`, `groups` и `fieldGroups` для более продвинутых конфигураций.* `position` управляет порядком, когда для одного и того же объекта существует несколько представлений.+## Необязательные свойства++| Свойство | Значения | Описание |+| ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |+| `type` | `ViewType.TABLE` (по умолчанию), `ViewType.LIST`, `ViewType.KANBAN`, `ViewType.CALENDAR` | Как записи располагаются на экране. (`FIELDS_WIDGET`, `TABLE_WIDGET`, `KANBAN_WIDGET`, `LIST_WIDGET` и `CALENDAR_WIDGET` также существуют, но используются внутри виджетов макета страницы.) |+| `visibility` | `ViewVisibility.WORKSPACE` (по умолчанию), `ViewVisibility.UNLISTED` | Отображается ли представление для всего рабочего пространства или скрыто из элементов выбора. |+| `openRecordIn` | устаревшие | Больше не используется: место открытия записей теперь является свойством [объекта](/l/ru/developers/extend/apps/data/objects) (`openRecordIn` в `defineObject()`); при отсутствии значения используется предпочтение каждого пользователя. |+| `sorts` | `{ fieldMetadataUniversalIdentifier, direction: ViewSortDirection.ASC \| DESC }[]` | Порядок сортировки по умолчанию. |+| `isCompact` | `boolean` | Компактное отображение строк. |+| `mainGroupByFieldMetadataUniversalIdentifier` + `shouldHideEmptyGroups` | — | Группировать записи (например, столбцы канбана) по полю. |+| `kanbanAggregateOperation`, `kanbanAggregateOperationFieldMetadataUniversalIdentifier`, `kanbanColumnWidth` | `AggregateOperations.*` | Агрегирование и ширина столбцов канбана. |+| `calendarLayout`, `calendarFieldMetadataUniversalIdentifier`, `calendarEndFieldMetadataUniversalIdentifier` | `ViewCalendarLayout.DAY` / `WEEK` / `MONTH` | Календарные представления: макет, поле даты, по которому размещаются записи, и необязательное поле даты окончания. |++Все перечисления выше экспортируются из `twenty-sdk/define`.+## ФильтрыПредставление может поставляться с заранее примененными фильтрами. У каждого фильтра есть три координаты: **поле**, по которому выполняется фильтрация, **операнд** (как сравнивать) и **значение** (с чем сравнивать). Все три должны совпадать — использование операнда, который не подходит для типа поля, будет отклонено во время синхронизации.```ts-import { ViewFilterOperand } from 'twenty-shared/types';+import { ViewFilterOperand } from 'twenty-sdk/define';filters: [{@@ -94,4 +110,4 @@ filters: [## Как представления отображаются в интерфейсе-Само по себе представление недоступно из боковой панели. Чтобы оно появилось там, свяжите его с [пунктом навигационного меню](/l/ru/developers/extend/apps/layout/navigation-menu-items) типа `VIEW`, который указывает на `universalIdentifier` представления. Это канонический шаблон: каждый пользовательский объект обычно поставляется с представлением по умолчанию и пунктом боковой панели, который его открывает.+Само по себе представление недоступно из боковой панели. Чтобы оно появилось там, свяжите его с [пунктом навигационного меню](/l/ru/developers/extend/apps/layout/navigation-menu-items) типа `VIEW`, который указывает на `universalIdentifier` представления. Это канонический шаблон: для каждого настраиваемого объекта при создании автоматически генерируется индексное представление по умолчанию, поэтому вам нужно только добавить элемент боковой панели, который его открывает.diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/logic/background-jobs.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/logic/background-jobs.mdxnew file mode 100644index 00000000000..510a897e39a--- /dev/null+++ b/packages/twenty-docs/l/ru/developers/extend/apps/logic/background-jobs.mdx@@ -0,0 +1,165 @@+---+title: Фоновые задания+description: Передавайте длительные или ограниченные по скорости задачи воркерам Twenty, помещая в очередь ещё один запуск логической функции вместо выполнения всего прямо в текущем процессе.+icon: layer-group+---++Запуск логической функции ограничен значением `timeoutSeconds` (максимум 900 секунд). Любая задача, которая не может завершиться за это время — полная повторная синхронизация, разветвление по каждой записи, сторонний API, который ограничивает вас по скорости, — должна быть разделена на более мелкие запуски.++`enqueueJob` делает именно это: он просит воркеров Twenty позже запустить одну из логических функций вашего приложения в отдельном процессе с собственным лимитом времени. Вызов возвращается немедленно.++```text+ ┌─────────────────┐ enqueueJob(...) ┌──────────────┐ ┌────────────────────┐+ │ Logic function │ ─────────────────▶ │ Job queue │──▶│ Logic function │+ │ (returns now) │ │ (workers) │ │ (fresh run/timeout)│+ └─────────────────┘ └──────────────┘ └────────────────────┘+```++## Поставить запуск в очередь++Импортируйте `enqueueJob` из `twenty-sdk/logic-function` и укажите `universalIdentifier` логической функции, которую вы хотите запустить.++```ts src/logic-functions/sync-all-contacts.ts+import { enqueueJob } from 'twenty-sdk/logic-function';++await enqueueJob({+ logicFunctionUniversalIdentifier: '9f1c3d7e-51b8-4a29-8f0d-7c4e2a6b1d33',+ payload: { page: 1 },+});+```++Целевая функция получает `payload` как аргумент обработчика, точно так же, как любой другой триггер. Она должна принадлежать **тому же приложению**, что и вызывающая сторона — постановка в очередь функции другого приложения будет отклонена с ошибкой `Logic function not found`.++<Note>+`enqueueJob` возвращает управление, как только задание принято, а не когда оно выполнено. Он не возвращает результат целевой функции — если вам нужно потом его прочитать, пусть целевая функция запишет результат в [key-value store](/l/ru/developers/extend/apps/logic/key-value-store) или в запись рабочего пространства.+</Note>++## Параметры задания++| Вариант | По умолчанию | Диапазон | Что делает |+| ------------ | ------------ | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |+| `retryLimit` | `0` | `0`–`10` | Дополнительные попытки, если выполнение приводит к ошибке. Увеличивайте это значение только для обработчиков, которые безопасно запускать дважды. |+| `delayMs` | `0` | `0`–`604800000` (7 дней) | Сколько ждать, прежде чем запуск станет допустимым к выполнению. |++```ts+await enqueueJob({+ logicFunctionUniversalIdentifier: '9f1c3d7e-51b8-4a29-8f0d-7c4e2a6b1d33',+ payload: { page: 1 },+ retryLimit: 3,+ delayMs: 60_000,+});+```++<Note>+**Приоритет пока нельзя настраивать.** Задания в очереди всегда выполняются с самым низким приоритетом, поэтому работа платформы никогда не откладывается из‑за заданий приложений. Возможность управлять приоритетом появится скоро.+</Note>++Запуск в очереди наследует действующего пользователя функции, которая его поставила в очередь, поэтому он работает с теми же правами.++## Использование: постраничный проход по длинной синхронизации++Классический шаблон — функция, которая ставит *саму себя* в очередь со следующим курсором. Каждый запуск обрабатывает одну страницу работы, уверенно укладываясь в собственный таймаут, а цепочка останавливается, когда больше нечего делать.++```ts src/logic-functions/sync-contacts-page.ts+import { defineLogicFunction } from 'twenty-sdk/define';+import { enqueueJob } from 'twenty-sdk/logic-function';++const SYNC_CONTACTS_PAGE = '9f1c3d7e-51b8-4a29-8f0d-7c4e2a6b1d33';++const handler = async (params: { cursor?: string }) => {+ const { contacts, nextCursor } = await fetchContactsPage(params.cursor);++ await importContacts(contacts);++ if (nextCursor) {+ await enqueueJob({+ logicFunctionUniversalIdentifier: SYNC_CONTACTS_PAGE,+ payload: { cursor: nextCursor },+ delayMs: 2_000,+ });+ }++ return { imported: contacts.length, done: !nextCursor };+};++export default defineLogicFunction({+ universalIdentifier: SYNC_CONTACTS_PAGE,+ name: 'sync-contacts-page',+ timeoutSeconds: 120,+ handler,+});+```++## Разветвление по каждой записи++Когда работа естественным образом выполняется по отдельным элементам, поставьте по одному заданию на элемент и позвольте воркерам обрабатывать их параллельно, вместо того чтобы перебирать элементы в цикле внутри одной функции.++```ts+const companies = await listCompaniesToEnrich();++await Promise.all(+ companies.map((company) =>+ enqueueJob({+ logicFunctionUniversalIdentifier: ENRICH_COMPANY,+ payload: { companyId: company.id },+ retryLimit: 2,+ }),+ ),+);+```++## Рекомендации для длительной работы++Два правила покрывают почти любое долгое задание: **рекурсивный вызов вместо цикла** и **обработка ограниченного блока за один запуск**.++Запуск, который пытается сделать всё сразу, — это сценарий отказа: он упирается в таймаут и при повторной попытке начинает всё сначала с нуля. Вместо этого выберите размер блока так, чтобы он с запасом завершался в пределах `timeoutSeconds`, сохраните свою позицию и поставьте в очередь следующий запуск.++```ts src/logic-functions/enrich-companies-batch.ts+import { defineLogicFunction } from 'twenty-sdk/define';+import { enqueueJob, kv } from 'twenty-sdk/logic-function';++const ENRICH_COMPANIES_BATCH = '3f9d1c02-8a44-4f0e-b1d7-9c2e5a7b4f10';+const CHUNK_SIZE = 50;++const handler = async (params: { offset?: number }) => {+ const offset = params.offset ?? 0;+ const companies = await listCompaniesToEnrich({+ offset,+ limit: CHUNK_SIZE,+ });++ for (const company of companies) {+ await enrichCompany(company);+ }++ await kv.set('enrich:progress', { offset: offset + companies.length });++ if (companies.length === CHUNK_SIZE) {+ await enqueueJob({+ logicFunctionUniversalIdentifier: ENRICH_COMPANIES_BATCH,+ payload: { offset: offset + CHUNK_SIZE },+ });+ }++ return { processed: companies.length, done: companies.length < CHUNK_SIZE };+};++export default defineLogicFunction({+ universalIdentifier: ENRICH_COMPANIES_BATCH,+ name: 'enrich-companies-batch',+ timeoutSeconds: 300,+ handler,+});+```++Почему это работает:++* **Размер блока выбирайте, исходя из самого медленного элемента, а не среднего.** `CHUNK_SIZE × время обработки в худшем случае` должно помещаться в `timeoutSeconds` с запасом, иначе хвост блока будет потерян, когда запуск обрежет таймаут.+* **Сделайте условие завершения явным.** Вызывайте рекурсивно только пока вернулся полный блок. Цепочка, которая останавливается только на основе «нет результатов», будет продолжаться бесконечно, если источник когда‑либо вернёт укороченную страницу посередине.+* **Сохраняйте прогресс перед постановкой в очередь следующего запуска**, чтобы при сбое звена цепочки она возобновлялась с последнего завершённого блока, а не с начала.+* **Сделайте каждый блок идемпотентным.** Повторная обработка одного блока после повторной попытки не должна приводить к двойной записи — привязывайте операции записи к идентификатору обрабатываемой записи или к внешнему идентификатору.+* **Отдавайте предпочтение цепочке из блоков перед одним гигантским разветвлением**, когда работа обращается к внешнему сервису с ограничением по скорости: цепочка с `delayMs` саморегулирует темп, тогда как тысячи заданий, поставленных в очередь одновременно, сразу становятся допустимыми к выполнению.++<Warning>+Повторные попытки запускают весь обработчик заново. Сделайте обработчики в очереди идемпотентными, прежде чем устанавливать `retryLimit` выше `0`.+</Warning>diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/logic/connections.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/logic/connections.mdxindex 988c7d1db1a..20486b939f1 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/logic/connections.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/logic/connections.mdx@@ -42,6 +42,12 @@ export default defineConnectionProvider({// Optional: provider's RFC 7009 token revocation endpoint, called on disconnect.// revokeEndpoint: 'https://example.com/oauth/revoke',},+ // Optional: a logic function in this app to run right after a connection is+ // established. See "Run a logic function on connect".+ // onConnectLogicFunction: { universalIdentifier: '3a2b1c0d-...-...' },+ // Optional: a logic function in this app to run right after a connection is+ // removed. See "Run a logic function on disconnect".+ // onDisconnectLogicFunction: { universalIdentifier: '4d5e6f70-...-...' },});```@@ -87,6 +93,76 @@ https://<your-twenty-server>/auth/apps/callback</Accordion>+<Accordion title="Запускайте логическую функцию при подключении" description="Реагируйте в момент установления соединения">++Некоторые провайдеры передают вам данные в момент подключения, которые нужно сохранить до того, как соединение станет пригодным к использованию — классический пример — Slack, где OAuth-ответ указывает `team_id` рабочей области, по которому будут определяться входящие события. Установите `onConnectLogicFunction`, чтобы сослаться на логическую функцию в том же приложении (по её `universalIdentifier`), и она будет выполнена сразу после создания `ConnectedAccount`.++```ts src/connection-providers/slack-connection.ts+export default defineConnectionProvider({+ universalIdentifier: '...',+ name: 'slack',+ displayName: 'Slack',+ type: 'oauth',+ oauth: {+ /* ... */+ },+ // Runs claimSlackTeam after every successful Slack connection.+ onConnectLogicFunction: {+ universalIdentifier: '3a2b1c0d-1111-4222-8333-444455556666',+ },+});+```++Хук выполняется **асинхронно в подключающейся рабочей области** (он ставится в очередь, а не ожидается), поэтому медленный или падающий хук никогда не блокирует и не ломает OAuth-callback — сделайте его идемпотентным и обеспечьте собственную обработку повторных попыток. Обработчик получает:++```ts+type OnConnectPayload = {+ connectionProviderId: string;+ connectionProviderName: string; // e.g. 'slack'+ connectedAccountId: string;+};+```++Оттуда используйте `getConnection(connectedAccountId)`, чтобы прочитать новый access token и вызвать API провайдера (например, Slack `auth.test`) или сохранить отображение с помощью [key-value store](/l/ru/developers/extend/apps/logic/key-value-store).++</Accordion>++<Accordion title="Запускайте логическую функцию при отключении" description="Выполняйте очистку при удалении подключения">++Всё, на что приложение заявляет права при подключении, должно быть освобождено, когда подключение прекращается. Интеграция со Slack, которая, например, заявляет `team_id` при подключении, должна освободить это право, чтобы другое рабочее пространство могло подключить ту же Slack-команду. Установите `onDisconnectLogicFunction`, чтобы сослаться на логическую функцию в том же приложении, и она будет выполнена сразу после удаления `ConnectedAccount`.++```ts src/connection-providers/slack-connection.ts+export default defineConnectionProvider({+ universalIdentifier: '...',+ name: 'slack',+ displayName: 'Slack',+ type: 'oauth',+ oauth: {+ /* ... */+ },+ // Runs releaseSlackTeam after every Slack disconnection.+ onDisconnectLogicFunction: {+ universalIdentifier: '4470aba8-5ff5-4800-88db-2a427cd8677c',+ },+});+```++Как и hook on-connect, он запускается **асинхронно в отключаемом рабочем пространстве** и никогда не блокирует отключение. Обработчик получает тот же формат полезной нагрузки:++```ts+type OnDisconnectPayload = {+ connectionProviderId: string;+ connectionProviderName: string; // e.g. 'slack'+ connectedAccountId: string;+};+```++`ConnectedAccount` уже удалён к моменту запуска hook, поэтому `getConnection(connectedAccountId)` больше не возвращает результат. Всё, что требуется для очистки (например, `team_id`, внешний идентификатор подписки), должно быть записано в [key-value store](/l/ru/developers/extend/apps/logic/key-value-store) в момент подключения, с ключом `connectedAccountId`.++Hook срабатывает, когда соединение удаляется само по себе. При удалении приложения его соединения удаляются каскадом на уровне базы данных, поэтому hook в этом случае не запускается. Объявите `uninstallLogicFunction` в `defineApplication` для этого сценария: она запускается до удаления метаданных приложения, поэтому всё ещё может вызвать `listConnections` и выполнить оставшуюся очистку.++</Accordion>+<Accordion title="listConnections / getConnection" description="Используйте подключения из логической функции">Внутри обработчика логической функции `listConnections({ providerName })` возвращает записи `ConnectedAccount` этого приложения для указанного провайдера с обновленными токенами доступа.diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/logic/key-value-store.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/logic/key-value-store.mdxindex 107943bf4b6..5ca0cebf0ec 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/logic/key-value-store.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/logic/key-value-store.mdx@@ -1,153 +1,57 @@---title: Хранилище ключ-значение-description: Сохраняйте промежуточные результаты, кэшируйте данные и разделяйте состояние между запусками логических функций с помощью простого объекта ключ-значение.+description: Сохраняйте промежуточные результаты, кэшируйте данные и разделяйте состояние между запусками логических функций с помощью встроенного в приложение хранилища ключ-значение.icon: database----Логические функции выполняются в изолированной среде во временных процессах Node.js — после завершения запуска в памяти ничего не сохраняется. Когда вам нужно **что-то запомнить между запусками** (кэшировать дорогой ответ API, сохранить курсор для инкрементальной синхронизации, «задебаунсить» работу или передать состояние от одной функции к другой), сохраняйте это в базе данных рабочего пространства.+Логические функции выполняются в изолированной среде во временных процессах Node.js — после завершения запуска в памяти ничего не сохраняется. Когда вам нужно **что-то запомнить между запусками** (кэшировать дорогой ответ API, сохранить курсор для инкрементальной синхронизации, «задебаунсить» работу или передать состояние от одной функции к другой), сохраняйте это во встроенном хранилище ключ-значение.-Для этого не нужен отдельный примитив хранилища: небольшой **технический объект** с полем `key` и полем `value` даёт вам надёжное key-value-хранилище, ограниченное рабочим пространством и доступное для запросов через тот же [типизированный API-клиент](/l/ru/developers/extend/apps/logic/logic-functions#typed-api-clients-twenty-client-sdk), который вы уже используете для записей.+Каждое приложение получает собственное изолированное пространство имён: записи привязаны к аутентифицированному приложению, поэтому ваши ключи никогда не могут конфликтовать с ключами другого приложения или быть прочитаны другим приложением.```text- ┌─────────────────┐ set(key, value) ┌──────────────────────────┐- │ Logic function │ ───────────────────▶ │ "KV Store" object │- │ (your handler) │ ◀─────────────────── │ key (unique) │ value │- └─────────────────┘ get(key) └──────────────────────────┘+ ┌─────────────────┐ kv.set(key, value) ┌──────────────────────────┐+ │ Logic function │ ─────────────────────▶ │ Application KV store │+ │ (your handler) │ ◀───────────────────── │ key (unique) │ value │+ └─────────────────┘ kv.get(key) └──────────────────────────┘```-## Определите объект хранилища--Объявите настраиваемый объект с двумя полями — `key` (уникальный `TEXT`) и `value` (`RAW_JSON`, чтобы можно было сохранять любые JSON-сериализуемые данные). См. [Objects](/l/ru/developers/extend/apps/data/objects) для полной справки по `defineObject`.--```ts src/objects/kv-store.object.ts-import { defineObject, FieldType } from 'twenty-sdk/define';--export const KV_STORE_UNIVERSAL_IDENTIFIER =- '2f1c8a90-3b6d-4e2a-9c47-7d0e5a1b9f33';-export const KV_STORE_KEY_FIELD_UNIVERSAL_IDENTIFIER =- '4a7e2d11-9c83-4f60-b5a2-1e6c8d0f4b21';-export const KV_STORE_VALUE_FIELD_UNIVERSAL_IDENTIFIER =- '8b3f6c02-5d19-47ae-9f31-2c4a7e0b6d58';--export default defineObject({- universalIdentifier: KV_STORE_UNIVERSAL_IDENTIFIER,- nameSingular: 'kvStore',- namePlural: 'kvStores',- labelSingular: 'KV Store',- labelPlural: 'KV Store',- description: 'Key-value storage for logic functions',- icon: 'IconDatabase',- fields: [- {- universalIdentifier: KV_STORE_KEY_FIELD_UNIVERSAL_IDENTIFIER,- name: 'key',- type: FieldType.TEXT,- label: 'Key',- description: 'Unique lookup key',- icon: 'IconKey',- },- {- universalIdentifier: KV_STORE_VALUE_FIELD_UNIVERSAL_IDENTIFIER,- name: 'value',- type: FieldType.RAW_JSON,- label: 'Value',- description: 'Stored JSON payload',- icon: 'IconJson',- },- ],-});-```--### Обеспечьте уникальность ключей--Добавьте **уникальный индекс** на `key`, чтобы один и тот же ключ никогда не мог иметь две строки. Это рекомендуемый примитив для обеспечения уникальности — см. [Data → Unique indexes](/l/ru/developers/extend/apps/data/overview#unique-indexes).--```ts src/indexes/kv-store-key.index.ts-import { defineIndex } from 'twenty-sdk/define';-import {- KV_STORE_UNIVERSAL_IDENTIFIER,- KV_STORE_KEY_FIELD_UNIVERSAL_IDENTIFIER,-} from '../objects/kv-store.object';--export default defineIndex({- universalIdentifier: 'c0d4e8f2-6a1b-4c93-8e57-3f9a2d0b7e14',- objectUniversalIdentifier: KV_STORE_UNIVERSAL_IDENTIFIER,- isUnique: true,- fields: [- {- universalIdentifier: 'c0d4e8f2-6a1b-4c93-8e57-3f9a2d0b7e15',- fieldUniversalIdentifier: KV_STORE_KEY_FIELD_UNIVERSAL_IDENTIFIER,- },- ],-});-```+## Получение, установка, удаление-## Чтение и запись из логической функции+Импортируйте `kv` из `twenty-sdk/logic-function`. Значения могут быть любыми JSON-сериализуемыми данными.-Спрячьте объект за несколькими небольшими вспомогательными функциями, чтобы остальной код выглядел как key-value API — `get`, `set` и `del`. Они используют [`CoreApiClient`](/l/ru/developers/extend/apps/logic/logic-functions#typed-api-clients-twenty-client-sdk), который генерируется из схемы вашего рабочего пространства и полностью типизирован относительно объекта `kvStore`.+```ts src/logic-functions/sync-linear-issues.ts+import { kv } from 'twenty-sdk/logic-function';-```ts src/logic-functions/handlers/kv-store.ts-import { CoreApiClient } from 'twenty-client-sdk/core';-import { isDefined } from 'twenty-sdk/utils';+// Read a value. Returns null when the key is missing.+const cursor = await kv.get<string>('sync-cursor:linear');-const client = new CoreApiClient();+// Write a value. Creates the entry on first write, updates it afterwards.+await kv.set('sync-cursor:linear', newCursor);-// Look up a single row by its key.-const findByKey = async (key: string) => {- const { kvStores } = await client.query({- kvStores: {- __args: { filter: { key: { eq: key } }, first: 1 },- edges: { node: { id: true, value: true } },- },- });+// Delete an entry. Returns true when an entry was removed.+await kv.delete('sync-cursor:linear');+```- return kvStores.edges[0]?.node;-};+## Области действия-// Read a value. Returns undefined when the key is missing.-export const get = async <TValue>(key: string): Promise<TValue | undefined> => {- const row = await findByKey(key);+У каждой записи есть область видимости (scope), которая передаётся как опция при каждом вызове. По умолчанию используется `WORKSPACE`.- return isDefined(row) ? (row.value as TValue) : undefined;-};+* **`WORKSPACE`** (по умолчанию) — запись доступна только для текущей установки вашего приложения в рабочем пространстве. Каждое рабочее пространство, в которое устанавливается приложение, получает собственный независимый набор ключей. Это то, что вам нужно для кэшей, курсоров и состояния на уровне рабочего пространства.+* **`SERVER`** — запись разделяется между **всеми установками** вашего приложения на сервере. Серверные записи ведут себя как механизм резервирования: сохраняемым значением всегда является workspaceId, зарезервировавший ключ (опустите `value` при вызове `set`, чтобы зарезервировать ключ для текущего рабочего пространства), и только это рабочее пространство может перезаписать или удалить запись. Любая установка может прочитать эту запись.-// Write a value. Creates the row on first write, updates it afterwards (upsert).-export const set = async (key: string, value: unknown): Promise<void> => {- const existing = await findByKey(key);-- if (isDefined(existing)) {- await client.mutation({- updateKvStore: {- __args: { id: existing.id, data: { value } },- id: true,- },- });- return;- }+Резервирования на сервере используются для маршрутизации между рабочими пространствами. [Резолвер серверного маршрута](/l/ru/developers/extend/apps/logic/logic-functions#server-route-trigger) выполняется в рабочем пространстве владельца регистрации приложения, но входящий вебхук обычно содержит только внешний идентификатор аккаунта, а не workspaceId в Twenty. Пусть каждое рабочее пространство зарезервирует свой внешний идентификатор в момент подключения, а затем разрешайте его в маршруте:- await client.mutation({- createKvStore: {- __args: { data: { key, value } },- id: true,- },- });-};+```ts+// In the connected workspace, when the external account is linked:+await kv.set(`slack:team:${teamId}`, undefined, { scope: 'SERVER' });-// Delete a value. No-op when the key is missing.-export const del = async (key: string): Promise<void> => {- const existing = await findByKey(key);-- if (isDefined(existing)) {- await client.mutation({- deleteKvStore: { __args: { id: existing.id }, id: true },- });- }-};+// In the server-route resolver (owner workspace), on each webhook:+const workspaceId = await kv.get<string>(`slack:team:${teamId}`, {+ scope: 'SERVER',+});```-<Note>-Уникальный индекс защищает от дубликатов, но два запуска, записывающие **один и тот же новый ключ** в один и тот же момент, всё ещё могут войти в гонку между поиском и созданием. Рассматривайте создание, которое завершилось сбоем по ограничению уникальности, как «кто-то другой успел первым» — перехватите его и перечитайте, или повторите попытку как обновление.-</Note>+Поскольку серверный ключ может быть занят только для собственного рабочего пространства вызывающего кода и никогда не может быть перезаписан другим, рабочее пространство не может перехватить сопоставление, принадлежащее кому-то ещё. `kv.set` выбрасывает ошибку, если ключ уже занят другим рабочим пространством.## Использование: кэширование дорогого вызова@@ -155,15 +59,15 @@ export const del = async (key: string): Promise<void> => {```ts src/logic-functions/getExchangeRate.logic-function.tsimport { defineLogicFunction } from 'twenty-sdk/define';-import { get, set } from './handlers/kv-store';+import { kv } from 'twenty-sdk/logic-function';const ONE_HOUR_MS = 60 * 60 * 1000;type CachedRate = { rate: number; fetchedAt: number };const handler = async (params: { from: string; to: string }) => {- const cacheKey = `exchange-rate:${params.from}:${params.to}`;- const cached = await get<CachedRate>(cacheKey);+ const cacheKey = `cache:exchange-rate:${params.from}:${params.to}`;+ const cached = await kv.get<CachedRate>(cacheKey);if (cached && Date.now() - cached.fetchedAt < ONE_HOUR_MS) {return { rate: cached.rate, cached: true };@@ -174,7 +78,7 @@ const handler = async (params: { from: string; to: string }) => {);const { rate } = (await response.json()) as { rate: number };- await set(cacheKey, { rate, fetchedAt: Date.now() });+ await kv.set(cacheKey, { rate, fetchedAt: Date.now() });return { rate, cached: false };};@@ -189,12 +93,18 @@ export default defineLogicFunction({## Шаблоны и советы-* **Пространства имён.** Добавляйте префиксы к ключам, чтобы разделять разные задачи и упростить массовые выборки — `sync-cursor:linear`, `cache:exchange-rate:USD:EUR`, `lock:nightly-report`. Фильтруйте по `key: { like: 'cache:%' }`, чтобы перечислить или очистить целое пространство имён.-* **Срок жизни (TTL).** У хранилища нет встроенного механизма истечения срока действия. Сохраняйте метку времени внутри `value` (как в примере с кэшем) и проверяйте её при чтении, или добавьте поле `DATE_TIME` и периодически очищайте устаревшие строки из [функции, запускаемой по cron](/l/ru/developers/extend/apps/logic/logic-functions).-* **Что хранить.** `RAW_JSON` может содержать любое JSON-сериализуемое значение — числа, строки, массивы, объекты. Держите записи небольшими; это для координации и кэширования, а не для больших блобов или файлов. Для файлов используйте поле `FILES` и [`uploadFile`](/l/ru/developers/extend/apps/logic/logic-functions#uploading-files).+* **Пространства имён.** Добавляйте префиксы к ключам, чтобы разделять разные задачи — `sync-cursor:linear`, `cache:exchange-rate:USD:EUR`, `lock:nightly-report`.+* **Срок жизни (TTL).** У хранилища нет встроенного механизма истечения срока действия. Сохраняйте метку времени внутри значения (как в примере с кэшем) и проверяйте её при чтении или очищайте устаревшие ключи из [функции, запускаемой по cron](/l/ru/developers/extend/apps/logic/logic-functions).+* **Что хранить.** Любое JSON-сериализуемое значение — числа, строки, массивы, объекты. Держите записи небольшими; это для координации и кэширования, а не для больших блобов или файлов. Для файлов используйте поле `FILES` и [`uploadFile`](/l/ru/developers/extend/apps/logic/logic-functions#uploading-files).+* **Видимость.** Записи хранятся в базе данных экземпляра, а не как записи рабочего пространства — они никогда не отображаются в интерфейсе рабочего пространства, не являются частью модели данных вашего приложения и не требуют ролей или прав доступа к объектам.++## Альтернатива: объект-хранилище с возможностью запросов++Встроенное хранилище намеренно сделано непрозрачным: записи не являются записями объектов, поэтому вы не можете просматривать их в интерфейсе, связывать их с другими объектами или фильтровать их с помощью запросов к записям. Когда вам нужно что-то из этого — например, видимый журнал синхронизаций или состояние на уровне записи, — вместо этого определите небольшой **технический объект** с уникальным полем `key` и полем `value` типа `RAW_JSON`, и выполняйте к нему запросы через [типизированный API-клиент](/l/ru/developers/extend/apps/logic/logic-functions#typed-api-clients-twenty-client-sdk). См. [Objects](/l/ru/developers/extend/apps/data/objects) для справки по `defineObject` и [Data → Unique indexes](/l/ru/developers/extend/apps/data/overview#unique-indexes) по обеспечению уникальности ключей.++* **Привязка к записи.** Добавьте [relation](/l/ru/developers/extend/apps/data/relations) от объекта-хранилища к целевому объекту вместо кодирования идентификатора в ключе.* **Видимость и разрешения.** Строки живут в базе данных рабочего пространства как любые другие записи, поэтому к ним можно обращаться через API, и они подчиняются [ролям](/l/ru/developers/extend/apps/config/roles) вашего приложения. Чтобы скрыть хранилище из основного пользовательского интерфейса, не добавляйте его в [навигационное меню](/l/ru/developers/extend/apps/layout/navigation-menu-items).-* **Привязка к записи.** Нужно состояние на уровне отдельной записи вместо глобальных ключей? Добавьте [relation](/l/ru/developers/extend/apps/data/relations) из объекта хранилища к целевому объекту вместо кодирования идентификатора в ключе.<Note>-Это соглашение, а не отдельная функция — «KV Store» — это просто обычный настраиваемый объект, который вы определяете и к которому обращаетесь с помощью стандартного API. Это значит, что он получает преимущества той же синхронизации, системы разрешений и инструментов, что и остальные данные вашего приложения.+В отличие от встроенного хранилища, пользовательский объект всегда ограничен одним рабочим пространством — он не может разделять записи между установками так, как это делают ключи `SERVER`.</Note>diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/logic/logic-functions.mdxindex cf7d445bb5c..4b99db9f39a 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/logic/logic-functions.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/logic/logic-functions.mdx@@ -51,8 +51,7 @@ export default defineLogicFunction({```Доступные типы триггеров:-* **httpRoute**: Публикует вашу функцию по HTTP-пути и методу **под конечной точкой `/s/`**:-> например, `path: '/post-card/create'` вызывается по адресу `https://your-twenty-server.com/s/post-card/create`+* **httpRoute**: Публикует вашу функцию по HTTP-пути и методу. В коде приложения добавляйте префикс `/s/` к пути маршрута при использовании `RestApiClient`; развернутый URL использует внедренную базовую часть `TWENTY_FUNCTIONS_URL` (или `\<server-url>/s`, если она не задана).<Note>Чтобы вызвать логическую функцию, запускаемую маршрутом, из фронтенд-компонента (без интерфейса), см. раздел [Вызов логической функции](/l/ru/developers/extend/apps/layout/front-components#calling-a-logic-function).@@ -60,7 +59,7 @@ export default defineLogicFunction({* **cron**: Запускает вашу функцию по расписанию с использованием выражения CRON.* **databaseEvent**: Запускается при событиях жизненного цикла объектов рабочего пространства. Когда операция события — `updated`, можно указать конкретные поля для отслеживания в массиве `updatedFields`. Если оставить не заданным или пустым, любое обновление будет вызывать функцию.> например, `person.updated`, `*.created`, `company.*`-* **serverRoute**: открывает один HTTP-маршрут в области регистрации. Функция-резолвер (объявленная с помощью `serverRouteTriggerSettings`) выполняется в рабочем пространстве-владельце и возвращает целевое рабочее пространство И целевую логическую функцию для маршрутизации; платформа затем запускает эту **целевую** функцию и возвращает ее ответ. См. [триггер серверного маршрута](#server-route-trigger).+* **serverRoute**: открывает один HTTP-маршрут в области регистрации. Функция-резолвер (объявленная с помощью `serverRouteTriggerSettings`) выполняется в рабочем пространстве-владельце и либо возвращает синхронный `Response`, либо целевое рабочее пространство И логическую функцию для постановки в очередь; в случае постановки в очередь платформа отправляет подтверждение с кодом `202` и запускает эту целевую функцию в очереди worker. См. [триггер серверного маршрута](#server-route-trigger).<Note>Вы также можете вручную выполнить функцию с помощью CLI:@@ -172,19 +171,28 @@ const handler = async (event: RoutePayload) => {Код состояния должен быть допустимым кодом состояния HTTP (в диапазоне от 100 до 599). Имена заголовков ответа сравниваются без учета регистра.</Note>+#### Ошибочные ответы платформы++Помимо собственных ответов вашего обработчика, платформа в некоторых ситуациях отвечает на запросы к маршрутам напрямую: `404`, когда маршрут или функция не существует, `403`, когда приложение остановлено, `429`, когда достигнут предел частоты выполнения, и `422`, когда `dependencies` приложения для продакшена слишком велики для установки — см. раздел [ограничения на размер зависимостей](/l/ru/developers/extend/apps/getting-started/project-structure#dependencies).+#### Триггер серверного маршрута`httpRouteTriggerSettings` предоставляет функцию по пути `/s/` и определяет рабочее пространство из хоста запроса — это работает, когда у каждого рабочего пространства свой домен. Поставщики сторонних сервисов, однако, отправляют события всех арендаторов на **один** URL. В этом случае используйте `serverRouteTriggerSettings`.Триггер состоит из двух частей:-1. Логическая функция-**резолвер** — объявляется с помощью `serverRouteTriggerSettings` — выполняется в вашем **рабочем пространстве-владельце** (рабочем пространстве, которому принадлежит регистрация приложения). Она анализирует входящий запрос и возвращает `{ workspaceId, targetLogicFunctionUniversalIdentifier, payload? }`, выбирая *и* целевое рабочее пространство, и целевую функцию. Резолвер является единой точкой авторизации — URL содержит только идентификатор резолвера. **Это предпочтительное место для проверки подписей запросов**: резолвер выполняется до любых побочных эффектов, имеет доступ к исходным `rawBody` и переадресованным заголовкам и может отклонить запрос, не обращаясь к целевой функции.-2. **Целевая** логическая функция — обычная логическая функция на рабочее пространство — затем выполняется в определенном рабочем пространстве с полезной нагрузкой, возвращенной резолвером (или с исходной полезной нагрузкой запроса, если резолвер ее не преобразовал). Ее возвращаемое значение становится HTTP-ответом.+1. Логическая функция-**резолвер** — объявляется с помощью `serverRouteTriggerSettings` — выполняется в вашем **рабочем пространстве-владельце** (рабочем пространстве, которому принадлежит регистрация приложения). Она анализирует входящий запрос и возвращает либо:++ * `{ workspaceId, targetLogicFunctionUniversalIdentifier, payload? }` — платформа ставит эту целевую функцию в очередь в определённом рабочем пространстве и отправляет подтверждение с кодом `202 { queued: true }`, или+ * `Response` из `twenty-sdk/logic-function` — платформа возвращает этот HTTP‑ответ **синхронно** и **не** ставит целевую функцию в очередь (используйте это для challenge‑рукопожатий, таких как Slack `url_verification`).++ Резолвер является единой точкой авторизации — URL содержит только идентификатор резолвера. **Это предпочтительное место для проверки подписей запросов**: резолвер выполняется до любых побочных эффектов, имеет доступ к исходным `rawBody` и переадресованным заголовкам и может отклонить запрос, не обращаясь к целевой функции.+2. **Целевая** логическая функция — обычная логическая функция на рабочее пространство — затем выполняется в определенном рабочем пространстве с полезной нагрузкой, возвращенной резолвером (или с исходной полезной нагрузкой запроса, если резолвер ее не преобразовал). Его возвращаемое значение не видит HTTP‑клиент, когда резолвер выбрал путь постановки в очередь.```ts src/logic-functions/resolve-server-route.logic-function.tsimport { createHmac, timingSafeEqual } from 'crypto';import { defineLogicFunction } from 'twenty-sdk/define';-import type { RoutePayload } from 'twenty-sdk/logic-function';+import { Response, type RoutePayload } from 'twenty-sdk/logic-function';// Runs in the owner workspace. Verifies the request signature, picks// which target function should handle the event, and returns the@@ -211,12 +219,25 @@ const handler = async (event: RoutePayload) => {}const body = (event.body ?? {}) as {+ challenge?: string;metadata?: { twentyWorkspaceId?: string };type?: string;};+ // Handshakes must be answered on this same response, so reply from the+ // resolver instead of returning a dispatch target.+ if (body.type === 'url_verification') {+ return new Response({ challenge: body.challenge });+ }++ const workspaceId = body.metadata?.twentyWorkspaceId;++ if (!workspaceId) {+ throw new Error('event is not linked to a workspace');+ }+return {- workspaceId: body.metadata?.twentyWorkspaceId ?? '',+ workspaceId,// Route different event types to different target functions.targetLogicFunctionUniversalIdentifier:body.type === 'invoice.paid'@@ -265,7 +286,7 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniver**Приложение должно быть закреплено и установлено в рабочем пространстве владельца.** Поскольку резолвер выполняется в **рабочем пространстве владельца** (рабочем пространстве, которому принадлежит регистрация приложения), триггер серверного маршрута будет работать только после того, как приложение будет *закреплено* — то есть у него появится рабочее пространство владельца — **и** это приложение будет **установлено в рабочем пространстве владельца**. Пока оба этих условия не выполнены, резолверу негде выполняться, поэтому маршрут не может быть отправлен на обработку. Приложение, которое предоставляет логическую функцию `serverRouteTriggerSettings`, соответственно, не может быть размещено в маркетплейсе, пока оно не будет закреплено и установлено в рабочем пространстве владельца.</Note>-**Контракт резолвера.** Тип `LogicFunctionConfig` в SDK обеспечивает это на этапе компиляции: как только вы задаете `serverRouteTriggerSettings`, ваш обработчик обязан возвращать `{ workspaceId: string; targetLogicFunctionUniversalIdentifier: string; payload?: object }` (или `Promise` этого объекта). `workspaceId` должен указывать на рабочее пространство, в котором установлена целевая функция, иначе запрос будет отклонен с кодом `404`.+**Контракт резолвера.** Тип `LogicFunctionConfig` в SDK обеспечивает это на этапе компиляции: как только вы задаете `serverRouteTriggerSettings`, ваш обработчик обязан возвращать либо `Response`, либо `{ workspaceId: string; targetLogicFunctionUniversalIdentifier: string; payload?: object }` (или `Promise` одного из этих вариантов). На пути диспетчеризации `workspaceId` должен указывать на рабочее пространство, в котором установлена целевая функция, иначе запрос будет отклонен с кодом `404`. Результат, не соответствующий ни одному из этих форматов — включая случай, когда идентификаторы не являются UUID, — отклоняется с кодом `502`.| Поле | Тип | Заметки || ---------------------------------------- | ------------------------- | -------------------------------------------------------------------------------------------- |@@ -290,7 +311,9 @@ POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionUniverПриведенный выше пример резолвера уже показывает поток GitHub HMAC-SHA256 — адаптируйте имя заголовка, кодировку дайджеста и строку подписываемой полезной нагрузки в соответствии с провайдером, с которым вы интегрируетесь.<Note>-Целевая функция выполняется **синхронно**, и ее возвращаемое значение становится HTTP-ответом, поэтому вызывающая сторона видит ваш статус-код и может повторить запрос при не-2xx коде. Делайте оба обработчика быстрыми — некоторые провайдеры (например, Slack) прерывают запрос через несколько секунд. Поскольку резолвер доступен как публичная конечная точка, защитите его с помощью ограничения частоты запросов (rate limiting) на вашем периметре (edge).+Когда резолвер возвращает объект диспетчеризации, маршрут отвечает `202 { queued: true }`, а целевая функция запускается в очереди worker — вызывающая сторона никогда не видит задержку, результат или сбои целевой функции (они записываются в журналах выполнения). Это не позволяет повторным отправкам со стороны отправителя усиливать замедление обработки, что и требуется для приёма вебхуков.++Когда вызывающей стороне нужно прочитать тело ответа в рамках того же запроса (challenge‑рукопожатия, интерактивные подтверждения), вместо этого верните `Response` из **резолвера**. Платформа синхронно эхо‑возвращает этот ответ и пропускает очередь; его заголовки проходят через тот же allow‑list, что и заголовки ответов HTTP‑маршрутов. Делайте функцию-резолвер быстрой — некоторые провайдеры (например, Slack) прерывают запрос через несколько секунд. Поскольку резолвер доступен как публичная конечная точка, защитите его с помощью ограничения частоты запросов (rate limiting) на вашем периметре (edge).</Note>#### Полезная нагрузка триггера события базы данных@@ -593,7 +616,7 @@ const handler = async (params: { parentMessageId?: string }) => {</Note><Note>-**Хуки установки** — обработчики до установки и после установки — используют тот же рантайм, но объявляются с помощью собственных функций `define` и не принимают настройки триггеров. См. раздел [Install Hooks](/l/ru/developers/extend/apps/config/install-hooks) для `definePreInstallLogicFunction` и `definePostInstallLogicFunction`.+**Хуки установки** — обработчики до установки, после установки и при удалении — используют тот же рантайм, но объявляются с помощью собственных функций `define` и не принимают настройки триггеров. См. раздел [Install Hooks](/l/ru/developers/extend/apps/config/install-hooks) для `definePreInstallLogicFunction`, `definePostInstallLogicFunction` и `defineUninstallLogicFunction`.</Note>## Типизированные клиенты API (twenty-client-sdk)diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/logic/overview.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/logic/overview.mdxindex 1306f67f667..fd4f2e16645 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/logic/overview.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/logic/overview.mdx@@ -34,6 +34,12 @@ icon: bolt<Card title="Подключения" icon="plug" href="/l/ru/developers/extend/apps/logic/connections">OAuth-учетные данные, которые ваше приложение хранит для сторонних сервисов — Linear, GitHub, Slack и других.</Card>+ <Card title="Хранилище ключ-значение" icon="database" href="/l/ru/developers/extend/apps/logic/key-value-store">+ Сохраняйте состояние между запусками логических функций — кэши, курсоры и утверждения между рабочими пространствами.+ </Card>+ <Card title="Фоновые задания" icon="layer-group" href="/l/ru/developers/extend/apps/logic/background-jobs">+ Поставьте функцию Logic в очередь на исполнение воркерами, чтобы обойти таймаут на один запуск.+ </Card></CardGroup>## Типы триггеров вкратцеdiff --git a/packages/twenty-docs/l/ru/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/logic/skills-and-agents.mdxindex b7a8c2632af..489aee30e9a 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/logic/skills-and-agents.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/logic/skills-and-agents.mdx@@ -100,7 +100,7 @@ export default defineAgent({</Accordion><Accordion title="runAgent" description="Запуск агента из логической функции">-`runAgent()` позволяет логической функции запустить одного из агентов вашего приложения (с его навыками и инструментами). Идентифицируйте агента по `universalIdentifier`, который вы передали в `defineAgent()`:+`runAgent()` позволяет логической функции запустить одного из агентов вашего приложения (с его навыками и инструментами). Идентифицируйте агента по `universalIdentifier`, который вы передали в `defineAgent()`. Передайте либо строку `prompt`, либо историю диалога `messages` — но не оба варианта одновременно:```ts src/logic-functions/run-enricher.tsimport { runAgent } from 'twenty-sdk/logic-function';@@ -111,7 +111,24 @@ const { result, error, success } = await runAgent({});```+Для многошаговых ботов (Slack, Discord, Teams, …) передавайте историю треда как `messages` вместо одного `prompt`:++```ts src/logic-functions/reply-in-thread.ts+import { runAgent } from 'twenty-sdk/logic-function';++const { result, error, success } = await runAgent({+ agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123',+ messages: [+ { role: 'user', content: 'Who owns Acme?' },+ { role: 'assistant', content: 'Sarah owns the Acme account.' },+ { role: 'user', content: 'What was the last touchpoint?' },+ ],+});+```+Основные моменты:+* Укажите **ровно один** из `prompt` (строка) или `messages` (от 1 до 100 элементов+ вида `{ role: 'user' | 'assistant', content: string }`).* Агент выполняется **синхронно** и может самостоятельно читать и обновлять записи с помощью собственных инструментов — `runAgent()` возвращает результат после завершения выполнения.* Приложение может запускать только собственных агентов.* [Роль по умолчанию](/l/ru/developers/extend/apps/config/roles) приложения должна предоставлять флаг разрешения `AI` — добавьте `SystemPermissionFlag.AI` в `permissionFlagUniversalIdentifiers` (или установите `canAccessAllTools: true`).@@ -134,5 +151,30 @@ export default defineApplicationRole({**Избегайте циклов:** если вы вызываете `runAgent()` из триггера события базы данных `*.updated`, и агент обновляет ту же запись, ограничьте триггер, указав в `updatedFields` поле, которое агент никогда не изменяет (например, исходный URL), или добавьте проверку, что хотя бы одно целевое поле всё ещё пусто, прежде чем вызывать `runAgent()`.</Warning>+### Запуск от имени участника рабочего пространства++Передавайте `runAsWorkspaceMemberId`, когда запуск инициирован человеком — например, чат-ботом, отвечающим на сообщение, — чтобы агент действовал как этот участник, а не как приложение:++```ts src/logic-functions/answer-question.ts+const { result } = await runAgent({+ agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123',+ prompt: 'How many open opportunities do we have?',+ runAsWorkspaceMemberId: '20202020-0687-4c41-b707-ed1bfca972a7',+});+```++Затем запуск выполняется с **собственной ролью участника**: он может делать всё, что может делать этот участник, и не больше; созданные им записи приписываются этому участнику, и к ним применяются его разрешения на уровне строк. Роль агента в этом не участвует — это роль по умолчанию приложения для запусков, за которыми никто не стоит. Опускайте это поле для автономных запусков (плановые задания, триггеры событий базы данных): в таких случаях сохраняется собственная роль агента. Действующее приложение остаётся привязанным к контексту запуска для отслеживания происхождения, не сужая при этом полномочий участника.++Ваше приложение отвечает за сопоставление человека, который инициировал запуск, с участником рабочего пространства. Чтобы указать участника, требуется токен доступа приложения; то, кого можно указать с помощью токена, зависит от того, привязан ли к нему пользователь:++* Токен **без привязанного пользователя** может указать любого участника. Логическая функция выполняется с таким токеном; то же относится к токенам, выпущенным через `client_credentials` или на основе API‑ключа.+* Токен, выданный **от имени пользователя** (как у фронтенд‑компонента), может указывать только на участника самого этого пользователя.++Все остальное — обычная пользовательская сессия, API‑ключ без токена приложения — вообще не может указывать участника.++<Warning>+ `runAgent()` генерирует исключение, если не удаётся определить участника рабочего пространства — неизвестного или удалённого участника, либо участника без роли. При этом никогда не используется роль самого агента, так как это предоставило бы больше прав доступа, чем запросил вызывающий код.+</Warning>+</Accordion></AccordionGroup>diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/operations/cli.mdxindex c4f13959fbd..393e0951076 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/operations/cli.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/operations/cli.mdx@@ -4,7 +4,25 @@ description: Команды `yarn twenty` для выполнения функцicon: terminal----Помимо `dev`, `dev:build`, `dev:add` и `dev:typecheck`, CLI `yarn twenty` предоставляет команды для выполнения функций, просмотра логов и управления установками приложений.+CLI `yarn twenty` — ваш инструмент для всего, что связано с приложением. Полный список команд:++| Команда | Что делает | Описано в |+| ----------------------------------------------- | ---------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |+| `dev` | Отслеживает исходные файлы и синхронизирует изменения в реальном времени | [Краткое руководство](/l/ru/developers/extend/apps/getting-started/quick-start) |+| `план` | Предпросмотр изменений метаданных без их применения | [Syncing & recovery](/l/ru/developers/extend/apps/operations/sync-and-recovery#previewing-changes-plan) |+| `применить` | Применить изменения метаданных после показа плана | [Syncing & recovery](/l/ru/developers/extend/apps/operations/sync-and-recovery) |+| `dev:build` | Скомпилировать приложение и сгенерировать API‑клиент (`--tarball` для упаковки в `.tgz`) | [Публикация](/l/ru/developers/extend/apps/operations/publishing) |+| `dev:typecheck` | Запустить проверку типов TypeScript | [Тестирование](/l/ru/developers/extend/apps/operations/testing) |+| `dev:add` | Создать каркас новой сущности | [Создание каркаса](/l/ru/developers/extend/apps/getting-started/scaffolding) |+| `dev:generate-client` | Повторно сгенерировать типизированный API‑клиент | эта страница |+| `dev:function:exec` / `dev:function:logs` | Выполнять функции и транслировать их логи | эта страница |+| `dev:translations-extract` | Извлечь переводимые строки в каталоги `locales/` | [Переводы](/l/ru/developers/extend/apps/translations/overview) |+| `dev:catalog-sync` | Запустить синхронизацию каталога маркетплейса | [Публикация](/l/ru/developers/extend/apps/operations/publishing#how-marketplace-discovery-works) |+| `app:publish` / `app:install` / `app:uninstall` | Жизненный цикл релиза | [Публикация](/l/ru/developers/extend/apps/operations/publishing) и эта страница |+| `docker:*` | Управлять локальным контейнером сервера Twenty | [Локальный сервер](/l/ru/developers/extend/apps/getting-started/local-server) |+| `remote:*` | Управлять подключениями к серверам | эта страница |++Каждая команда принимает параметр `-r, --remote \<name>`, чтобы указать конкретное удалённое подключение вместо подключения по умолчанию.## Выполнение функций (`yarn twenty dev:function:exec`)@@ -20,8 +38,10 @@ yarn twenty dev:function:exec -u e56d363b-0bdc-4d8a-a393-6f0d1c75bdcf# Pass a JSON payloadyarn twenty dev:function:exec -n create-new-post-card -p '{"name": "Hello"}'-# Execute the post-install function+# Execute the install and uninstall hooksyarn twenty dev:function:exec --postInstall+yarn twenty dev:function:exec --preInstall+yarn twenty dev:function:exec --uninstall```## Просмотр логов функций (`yarn twenty dev:function:logs`)@@ -100,6 +120,12 @@ yarn twenty remote:list# Set the active remoteyarn twenty remote:use <name>++# Check that the active remote's authentication is still valid+yarn twenty remote:status++# Remove a remote+yarn twenty remote:remove <name>```Ваши учётные данные хранятся в `~/.twenty/config.json`.diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/operations/publishing.mdxindex 01d7e87a862..653e8cef297 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/operations/publishing.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/operations/publishing.mdx@@ -49,11 +49,7 @@ yarn twenty app:publish --private### Общий доступ к развернутому приложению-<Warning>-Совместный доступ к частным приложениям (tarball) между рабочими пространствами — функция уровня **Enterprise**. Вкладка **Distribution** будет показывать предложение обновиться вместо элементов управления совместным доступом, пока в вашем рабочем пространстве не будет действительного ключа Enterprise. Перейдите в [Настройки > Панель администратора > Enterprise](/settings/admin-panel#enterprise), чтобы включить её.-</Warning>--Приложения в формате tarball не отображаются в публичном маркетплейсе, поэтому другие рабочие пространства на том же сервере не найдут их при просмотре. Как только ваше рабочее пространство перейдёт на тарифный план Enterprise, вы сможете поделиться развёрнутым приложением следующим образом:+Приложения в формате tarball не отображаются в публичном маркетплейсе, поэтому другие рабочие пространства на том же сервере не найдут их при просмотре. Чтобы поделиться развернутым приложением:1. Перейдите в **Настройки > Приложения > Регистрации** и откройте ваше приложение2. На вкладке **Распространение** нажмите **Копировать ссылку для общего доступа**@@ -69,7 +65,7 @@ yarn twenty app:publish --private1. Увеличьте значение поля `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. Рабочие пространства, в которых установлено приложение, увидят доступное обновление в своих настройках+3. Рабочие пространства, в которых приложение установлено и для него включено автообновление (на вкладке «Настройки» приложения), обновляются автоматически в фоновом режиме; в остальных рабочих пространствах пользователи увидят доступное обновление в своих настройках<Note>Пререлизные теги работают как ожидается: повышение версии `1.0.0-rc.1` → `1.0.0-rc.2` допускается, а финальный релиз вроде `1.0.0` корректно распознаётся как более высокий, чем `1.0.0-rc.5`. Версия в `package.json` должна сама по себе быть корректной строкой semver.@@ -112,7 +108,7 @@ yarn twenty app:publish --private## Автоматизированный CI/CD (рабочие процессы, сгенерированные шаблоном)-Приложения, созданные с помощью `create-twenty-app`, «из коробки» включают два рабочих процесса GitHub Actions в каталоге `.github/workflows/`. Они готовы к запуску, как только вы запушите репозиторий на GitHub — для CI не требуется дополнительной настройки, а для CD нужен лишь один секрет.+Приложения, созданные с помощью `create-twenty-app`, «из коробки» включают три рабочих процесса GitHub Actions в каталоге `.github/workflows/`. CI запускается без какой-либо настройки, для CD требуется один секрет, а публикация в npm требует однократной настройки доверенного издателя npm (trusted-publisher).### CI — `ci.yml`@@ -157,9 +153,33 @@ yarn twenty app:publish --privateДобавьте к pull request метку `deploy`. Условие `if:` в `cd.yml` запустит задачу для этого PR, используя его head-коммит, что позволит проверить изменение на целевом сервере до слияния.+### Публикация — `publish.yml`++Публикует ваше приложение в npm с указанием происхождения (provenance), когда вы отправляете тег версии (например, `v1.0.0`), или когда вы запускаете рабочий процесс вручную на вкладке Actions.++**Что делает:**++1. Клонирует ваше приложение, настраивает Node.js и обновляет npm (для доверенной публикации требуется npm версии 11.5.1 или новее).+2. Запускает `yarn twenty app:publish`, который собирает приложение и публикует `.twenty/output` в npm. В CI он автоматически добавляет `--provenance` и `--access public`, поэтому в рабочем процессе флаги не требуются.++**Первоначальная настройка:**++На npmjs.com откройте свой пакет > **Settings → Trusted Publisher** и зарегистрируйте этот репозиторий, указав рабочий процесс `publish.yml` (см. [документацию по доверенной публикации в npm](https://docs.npmjs.com/trusted-publishers)). Публикация с provenance подтверждает, какой репозиторий GitHub собрал пакет, а также позволяет вам заявить права на ваше приложение в маркетплейсе Twenty.++<Note>+npm принимает подтверждение происхождения только из **публичных** репозиториев с исходным кодом. Если вы публикуете из приватного репозитория, npm отклоняет пакет подтверждения происхождения OIDC с ошибкой `E422 ... Ошибка `Unsupported GitHub Actions source repository visibility: "private"`. Чтобы публиковать из приватного репозитория, отключите подтверждение происхождения, установив `TWENTY_APP_PUBLISH_DISABLE_PROVENANCE: 'true'`в`env`шага публикации (закомментированная подсказка включена в сгенерированный`publish.yml\`):++```yaml filename=".github/workflows/publish.yml"+ - name: Publish to npm+ env:+ TWENTY_APP_PUBLISH_DISABLE_PROVENANCE: 'true'+ run: yarn twenty app:publish+```+</Note>+### Закрепление версий повторно используемых действий-Оба рабочих процесса ссылаются на повторно используемые действия с указанием `@main`, поэтому обновления действий в репозитории `twentyhq/twenty` подхватываются автоматически. Если вам нужны детерминированные сборки, замените `@main` на SHA коммита или тег релиза в каждой строке `uses:`.+Рабочие процессы `ci.yml` и `cd.yml` ссылаются на повторно используемые действия с указанием `@main`, поэтому обновления действий в репозитории `twentyhq/twenty` подхватываются автоматически. Если вам нужны детерминированные сборки, замените `@main` на SHA коммита или тег релиза в каждой строке `uses:`.## Публикация в npm@@ -180,15 +200,15 @@ yarn twenty app:publish --private### Метаданные маркетплейса-Конфигурация `defineApplication()` поддерживает необязательные поля, которые определяют, как ваше приложение отображается в маркетплейсе. Используйте `logoUrl` и `screenshots`, чтобы ссылаться на изображения из папки `public/`:+Конфигурация `defineApplication()` поддерживает необязательные поля, которые определяют, как ваше приложение отображается в маркетплейсе. Используйте `logo` и `galleryImages`, чтобы ссылаться на изображения из папки `public/`:```ts src/application-config.tsexport default defineApplication({universalIdentifier: '...',displayName: 'My App',description: 'A great app',- logoUrl: 'public/logo.png',- screenshots: [+ logo: 'public/logo.png',+ galleryImages: ['public/screenshot-1.png','public/screenshot-2.png',],@@ -197,14 +217,18 @@ export default defineApplication({См. [аккордеон defineApplication](/l/ru/developers/extend/apps/config/application#marketplace-metadata) на странице «Создание приложений» для полного списка полей маркетплейса (`author`, `category`, `aboutDescription`, `websiteUrl`, `termsUrl` и т. д.).-#### Рекомендуемые размеры скриншотов+#### Рекомендуемые размеры изображений галереи-Маркетплейс отображает `screenshots` в контейнере с фиксированным соотношением сторон `8:5` (например, `1600×1000 px`).+Маркетплейс отображает `galleryImages` в контейнере с фиксированным соотношением сторон `8:5` (например, `1600×1000 px`).<Note>-Скриншоты с любым соотношением сторон отображаются полностью и никогда не обрезаются, но всё, что значительно выше или уже, чем `8:5`, будет иметь пустые поля по бокам.+Изображения галереи с любым соотношением сторон отображаются полностью и никогда не обрезаются, но всё, что значительно выше или уже, чем `8:5`, будет иметь пустые поля по бокам.</Note>+#### Ограничение размера изображения++Файл `logo` и каждый файл из `galleryImages` не должны превышать **10 MB**. Более крупные файлы пропускаются при повторном размещении ваших опубликованных ресурсов на маркетплейсе, поэтому они не будут отображаться.+### Публикация```bash filename="Terminal"@@ -229,7 +253,7 @@ yarn twenty dev:catalog-sync# yarn twenty dev:catalog-sync --remote production```-Метаданные, отображаемые в маркетплейсе, берутся из конфигурации `defineApplication()` — из таких полей, как `displayName`, `description`, `author`, `category`, `logoUrl`, `screenshots`, `aboutDescription`, `websiteUrl` и `termsUrl`.+Метаданные, отображаемые в маркетплейсе, берутся из вашей конфигурации `defineApplication()` — см. раздел [Метаданные маркетплейса](#marketplace-metadata) выше.<Note>Если ваше приложение не определяет `aboutDescription` в `defineApplication()`, маркетплейс автоматически использует `README.md` вашего пакета из npm в качестве содержимого страницы «О приложении». Это означает, что вы можете поддерживать единый README как для npm, так и для маркетплейса Twenty. Если вы хотите другое описание в маркетплейсе, явно задайте `aboutDescription`.@@ -237,37 +261,12 @@ yarn twenty dev:catalog-sync### Публикация через CI-Используйте этот workflow 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-```+Сгенерированный выше рабочий процесс `publish.yml` автоматически публикует в npm по тегам версий, с provenance. Поскольку `yarn twenty app:publish` при запуске в CI добавляет за вас `--provenance` и `--access public`, в рабочем процессе не нужны флаги npm — требуется только однократная настройка доверенного издателя.-Для других CI-систем (GitLab CI, CircleCI и др.) применимы те же три команды: `yarn install`, `yarn twenty dev:build`, затем `npm publish` из `.twenty/output`.+Для других систем CI (GitLab CI, CircleCI и т. д.) запустите `yarn install`, затем `yarn twenty app:publish`. Provenance создается, когда среда может выпустить токен OIDC, и в противном случае автоматически пропускается.<Note>-**npm provenance** — опционально, но рекомендуется. Публикация с флагом `--provenance` добавляет к вашему пакету в npm значок доверия, позволяя пользователям проверить, что пакет был собран из конкретного коммита в общедоступном конвейере CI. См. инструкции по настройке в [документации по npm provenance](https://docs.npmjs.com/generating-provenance-statements).+**npm provenance** добавляет значок доверия к вашему пакету в npm, позволяя пользователям проверить, что пакет был собран из конкретного коммита в общедоступном конвейере CI. Это также то, что позволяет вам заявить права на ваше приложение в маркетплейсе Twenty. Подробности см. в [документации по npm provenance](https://docs.npmjs.com/generating-provenance-statements).</Note>## Установка приложенийdiff --git a/packages/twenty-docs/l/ru/developers/extend/apps/operations/sync-and-recovery.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/operations/sync-and-recovery.mdxindex 4cbb0f976f7..0d5d2305730 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/operations/sync-and-recovery.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/operations/sync-and-recovery.mdx@@ -12,16 +12,20 @@ icon: compassДля повседневной локальной разработки вам почти всегда нужна команда `yarn twenty dev`. Развертывание и публикация предназначены для выпуска релизов, **а не** для локального цикла разработки.</Note>-| Вы хотите… | Команда | Заметки |-| ---------------------------------------------------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |-| Выполнять локальные итерации с синхронизацией в реальном времени | `yarn twenty dev` | Отслеживает ваши файлы и синхронизирует при каждом изменении. |-| Выполнить одну синхронизацию и выйти (CI, скрипты, хуки) | `yarn twenty dev --once` | Одна сборка + синхронизация, затем завершение работы. |-| Предпросмотр изменений **без их применения** | `yarn twenty dev --once --dry-run` | Вычисляет и выводит diff; ничего не записывает. |-| Удалить приложение из рабочего пространства | `yarn twenty app:uninstall` | Добавьте `--yes`, чтобы пропустить запрос подтверждения. |-| Отправить на сервер tar-архив | `yarn twenty app:publish --private` | Требуется **строго более высокая** версия в `package.json` — см. [Публикация](/l/ru/developers/extend/apps/operations/publishing). |-| Опубликовать на маркетплейсе (npm) | `yarn twenty app:publish` | — |-| Установить / обновить развернутую версию | `yarn twenty app:install` | Устанавливает версию, которая сейчас развернута. |-| Очистить локальный сервер и начать с нуля | `yarn twenty docker:reset` | Удаляет **все** локальные данные — крайняя мера. |+| Вы хотите… | Команда | Заметки |+| ---------------------------------------------------------------- | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |+| Выполнять локальные итерации с синхронизацией в реальном времени | `yarn twenty dev` | Отслеживает ваши файлы и синхронизирует при каждом изменении. |+| Выполнить одну синхронизацию и выйти (CI, скрипты, хуки) | `yarn twenty apply` | Одна сборка + синхронизация, затем завершение работы. Добавьте `--force`, чтобы пропустить подтверждение разрушительных изменений. |+| Предпросмотр изменений **без их применения** | `yarn twenty plan` | Вычисляет и выводит diff; ничего не записывает. |+| Удалить приложение из рабочего пространства | `yarn twenty app:uninstall` | Добавьте `--yes`, чтобы пропустить запрос подтверждения. |+| Отправить на сервер tar-архив | `yarn twenty app:publish --private` | Требуется **строго более высокая** версия в `package.json` — см. [Публикация](/l/ru/developers/extend/apps/operations/publishing). |+| Опубликовать на маркетплейсе (npm) | `yarn twenty app:publish` | — |+| Установить / обновить развернутую версию | `yarn twenty app:install` | Устанавливает версию, которая сейчас развернута. |+| Очистить локальный сервер и начать с нуля | `yarn twenty docker:reset` | Удаляет **все** локальные данные — крайняя мера. |++<Note>+`yarn twenty dev --once` и `yarn twenty dev --once --dry-run` по-прежнему работают как устаревшие псевдонимы для `yarn twenty apply` и `yarn twenty plan`.+</Note>### Для локальной синхронизации не нужно повышать версию@@ -29,19 +33,26 @@ icon: compass## Чтение вывода синхронизации-Каждая синхронизация выводит изменения метаданных, которые она применила (или применила бы, с `--dry-run`):+Каждая синхронизация выводит изменения метаданных, которые она применила (или применила бы, с `plan`), в стиле Terraform — по одному блоку на сущность с её атрибутами, затем строку с итогами:```text filename="Terminal"-Metadata changes: 2 created, 1 updated, 1 deleted- created objectMetadata rocket- created fieldMetadata timelineActivities- updated fieldMetadata launchedAt- deleted pageLayout legacyTab-✓ Synced+ # objectMetadata "rocket" will be created+ + icon = "IconRocket"+ + labelSingular = "Rocket"+ + ...++ # fieldMetadata "launchedAt" will be updated+ ~ isNullable = false -> true++Plan: 2 to add, 1 to change, 1 to destroy.++✓ Synced My App (4 files)```Это ваша первая диагностическая точка: она показывает, какие именно объекты, поля и макеты изменились, чтобы вы могли подтвердить, что синхронизация сделала то, что вы ожидали, до проверки в интерфейсе.+Разрушительные изменения (`to destroy`) перечисляются вместе с тем, что они удаляют (например, `objectMetadata "auditNote" — drops the table and all its rows`) и требуют интерактивного подтверждения или `--force` в скриптах.+Когда синхронизация завершается с ошибкой на одной сущности, в сообщении указываются проблемная сущность и её `universalIdentifier`, например:```text@@ -50,39 +61,42 @@ Migration action 'create' for 'fieldMetadata' (universalIdentifier: 2020...4337)Используйте этот идентификатор, чтобы найти сущность в своем манифесте (и, при необходимости, в рабочем пространстве), вместо того чтобы гадать, какая из них конфликтует.-## Предпросмотр изменений (dry run)+## Предпросмотр изменений (plan)-`yarn twenty dev --once --dry-run` собирает ваш манифест, запрашивает у сервера план миграции и выводит его — **без применения чего-либо**. Это безопасный способ ответить на вопрос «что изменит эта синхронизация?» до того, как вы на неё согласитесь.+`yarn twenty plan` собирает ваш манифест, запрашивает у сервера план миграции и выводит его — **без применения чего-либо**. Это безопасный способ ответить на вопрос «что изменит эта синхронизация?» до того, как вы на неё согласитесь.```bash filename="Terminal"-yarn twenty dev --once --dry-run+yarn twenty plan``````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+Computing metadata plan (read-only, nothing will be applied)...++ # fieldMetadata "crewCapacity" will be created+ + ...++Plan: 1 to add, 1 to change, 0 to destroy.++✓ Plan complete for My App — no changes were applied```-Пробный запуск (dry run):+План:* **Ничего не записывает** — ни миграции метаданных, ни обновления записи приложения, ни изменений ролей/вкладок по умолчанию, ни генерации API‑клиента.* Возвращает **тот же diff**, который применит реальная синхронизация, чтобы вы могли заранее просмотреть создаваемые/обновляемые/удаляемые сущности.* Полезен перед рискованным изменением, при проверке изменения, сгенерированного ИИ, или в скрипте, который должен завершаться с ошибкой, если вот-вот будет применено неожиданное изменение.<Note>-Пробный запуск предварительно показывает только изменения **метаданных** и требует, чтобы приложение хотя бы один раз уже было синхронизировано (чтобы рабочее пространство знало о нём). Если вы запускаете его для приложения, которое никогда не синхронизировалось, сервер сообщит, что приложение не установлено — сначала один раз выполните `yarn twenty dev`.+План только предварительно показывает изменения **метаданных** и требует, чтобы приложение хотя бы один раз уже было синхронизировано (чтобы рабочее пространство знало о нём). Если вы запускаете его для приложения, которое никогда не синхронизировалось, сервер сообщит, что приложение не установлено — сначала один раз выполните `yarn twenty dev`.</Note>## Лестница восстановленияКогда локальные метаданные выглядят неверно, действуйте поэтапно в следующем порядке и останавливайтесь, как только проблема решена. Каждый следующий шаг более разрушителен, чем предыдущий.-1. **Повторно синхронизируйте.** Снова выполните `yarn twenty dev --once`. Синхронизации идемпотентны — повторный запуск корректного манифеста безопасен и часто устраняет временный сбой.-2. **Просмотрите план.** Выполните `yarn twenty dev --once --dry-run`, чтобы увидеть, что именно намеревается изменить следующая синхронизация, не применяя эти изменения.+1. **Повторно синхронизируйте.** Снова выполните `yarn twenty apply`. Синхронизации идемпотентны — повторный запуск корректного манифеста безопасен и часто устраняет временный сбой.+2. **Просмотрите план.** Выполните `yarn twenty plan`, чтобы увидеть, что именно намеревается изменить следующая синхронизация, не применяя эти изменения.3. **Прочитайте сообщение об ошибке.** Если синхронизация завершается с ошибкой, обратите внимание на тип метаданных и `universalIdentifier` в сообщении (см. выше) и найдите эту сущность в своем манифесте. Конфликт обычно указывает на дублированный или повторно используемый идентификатор.4. **Удалите и переустановите.** Выполните `yarn twenty app:uninstall`, затем синхронизируйте снова (`yarn twenty dev`). Это пересобирает метаданные приложения с нуля, сохраняя остальную часть вашего рабочего пространства нетронутой.5. **Полный сброс (крайняя мера).** Выполните `yarn twenty docker:reset`, затем заново выполните начальное наполнение данными и синхронизацию.@@ -107,5 +121,6 @@ Metadata changes: 1 created, 1 updated* **Ошибка сборки манифеста** — CLI завершается с ошибкой до синхронизации (`MANIFEST_BUILD_FAILED`, `TYPECHECK_FAILED`); исправьте исходный код приложения.* **Ошибка синхронизации / миграции** — сборка проходит успешно, но применение diff завершается сбоем с указанием сущности и `universalIdentifier`; исправьте конфликтующие метаданные.+* **Ошибка размера зависимостей** — синхронизация или установка завершается сбоем, потому что продакшен‑зависимости приложения (`dependencies`) слишком велики, чтобы их установить в качестве слоя среды выполнения (`LOGIC_FUNCTION_DEPENDENCIES_SIZE_EXCEEDED`); перенесите пакеты, которые ваши логические функции не импортируют во время выполнения (UI-библиотеки, инструменты разработки), в `devDependencies`.* **Ошибка выполнения кода приложения** — синхронизация проходит успешно, но ваши логические функции или компоненты ведут себя неправильно во время выполнения; проверьте [журналы функций](/l/ru/developers/extend/apps/operations/cli).* **Локальное состояние экземпляра** — ни один из вышеперечисленных пунктов не подходит, и рабочее пространство всё ещё выглядит неправильно; двигайтесь вниз по лестнице восстановления.diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/operations/testing.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/operations/testing.mdxindex d8c920c8192..ad28d7ee613 100644--- a/packages/twenty-docs/l/ru/developers/extend/apps/operations/testing.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/apps/operations/testing.mdx@@ -8,7 +8,7 @@ SDK предоставляет программные API, которые поз## Использование пакетов npm-Вы можете устанавливать и использовать любые пакеты npm в своём приложении. И логические функции, и компоненты фронтенда собираются с помощью [esbuild](https://esbuild.github.io/), который встраивает все зависимости в выходной файл — каталоги `node_modules` во время выполнения не нужны.+Вы можете устанавливать и использовать любые пакеты npm в своём приложении. И логические функции, и компоненты фронтенда собираются с помощью [esbuild](https://esbuild.github.io/), который встраивает их зависимости в выходной файл — каталоги `node_modules` во время выполнения не нужны.### Установка пакета@@ -56,14 +56,16 @@ export default defineFrontComponent({### Как работает бандлинг-Этап сборки использует esbuild для создания одного самодостаточного файла на каждую логическую функцию и на каждый компонент фронтенда. Все импортированные пакеты встроены в бандл.+Этап сборки использует esbuild для создания одного самодостаточного файла на каждую логическую функцию и на каждый компонент фронтенда. Импортированные пакеты встраиваются в бандл, за исключением перечисленных ниже.**Логические функции** выполняются в среде Node.js. Встроенные модули Node (`fs`, `path`, `crypto`, `http` и т. д.) доступны и не требуют установки.-**Компоненты фронтенда** выполняются в Web Worker. Встроенные модули Node **недоступны** — доступны только браузерные API и пакеты npm, работающие в браузерной среде.+**Компоненты фронтенда** выполняются в Web Worker. Встроенные модули Node **недоступны** — доступны только пакеты npm, работающие в браузерной среде. Обратите внимание, что в песочнице реализован *частичный* DOM, поэтому пакет может успешно собраться, но все равно завершиться с ошибкой во время выполнения; см. раздел [Текущие ограничения](/l/ru/developers/extend/apps/layout/front-components#current-limitations).В обеих средах доступны как предварительно предоставленные модули `twenty-client-sdk/core` и `twenty-client-sdk/metadata` — они не включаются в бандл, а подставляются сервером во время выполнения.+Фронтенд‑компоненты также могут совместно использовать зависимости через [общий бандл зависимостей](/l/ru/developers/extend/apps/layout/front-components#sharing-dependencies-across-front-components). Пакеты, перечисленные в поле `frontComponentSharedDependencies` файла package.json приложения, один раз собираются в отдельный файл и загружаются из него во время выполнения вместо внедрения в каждый компонент, поэтому компонент, который импортирует только общие пакеты, практически не содержит собственного кода зависимостей.+## НастройкаПриложение, созданное скэффолдером, уже включает Vitest. Если вы настраиваете его вручную, установите зависимости:@@ -78,6 +80,13 @@ yarn add -D vitest vite-tsconfig-pathsimport tsconfigPaths from 'vite-tsconfig-paths';import { defineConfig } from 'vitest/config';+const TWENTY_API_URL = process.env.TWENTY_API_URL ?? 'http://localhost:2020';+const TWENTY_API_KEY = process.env.TWENTY_API_KEY ?? '<the pre-seeded local dev key>';++// Make env vars available to globalSetup (test.env only applies to workers)+process.env.TWENTY_API_URL = TWENTY_API_URL;+process.env.TWENTY_API_KEY = TWENTY_API_KEY;+export default defineConfig({plugins: [tsconfigPaths({@@ -88,66 +97,74 @@ export default defineConfig({test: {testTimeout: 120_000,hookTimeout: 120_000,+ fileParallelism: false,include: ['src/**/*.integration-test.ts'],- setupFiles: ['src/__tests__/setup-test.ts'],+ globalSetup: ['src/__tests__/global-setup.ts'],env: {- TWENTY_API_URL: 'http://localhost:2020',- TWENTY_API_KEY: 'your-api-key',+ TWENTY_API_URL,+ TWENTY_API_KEY,},},});```-Создайте файл инициализации, который проверяет доступность сервера перед запуском тестов:+Создайте глобальный файл настройки, который проверяет, что сервер доступен, записывает тестовую конфигурацию для SDK (`~/.twenty/config.test.json`) и выполняет синхронизацию приложения перед запуском тестов:-```ts src/__tests__/setup-test.ts+```ts src/__tests__/global-setup.tsimport * 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');+import { appDevOnce, appUninstall } from 'twenty-sdk/cli';-beforeAll(async () => {- // Verify the server is running- const response = await fetch(`${TWENTY_API_URL}/healthz`);+const APP_PATH = process.cwd();+const CONFIG_DIR = path.join(os.homedir(), '.twenty');++export async function setup() {+ const apiUrl = process.env.TWENTY_API_URL!;+ const apiKey = process.env.TWENTY_API_KEY!;+ // Verify the server is running+ const response = await fetch(`${apiUrl}/healthz`);if (!response.ok) {- throw new Error(- `Twenty server is not reachable at ${TWENTY_API_URL}. ` +- 'Start the server before running integration tests.',- );+ throw new Error(`Twenty server is not reachable at ${apiUrl}.`);}- // Write a temporary config for the SDK- fs.mkdirSync(TEST_CONFIG_DIR, { recursive: true });-+ // Write the SDK's test config (the CLI reads config.test.json when NODE_ENV=test)+ fs.mkdirSync(CONFIG_DIR, { recursive: true });fs.writeFileSync(- path.join(TEST_CONFIG_DIR, 'config.json'),+ path.join(CONFIG_DIR, 'config.test.json'),JSON.stringify({- remotes: {- local: {- apiUrl: process.env.TWENTY_API_URL,- apiKey: process.env.TWENTY_API_KEY,- },- },+ remotes: { local: { apiUrl, apiKey } },defaultRemote: 'local',}, null, 2),);-});++ // Start from a clean slate, then sync the app+ await appUninstall({ appPath: APP_PATH }).catch(() => {});++ const result = await appDevOnce({ appPath: APP_PATH });+ if (!result.success) {+ throw new Error(`Dev sync failed: ${result.error?.message}`);+ }+}++export async function teardown() {+ await appUninstall({ appPath: APP_PATH });+}```## Программные API SDKПодпуть `twenty-sdk/cli` экспортирует функции, которые можно вызывать напрямую из тестового кода:-| Функция | Описание |-| -------------- | ---------------------------------------------------------- |-| `appBuild` | Собрать приложение и при необходимости упаковать tar-архив |-| `appDeploy` | Загрузить tar-архив на сервер |-| `appInstall` | Установить приложение в активное рабочее пространство |-| `appUninstall` | Удалить приложение из активного рабочего пространства |+| Функция | Описание |+| -------------- | --------------------------------------------------------------------------------- |+| `appBuild` | Собрать приложение и при необходимости упаковать tar-архив |+| `appDeploy` | Загрузить tar-архив на сервер |+| `appDevOnce` | Один раз собрать и синхронизировать приложение (то же, что и `yarn twenty apply`) |+| `appInstall` | Установить приложение в активное рабочее пространство |+| `appUninstall` | Удалить приложение из активного рабочего пространства |Каждая функция возвращает объект результата с `success: boolean` и либо `data`, либо `error`.@@ -238,64 +255,10 @@ yarn test:watchyarn twenty dev:typecheck```-Это запускает `tsc --noEmit` и сообщает о любых ошибках типов.+Это запускает `tsc --noEmit` для `tsconfig.json` вашего приложения и сообщает о любых ошибках типов. Сгенерированные с помощью скэффолдера приложения также поставляются со скриптом `yarn typecheck`, который проверяет и тестовые файлы (`tsconfig.spec.json`).## CI с GitHub Actions-Скэффолдер генерирует готовый к использованию рабочий процесс GitHub Actions в `.github/workflows/ci.yml`. Он автоматически запускает ваши интеграционные тесты при каждом пуше в `main` и в pull request'ах.--Рабочий процесс:--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 автоматически.+Скэффолдер генерирует готовый к использованию рабочий процесс в `.github/workflows/ci.yml`. При каждом пуше в `main` и каждом pull request он запускает эфемерный сервер Twenty в раннере (через экшен `twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test`), затем выполняет `yarn lint`, `yarn typecheck`, `yarn test:unit` и `yarn test` с `TWENTY_API_URL` / `TWENTY_API_KEY`, указывающими на этот сервер. Секреты не требуются, и вы можете зафиксировать версию сервера через переменную окружения `TWENTY_VERSION` в начале рабочего процесса.-Чтобы закрепить конкретную версию Twenty вместо `latest`, измените переменную окружения `TWENTY_VERSION` в начале рабочего процесса.+См. раздел [Публикация → Автоматизированный CI/CD](/l/ru/developers/extend/apps/operations/publishing#automated-cicd-scaffolded-workflows) для полного пошагового руководства по трем сгенерированным рабочим процессам (`ci.yml`, конвейер деплоя `cd.yml` и `publish.yml` для публикации в npm).diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/translations/overview.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/translations/overview.mdxnew file mode 100644index 00000000000..92f107974f1--- /dev/null+++ b/packages/twenty-docs/l/ru/developers/extend/apps/translations/overview.mdx@@ -0,0 +1,132 @@+---+title: Переводы+description: Выпускайте приложение на нескольких языках — переводите метки манифеста и строки пользовательского интерфейса через единый каталог локалей.+icon: language+---++Приложения Twenty создаются на **английском**: строки в вашем исходном коде и манифесте+являются исходным текстом на английском, `en` — это исходная локаль, с которой вы переводите, а+любая непереведенная локаль будет использовать ее по умолчанию.++В вашем приложении есть два типа переводимого текста, и оба проходят через один и тот же+каталог `locales/`:++* **Метки манифеста** — имена объектов и полей, заголовки представлений, пункты меню и+ другие строки, объявленные в метаданных вашего приложения.+* **Строки фронт-компонента** — пользовательский интерфейс для отображения React фронтальных компонентов.++Вы помечаете переводимые строки, извлекаете их в каталоги для каждой локали,+переводите эти каталоги, и сборка отдает правильный язык для+текущего пользователя — без дополнительной настройки.++## Маркировка переднего компонента++Импортировать помощников перевода из `twenty-sdk/front-component`:++```tsx+import { Trans, t, msg, useTranslate } from 'twenty-sdk/front-component';++const STATUSES = [+ { id: 'draft', label: msg('Draft') },+ { id: 'sent', label: msg('Sent') },+];++const Card = ({ count, name }: { count: number; name: string }) => {+ const { t } = useTranslate();++ return (+ <section>+ {/* Static text — reactive to the user's locale */}+ <Trans>Loading postcard…</Trans>++ {/* Disambiguate identical sources with a context */}+ <Trans context="card-title">Untitled</Trans>++ {/* Interpolation: pass values explicitly */}+ <p>{t('Hi {name}', { name })}</p>+ <p>{t('Saved {count} cards', { count })}</p>++ {/* Resolve a lazily-declared descriptor */}+ <ul>{STATUSES.map((s) => <li key={s.id}>{t(s.label)}</li>)}</ul>+ </section>+ );+};+```++### Когда использовать, какой++* **`Trans`** — статический текст в JSX. Используйте пропсы `message` и `values` для+ интерполяции, как в `Trans message="Hi {name}" values={{ name }}`;+ интерполяция напрямую в дочерних элементах не может быть статически извлечена.+* **`useTranslate().t`** — динамические строки внутри компонента. Повторно отображается, когда+ пользователь переключает язык. Предпочитать это внутри рендера.+* **`t(...)`** (импортировано напрямую) — перевод можно использовать **где**,+ включая обработчики событий, вспомогательные и область модулей — не только внутри рендера.+* **`msg(...)`** — ленивый дескриптор строк, объявленный данными (константы,+ config). Разрешите позже с помощью `t(descriptor)`.++### Контекст++Передайте `context` в недвусмысленный перевод идентичных исходных строк, которые переводят+по-разному:++```tsx+t({ message: 'Open', context: 'door' });+t({ message: 'Open', context: 'window' });+<Trans context="card-title">Untitled</Trans>+```++## Извлечение и перевод++Выполнить команду извлечения из вашей папки приложения:++```bash+twenty dev:translations-extract # collect strings into locales/en.json+twenty dev:translations-extract --locale fr-FR # also scaffold a target locale+```++При извлечении собираются как метки манифеста, так и строки `t()`/`msg()`/`Trans`+из исходного кода вашего фронт‑компонента в `locales/\<locale>.json`, где ключом+является исходная строка. Заполните перевод:++```json+// locales/fr-FR.json+{+ "Loading postcard…": "Chargement de la carte…",+ "Hi {name}": "Bonjour {name}",+ "Saved {count} cards": "{count} cartes enregistrées"+}+```++Такие держатели, как `{name}`, заменяются во время выполнения — сохраняйте их в переводе+. Любая оставленная строка пуста возвращается к исходному тексту.++## Как он запускается++`twenty dev:build` компилирует каталоги и предоставляет нужный язык для+текущего пользователя: метки манифеста разрешаются на стороне сервера, а каталоги фронтенд-компонентов+встраиваются в каждый бандл компонента. Во время выполнения компонент читает локаль+из контекста выполнения (текущий язык узла) и разрешает+каждую строку в соответствии со своим каталогом, возвращение к источнику, когда перевод+отсутствует. Переключение языка в хосте повторно рендерит строки `Trans` и+`useTranslate().t` в реальном времени.++Поскольку каталоги скомпилированы в момент сборки, обновление перевода означает+повторное выполнение `twenty dev:build` (и переразвертывание), то же самое, что и любые другие изменения.++<Note>+Переводы скомпилированы в `twenty dev:build` (и `twenty apply`). В непрерывном часе+показаны исходные строки, поэтому тестовый локализованный вывод+с одноразовой сборкой.+</Note>++Дочерние текстовые элементы `Trans` могут занимать несколько строк — пробельные символы схлопываются+так же, как их схлопывает JSX, поэтому оба этих варианта извлекаются в ключ `Welcome back`:++```tsx+<Trans>Welcome back</Trans>+<Trans>+ Welcome+ back+</Trans>+```diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/ai-agent.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/ai-agent.mdxnew file mode 100644index 00000000000..08f83744737--- /dev/null+++ b/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/ai-agent.mdx@@ -0,0 +1,79 @@+---+title: 5. An AI agent+icon: robot+description: Пусть агент сгенерирует документы из чата, используя ваш инструмент.+---++Потому что `generate-document` выставляется как **инструмент**, агент ИИ может назвать его.+Давайте добавим агента и навыка, чтобы пользователи могли просто сказать *"создать предложение для+Джеффера Гриффина"*.++## Навык++[Навык](/l/ru/developers/extend/apps/logic/skills-and-agents) — это многократно используемые инструкции, то есть знания, которые вы прикрепляете к агентам. Мы учим модель использования+инструмента.++```ts filename="src/skills/document-drafting.skill.ts"+import { defineSkill } from 'twenty-sdk/define';++export default defineSkill({+ universalIdentifier: DOCUMENT_SKILL_UNIVERSAL_IDENTIFIER,+ name: 'document-drafting',+ label: 'Document drafting',+ icon: 'IconFileText',+ content: [+ 'To generate a document, call the `generate-document` tool with:',+ '- `templateId`: the id of the document template to use.',+ '- `recordId`: the id of the Person or Company the document is for.',+ '',+ 'If the user names a template or person instead of an id, find the record first,',+ 'then pass its id. Make sure the template target matches the record type.',+ ].join('\n'),+});+```++## Агент++[Агент](/l/ru/developers/extend/apps/logic/skills-and-agents) сочетает промпт с моделью. Установите `responseFormat` явно во избежание предупреждения о строительстве.++```ts filename="src/agents/document-assistant.agent.ts"+import { defineAgent } from 'twenty-sdk/define';++export default defineAgent({+ universalIdentifier: DOCUMENT_AGENT_UNIVERSAL_IDENTIFIER,+ name: 'document-assistant',+ label: 'Document Assistant',+ description: 'Generates documents from your templates and CRM records.',+ icon: 'IconFileText',+ responseFormat: { type: 'text' },+ prompt: [+ 'You are the Document Assistant for a CRM.',+ 'You help users generate personalized documents from reusable templates',+ 'and the data already in their CRM. Use the generate-document tool, and',+ 'always confirm what you created.',+ ].join(' '),+});+```++<Note>+Агент может вызвать этот инструмент, только если его роль позволяет его. Мы уже установили+`canAccessAllTools: true` и `canBeAssignedToAgents: true` роли приложения в+[Глава 2](/l/ru/developers/extend/apps/tutorials/document-generator/generating-documents#grant-it-access).+</Note>++## Попробовать++Откройте чат с **Document Assistant** и попросите его подготовить черновик документа для+персоны в вашей CRM-системе. Она находит запись, называет `generate-document` и сообщает+обратно созданный документ — который теперь появляется в вашем **Documents** представлении,+точно соответствует командному меню и путям рабочего процесса.++Это отдача от раскрытия логики в качестве инструмента: **одна функция, многие передние двери** —+меню команд, HTTP, шаг рабочего процесса и теперь естественный язык.++**После этого шага:** приложение является полноценным и действительно полезным. Пришло время+отправить его.++<Card title="Далее: публикация →" icon="rocket" href="/l/ru/developers/extend/apps/tutorials/document-generator/publishing">+ Добавить метаданные торговой площадки и опубликовать.+</Card>diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/building-the-ui.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/building-the-ui.mdxnew file mode 100644index 00000000000..f31abdc53cf--- /dev/null+++ b/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/building-the-ui.mdx@@ -0,0 +1,310 @@+---+title: 4. Создание пользовательского интерфейса+icon: table-columns+description: Виды, боковая навигация, команды и передние компоненты.+---++Сейчас объекты доступны только через Настройки. Давайте придадим приложению+реальное присутствие в интерфейсе: представления списков, элементы боковой панели, однокнопочную+команду **Generate document**, фронтенд-компонент на странице записи для **предварительного просмотра**+документа и встроенную вкладку **Editor** с редактором форматированного текста для шаблонов.++## Виды и навигация++[view](/l/ru/developers/extend/apps/layout/views) — это сохраненный список объектов.+[пункт меню навигации](/l/ru/developers/extend/apps/layout/navigation-menu-items)+помещает его в боковую панель. Сервер уже автоматически создает для каждого объекта+представление по умолчанию "All ...", поэтому представления, определяемые приложением,+являются дополнительными, специально отобранными.++```ts filename="src/views/documents.view.ts"+import { defineView } from 'twenty-sdk/define';++export default defineView({+ universalIdentifier: DOCUMENTS_VIEW_UNIVERSAL_IDENTIFIER,+ name: 'All documents',+ objectUniversalIdentifier: DOCUMENT_OBJECT_UNIVERSAL_IDENTIFIER,+ icon: 'IconFile',+ position: 0,+ fields: [+ { universalIdentifier: DOCUMENTS_VIEW_NAME_FIELD_UNIVERSAL_IDENTIFIER,+ fieldMetadataUniversalIdentifier: DOCUMENT_NAME_FIELD_UNIVERSAL_IDENTIFIER,+ position: 0, isVisible: true, size: 280 },+ { universalIdentifier: DOCUMENTS_VIEW_STATUS_FIELD_UNIVERSAL_IDENTIFIER,+ fieldMetadataUniversalIdentifier: DOCUMENT_STATUS_FIELD_UNIVERSAL_IDENTIFIER,+ position: 1, isVisible: true, size: 120 },+ { universalIdentifier: DOCUMENTS_VIEW_TEMPLATE_FIELD_UNIVERSAL_IDENTIFIER,+ fieldMetadataUniversalIdentifier: DOCUMENT_TEMPLATE_FIELD_UNIVERSAL_IDENTIFIER,+ position: 2, isVisible: true, size: 200 },+ ],+});+```++```ts filename="src/navigation-menu-items/documents.navigation-menu-item.ts"+import { defineNavigationMenuItem, NavigationMenuItemType } from 'twenty-sdk/define';++export default defineNavigationMenuItem({+ universalIdentifier: DOCUMENTS_NAVIGATION_MENU_ITEM_UNIVERSAL_IDENTIFIER,+ name: 'Documents',+ icon: 'IconFile',+ color: 'green',+ position: 1,+ type: NavigationMenuItemType.VIEW,+ viewUniversalIdentifier: DOCUMENTS_VIEW_UNIVERSAL_IDENTIFIER,+});+```++Добавьте ту же пару для шаблонов. Оба теперь показываются в боковой панели:++<Frame caption="Документы и шаблоны в боковой панели, со сгенерированным документом.">+ <img src="/images/docs/developers/extends/apps/document-generator/04-documents-view.png" alt="Просмотр документов с созданным документом" />+</Frame>++## Передний компонент++[передний компонент](/l/ru/developers/extend/apps/layout/front-components) — компонент React+внутри Twenty. Наш компонент считывает выбранную запись, загружает+персональные шаблоны через `CoreApiClient` и отправляет POST-запрос на маршрут из прошлого+раздела.++```tsx filename="src/front-components/generate-document-form.front-component.tsx"+import { useEffect, useState } from 'react';+import { CoreApiClient } from 'twenty-client-sdk/core';+import { RestApiClient } from 'twenty-client-sdk/rest';+import { defineFrontComponent } from 'twenty-sdk/define';+import { enqueueSnackbar, useSelectedRecordIds } from 'twenty-sdk/front-component';++const GenerateDocumentForm = () => {+ const selectedRecordIds = useSelectedRecordIds();+ const recordId = selectedRecordIds.length === 1 ? selectedRecordIds[0] : null;+ const [templates, setTemplates] = useState<{ id: string; name: string }[]>([]);+ const [templateId, setTemplateId] = useState('');++ useEffect(() => {+ new CoreApiClient()+ .query({ documentTemplates: {+ __args: { filter: { target: { eq: 'PERSON' } }, first: 100 },+ edges: { node: { id: true, name: true } } } })+ .then(({ documentTemplates }) => {+ const list = documentTemplates?.edges?.map((e) => e.node) ?? [];+ setTemplates(list);+ if (list[0]) setTemplateId(list[0].id);+ });+ }, []);++ const generate = async () => {+ const res = await new RestApiClient().post<{ success: boolean }>(+ '/s/documents/generate',+ { templateId, recordId },+ );+ await enqueueSnackbar({+ message: res.success ? 'Document generated.' : 'Generation failed.',+ variant: res.success ? 'success' : 'error',+ });+ };++ // ...render a <select> of templates and a Generate button+};++export default defineFrontComponent({+ universalIdentifier: GENERATE_DOCUMENT_FORM_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,+ name: 'generate-document-form',+ component: GenerateDocumentForm,+});+```++<Warning>+Стиль с inline CSS переменными (`var(--t-color-blue)`), а не значениями, импортированными из+`twenty-ui`. SDK моктирует этот пакет во время сборки, поэтому импорт модулей уровня+констант темы был бы `неопределённым`. См.+[полный компонент](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/examples/document-generator/src/front-components/generate-document-form.front-component.tsx).+</Warning>++## Команда открытия++[пункт меню команды](/l/ru/developers/extend/apps/layout/command-menu-items) с+`availabilityType: 'RECORD_SELECTION'` отображается при выборе персоны, и+открывает компонент в боковой панели.++```ts filename="src/command-menu-items/generate-document.command-menu-item.ts"+import { defineCommandMenuItem, STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS } from 'twenty-sdk/define';++export default defineCommandMenuItem({+ universalIdentifier: GENERATE_DOCUMENT_COMMAND_UNIVERSAL_IDENTIFIER,+ label: 'Generate document',+ availabilityType: 'RECORD_SELECTION',+ availabilityObjectUniversalIdentifier:+ STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier,+ frontComponentUniversalIdentifier:+ GENERATE_DOCUMENT_FORM_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,+});+```++## Попробуйте весь поток++Откройте **People**, выберите человека и нажмите <kbd>⌘K</kbd> / <kbd>Ctrl K</kbd>.+Появляется "Генерировать документ" с тегом в вашем приложении:++<Frame caption="Эта команда появляется, когда выбран персон.">+ <img src="/images/docs/developers/extends/apps/document-generator/06-command-menu.png" alt="Меню команды с документом Генерировать" />+</Frame>++Запустить — ваш компонент открывается в боковой панели. Выберите шаблон, нажмите+**Сгенерировать** и новые записи земель в **Документах**.++<Frame caption="Передний компонент, загрузка шаблонов и создание клика.">+ <img src="/images/docs/developers/extends/apps/document-generator/06b-front-component.png" alt="Создать панель документа" />+</Frame>++Каждый сгенерированный документ записывает ваше приложение как автора:++<Frame caption="Создано в виде статуса Генератора.">+ <img src="/images/docs/developers/extends/apps/document-generator/05-document-record.png" alt="Созданная запись документа" />+</Frame>++## Предпросмотр документа на странице записи++Передний компонент не только для командных меню — вы можете смонтировать его как \*\*вкладку на странице записи+\*\*. Давайте добавим вкладку *Предварительный просмотр* к документу, который отображает+тело Markdown как отполированную страницу для печати.++Компонент считывает идентификатор текущей записи из своего контекста выполнения, загружает+документ и отображает его. Передние компоненты запускаются в **песочнице**, что позволяет+белым списком HTML тегов (`dangerouslySetInnerHTML`) и+`\<style>`, поэтому мы блокируем Markdown как React elements inline+через маленькие [`Markdown`](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/examples/document-generator/src/utils/markdown-to-react.tsx)+помощника.++```tsx filename="src/front-components/document-viewer.front-component.tsx"+import { CoreApiClient } from 'twenty-client-sdk/core';+import { RestApiClient } from 'twenty-client-sdk/rest';+import { defineFrontComponent } from 'twenty-sdk/define';+import { useFrontComponentExecutionContext } from 'twenty-sdk/front-component';+import { Markdown } from 'src/utils/markdown-to-react';++const DocumentViewer = () => {+ const recordId = useFrontComponentExecutionContext((c) => c.recordId ?? null);+ // ...load { content, file } for recordId, then derive the links:+ const pdfUrl = document.file?.[0]?.url;+ const webUrl = new RestApiClient().resolveUrl('/s/documents/view', {+ query: { id: recordId },+ });++ // Render the template body, plus quick links to the web page and the PDF.+ // Links open in a new tab so they don't navigate the embedded component.+ return (+ <div style={styles.scroll}>+ <div style={styles.actions}>+ <a style={styles.actionLink} href={webUrl} target="_blank" rel="noopener noreferrer">+ Open web page+ </a>+ {pdfUrl ? (+ <a style={styles.actionLink} href={pdfUrl} target="_blank" rel="noopener noreferrer">+ Download PDF+ </a>+ ) : null}+ </div>+ <div style={styles.paper}>+ <div style={styles.body}>+ <Markdown content={document.content} />+ </div>+ </div>+ </div>+ );+};++export default defineFrontComponent({+ universalIdentifier: DOCUMENT_VIEWER_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,+ name: 'document-viewer',+ component: DocumentViewer,+});+```++Монтируйте его с [разметкой](/l/ru/developers/extend/apps/layout/page-layouts). Макет+`RECORD_PAGE` добавляет вкладки к представлению записи объекта; вкладка с одним+виджетом `FRONT_COMPONENT` размещает компонент на всю ширину:++```ts filename="src/page-layouts/document-record.page-layout.ts"+import { definePageLayout, PageLayoutTabLayoutMode } from 'twenty-sdk/define';++export default definePageLayout({+ universalIdentifier: DOCUMENT_PAGE_LAYOUT_UNIVERSAL_IDENTIFIER,+ name: 'Document record page',+ type: 'RECORD_PAGE',+ objectUniversalIdentifier: DOCUMENT_OBJECT_UNIVERSAL_IDENTIFIER,+ tabs: [{+ universalIdentifier: DOCUMENT_PAGE_LAYOUT_TAB_UNIVERSAL_IDENTIFIER,+ title: 'Preview',+ icon: 'IconEye',+ position: 50,+ layoutMode: PageLayoutTabLayoutMode.VERTICAL_LIST,+ widgets: [{+ universalIdentifier: DOCUMENT_PAGE_LAYOUT_WIDGET_UNIVERSAL_IDENTIFIER,+ title: 'Document preview',+ type: 'FRONT_COMPONENT',+ configuration: {+ configurationType: 'FRONT_COMPONENT',+ frontComponentUniversalIdentifier: DOCUMENT_VIEWER_FRONT_COMPONENT_UNIVERSAL_IDENTIFIER,+ },+ }],+ }],+});+```++Откройте любой документ — вкладка **Preview** красиво его отобразит, с ссылками на+общедоступную веб-страницу и PDF:++<Frame caption="Вкладка "Предварительный просмотр" отображает документ в встроенных стилях, а также быстрые ссылки.">+ <img src="/images/docs/developers/extends/apps/document-generator/09-document-viewer.png" alt="Фронтальный компонент просмотра документа в вкладке записи" />+</Frame>++## Редактировать шаблон с редактором rich-text++Шаблонам вообще не нужен пользовательский компонент. Поскольку `body` — это поле+`RICH_TEXT`, Twenty уже предоставляет для него полнофункциональный редактор форматированного текста —+тот же, который используют стандартные объекты Note и Task. Мы просто покрываем его на странице шаблона+.++Добавьте вкладку с виджета `FIELD` в режиме отображения `EDITOR`, указывая на `body`+поле `fieldMetadaId`:++```ts filename="src/page-layouts/template-record.page-layout.ts"+{+ universalIdentifier: TEMPLATE_PAGE_LAYOUT_TAB_UNIVERSAL_IDENTIFIER,+ title: 'Template',+ position: 1,+ layoutMode: PageLayoutTabLayoutMode.GRID,+ widgets: [{+ universalIdentifier: TEMPLATE_PAGE_LAYOUT_WIDGET_UNIVERSAL_IDENTIFIER,+ title: 'Template',+ type: 'FIELD',+ gridPosition: { row: 0, column: 0, rowSpan: 6, columnSpan: 12 },+ configuration: {+ configurationType: 'FIELD',+ fieldMetadataId: TEMPLATE_BODY_FIELD_UNIVERSAL_IDENTIFIER,+ fieldDisplayMode: 'EDITOR',+ },+ }],+}+```++Поле `RICH_TEXT` хранит как блок JSON редактора, так и проекцию Markdown+. Трубопровод поколения гласит, что Markdown проекция, так что+плейсхолдеров, PDF, и общедоступной веб-страницы все работают без изменений —+смотрите полную+[`template-record. age-layout.ts`](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/examples/document-generator/src/page-layouts/template-record.page-layout.ts).+Виджеты `FIELD` также поддерживают другие режимы отображения и параметры, включая+вывод записей вложенной связи на два шага глубже — см. раздел+[справочник по виджетам field](/l/ru/developers/extend/apps/layout/page-layouts#field-widgets).+Теперь редакторы пишут шаблоны в соответствующем rich-text редакторе:++<Frame caption="Вкладка Template tab: родной rich-text редактор, связанный с телом.">+ <img src="/images/docs/developers/extends/apps/document-generator/10-template-editor.png" alt="Запись шаблона с встроенным редактором rich-text" />+</Frame>++**После этого шага:** документы просматривают красиво и шаблоны можно редактировать+в приложении. Далее позвольте агенту ИИ сгенерировать их из чата.++<Card title="Далее: Агент ИИ →" icon="robot" href="/l/ru/developers/extend/apps/tutorials/document-generator/ai-agent">+ Добавьте агента и навык, вызывающий ваш инструмент.+</Card>diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/data-model.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/data-model.mdxnew file mode 100644index 00000000000..858d2ac6e39--- /dev/null+++ b/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/data-model.mdx@@ -0,0 +1,135 @@+---+title: 1. Модель данных+icon: database+description: Типовые документы и шаблоны с объектами, полями и отношениями.+---++Нашему приложению нужны два пользовательских объекта: **шаблоны документов** (что записывать) и+**документы** (сгенерированный результат). Давайте определим их.++Строительство каждого файла сущности с CLI — он генерирует правильный UUID и правую папку+для вас:++```bash filename="Terminal"+yarn twenty dev:add object+```++Ниже мы показываем готовые файлы.++<Note>+Каждый `*_UNIVERSAL_IDENTIFIER` живет в константе+`src/constants/universal-identifiers.ts` и импортируется там, где используется. В приведенных ниже фрагментах+эти импорты опущены для краткости — в своих файлах не удаляйте их.+</Note>++## Объект шаблона++Шаблон имеет `name`, `body` с `{{placeholders}}` и `target`, который+указывает, предназначен ли он для Person или Company. `body` — это поле+`RICH_TEXT`, поэтому двадцать дает ему полный редактор rich-text.++```ts filename="src/objects/document-template.object.ts"+import { defineObject, FieldType } from 'twenty-sdk/define';++export default defineObject({+ universalIdentifier: DOCUMENT_TEMPLATE_OBJECT_UNIVERSAL_IDENTIFIER,+ nameSingular: 'documentTemplate',+ namePlural: 'documentTemplates',+ labelSingular: 'Document template',+ labelPlural: 'Document templates',+ icon: 'IconFileText',+ labelIdentifierFieldMetadataUniversalIdentifier:+ TEMPLATE_NAME_FIELD_UNIVERSAL_IDENTIFIER,+ fields: [+ { universalIdentifier: TEMPLATE_NAME_FIELD_UNIVERSAL_IDENTIFIER,+ type: FieldType.TEXT, name: 'name', label: 'Name', icon: 'IconAbc' },+ { universalIdentifier: TEMPLATE_BODY_FIELD_UNIVERSAL_IDENTIFIER,+ type: FieldType.RICH_TEXT, name: 'body', label: 'Body', icon: 'IconFileText',+ description: 'Use {{placeholders}} like {{name.firstName}} or {{jobTitle}}.' },+ { universalIdentifier: TEMPLATE_TARGET_FIELD_UNIVERSAL_IDENTIFIER,+ type: FieldType.SELECT, name: 'target', label: 'Target', icon: 'IconTarget',+ defaultValue: `'PERSON'`,+ options: [+ { id: TEMPLATE_TARGET_OPTION_PERSON_UNIVERSAL_IDENTIFIER,+ value: 'PERSON', label: 'Person', color: 'blue', position: 0 },+ { id: TEMPLATE_TARGET_OPTION_COMPANY_UNIVERSAL_IDENTIFIER,+ value: 'COMPANY', label: 'Company', color: 'green', position: 1 },+ ] },+ ],+});+```++<Warning>+Опция `SELECT` **values** должна быть `UPPER_CASE` (`PERSON`, не `person`), а опция+`defaultValue` завернута в дополнительные кавычки: `` `'PERSON'` ``. `label` - это то, что видят+пользователей.+</Warning>++## Объект документа++Генерируемый документ хранит отображенный `content` и `status`. Определите+так же с параметром `status` из `DRAFT` / `GENERATED`. Полный файл:+[`document.object.ts`](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/examples/document-generator/src/objects/document.object.ts).++## Связать их с отношением++Каждый документ должен ссылаться на шаблон, из которого он вышел. Отношения+**двусторонний** — вы определяете обе стороны в своём собственном файле полей.++```ts filename="src/fields/document-template-relation.field.ts"+import { defineField, FieldType, OnDeleteAction, RelationType } from 'twenty-sdk/define';++// The "many" side: each document belongs to one template.+export default defineField({+ universalIdentifier: DOCUMENT_TEMPLATE_FIELD_UNIVERSAL_IDENTIFIER,+ objectUniversalIdentifier: DOCUMENT_OBJECT_UNIVERSAL_IDENTIFIER,+ type: FieldType.RELATION,+ name: 'template',+ label: 'Template',+ relationTargetObjectMetadataUniversalIdentifier:+ DOCUMENT_TEMPLATE_OBJECT_UNIVERSAL_IDENTIFIER,+ relationTargetFieldMetadataUniversalIdentifier:+ TEMPLATE_DOCUMENTS_FIELD_UNIVERSAL_IDENTIFIER,+ universalSettings: {+ relationType: RelationType.MANY_TO_ONE,+ onDelete: OnDeleteAction.SET_NULL,+ joinColumnName: 'templateId',+ },+});+```++Другая сторона (`template-documents-relation.field.ts`) — это поле+`RelationType.ONE_TO_MANY` с именем `documents`, которое указывает на противоположный путь.+Смотрите раздел [Relations](/l/ru/developers/extend/apps/data/relations) для полного шаблона.++## Смотрите в двадцать++С запуском `yarn twenty dev` откройте **Settings → Data model**. Оба объекта+появляются, помеченные вашим приложением.++<Frame caption="Оба пользовательских объекта, принадлежащие приложению Генератор документов.">+ <img src="/images/docs/developers/extends/apps/document-generator/01-data-model.png" alt="Настройки модели данных с отображением шаблонов документов и документов" />+</Frame>++Создайте один шаблон для тестирования — имя *Предложение продаж*, установите **цель** на+*Персонал* и вставьте тело с несколькими заполнителями:++```text+Dear {{name.firstName}} {{name.lastName}},++As {{jobTitle}} at {{company.name}}, we think you'll love our product.++Best,+The Team+```++<Frame caption="Запись шаблона. Тело хранит свои заполнители до тех пор, пока документ не будет сгенерирован.">+ <img src="/images/docs/developers/extends/apps/document-generator/03-template-record.png" alt="Запись шаблона предложения продаж с плейсхолдером" />+</Frame>++**После этого шага:** у вас есть объекты `documentTemplate` и `document`, связанные+отношением и одним шаблоном для генерации данных. Далее заполняется логика.++<Card title="Далее: генерация документов →" icon="bolt" href="/l/ru/developers/extend/apps/tutorials/document-generator/generating-documents">+ Напишите логическую функцию, которая заполняет шаблон.+</Card>diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/generating-documents.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/generating-documents.mdxnew file mode 100644index 00000000000..7bb9a069e17--- /dev/null+++ b/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/generating-documents.mdx@@ -0,0 +1,239 @@+---+title: 2. Создание документов+icon: bolt+description: Одна логическая функция, выставленная в качестве инструмента ИИ и действий рабочего процесса.+---++Теперь ядро: [логическая функция](/l/ru/developers/extend/apps/logic/logic-functions)+, загружающая шаблон и запись, заполняет плейсхолдеры, и сохраняет новый документ+.++Однажды мы напишем бизнес-логику как **обработчик**, а затем выявим его через+несколько триггеров. В этой главе выводятся две из них — **ИИ инструмент** и+**действие рабочего процесса**.++## Помощник рендеринга++Держите чистую логику в своем собственном файле, так что легко отсоединить тест. Это преобразует запись+в токены `{{dot.path}}` и подставляет их.++```ts filename="src/logic-functions/utils/render-template.ts"+const PLACEHOLDER_PATTERN = /\{\{\s*([\w.]+)\s*\}\}/g;++export const renderTemplate = (body: string, values: Record<string, string>) => {+ const missingTokens = new Set<string>();+ const content = body.replace(PLACEHOLDER_PATTERN, (_m, token: string) => {+ const value = values[token];+ if (value === undefined || value === '') { missingTokens.add(token); return ''; }+ return value;+ });+ return { content, missingTokens: [...missingTokens] };+};+```++<Tip>+Поскольку этот файл не имеет побочных эффектов, вы можете прочитать его быстрыми модульными тестами+(`yarn test:unit`). См. раздел [Тестирование](/l/ru/developers/extend/apps/operations/testing).+</Tip>++## Обработчик++Обработчик использует [`CoreApiClient`](/l/ru/developers/extend/apps/logic/logic-functions)+для чтения и записи данных CRM. Он загружает шаблон, загружает целевую запись, заполняет+тело и создает `document`.++```ts filename="src/logic-functions/handlers/generate-document-handler.ts"+import { CoreApiClient } from 'twenty-client-sdk/core';+import { loadRecordValues } from 'src/logic-functions/utils/load-record-values';+import { renderTemplate } from 'src/logic-functions/utils/render-template';++export const generateDocumentHandler = async (+ input: { templateId: string; recordId: string },+) => {+ const client = new CoreApiClient();++ // Use a filtered list query, not the singular lookup: the singular query+ // throws when nothing matches, which would become a 500 instead of a 404.+ const { documentTemplates } = await client.query({+ documentTemplates: {+ __args: { filter: { id: { eq: input.templateId } }, first: 1 },+ edges: { node: { id: true, name: true, body: true, target: true } },+ },+ });+ const documentTemplate = documentTemplates?.edges?.[0]?.node;+ if (!documentTemplate?.id) return { success: false, status: 404, message: 'Template not found.' };++ const record = await loadRecordValues(client, documentTemplate.target, input.recordId);+ if (!record.found) return { success: false, status: 404, message: 'Record not found.' };++ const { content, missingTokens } = renderTemplate(documentTemplate.body ?? '', record.values);++ const { createDocument } = await client.mutation({+ createDocument: {+ __args: { data: {+ name: `${documentTemplate.name} — ${record.displayName}`,+ content, status: 'GENERATED', templateId: documentTemplate.id,+ } },+ id: true, name: true,+ },+ });++ return { success: true, documentId: createDocument.id, content, missingTokens };+};+```++`loadRecordValues` запускает другой запрос для персона против компании и flattens+результат — см.+[`load-record-values.ts`](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/examples/document-generator/src/logic-functions/utils/load-record-values.ts).++## Расскажите об этом как инструменте и действии рабочего процесса++Один "defineLogicFunction" может иметь несколько триггеров. Здесь `toolTriggerSettings`+делает его вызываемым агентами ИИ, а `workflowActionTriggerSettings` превращает его в+шаг в визуальном конструкторе рабочих процессов. Оба описывают свои входные данные схемой JSON.++```ts filename="src/logic-functions/generate-document.ts"+import { defineLogicFunction } from 'twenty-sdk/define';+import { jsonSchemaToInputSchema } from 'twenty-sdk/logic-function';+import { GENERATE_DOCUMENT_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER } from 'src/constants/universal-identifiers';+import { generateDocumentHandler } from 'src/logic-functions/handlers/generate-document-handler';+import { generateDocumentInputSchema } from 'src/logic-functions/schemas/generate-document-input.schema';++export default defineLogicFunction({+ universalIdentifier: GENERATE_DOCUMENT_LOGIC_FUNCTION_UNIVERSAL_IDENTIFIER,+ name: 'generate-document',+ description: 'Generate a document from a template and a CRM record.',+ timeoutSeconds: 30,+ toolTriggerSettings: {+ inputSchema: generateDocumentInputSchema,+ },+ workflowActionTriggerSettings: {+ label: 'Generate Document',+ icon: 'IconFileText',+ inputSchema: jsonSchemaToInputSchema(generateDocumentInputSchema),+ outputSchema: [{ type: 'object', properties: {+ success: { type: 'boolean' }, documentId: { type: 'string' },+ } }],+ },+ handler: generateDocumentHandler,+});+```++Входная схема — это обычная схема JSON, описывающая `templateId` и `recordId` —+см. [`generate-document-input.schema.ts`](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/examples/document-generator/src/logic-functions/schemas/generate-document-input.schema.ts).++## Предоставить доступ++Логические функции выполняются под ролью приложения. Ему нужно читать шаблоны и записи+и создавать документы, поэтому разрешите это в `src/roles/default-role.ts`:++```ts+export default defineApplicationRole({+ universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,+ label: 'Document Generator default role',+ canReadAllObjectRecords: true,+ canUpdateAllObjectRecords: true,+ canAccessAllTools: true,+ canBeAssignedToAgents: true,+ permissionFlagUniversalIdentifiers: [SystemPermissionFlag.UPLOAD_FILE],+});+```++`UPLOAD_FILE` позволяет функции загрузить сгенерированный PDF в следующем разделе.+Смотрите [Roles](/l/ru/developers/extend/apps/config/roles) для получения более четких разрешений.++## Прикрепить настоящий PDF-файл++Поля отображаемого текста полезны, но пользователи хотят иметь настоящий документ. Давайте сгенерируем+**PDF** и храним его в записи в качестве загружаемого файла.++Сначала поставьте объект `document` поле `FILES` для удержания PDF. Приложения загружают файлы+в **собственные** файловые поля, поэтому это поле определяет маршрут загрузки:++```ts filename="src/objects/document.object.ts"+{+ universalIdentifier: DOCUMENT_FILE_FIELD_UNIVERSAL_IDENTIFIER,+ type: FieldType.FILES,+ name: 'file',+ label: 'File',+ icon: 'IconFileTypePdf',+ universalSettings: { maxNumberOfValues: 1 },+}+```++Введите, что PDF. Приложение — это настоящий проект Node, поэтому вы можете добавить любой нужный пакет+npm и импортировать его, как и где угодно ещё. Мы используем **[pdf-lib](https://pdf-lib.js.org/)**+для рисования PDF и **[marked](https://marked.js.org/)** для разбора тела Markdown+— CLI устанавливает их во время работы функции:++```bash filename="Terminal"+yarn add pdf-lib marked+```++Полный помощник+[`generate-document-pdf.ts`](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/examples/document-generator/src/logic-functions/utils/generate-document-pdf.ts).+Он анализирует Markdown в токены с `marked. exer`, затем расположите их с помощью+pdf-lib: настоящие заголовки, **черный**/*курсив* пробег, пуля и нумерованные списки,+blockquotes and rules — отполированный, многостраничный A4 рендеринг самого шаблона+вместо стенки текста.++<Frame caption="Сгенерированный PDF: реальная типография и форматирование разметки, отрисовка тела шаблона.">+ <img src="/images/docs/developers/extends/apps/document-generator/07b-generated-pdf.png" alt="Отполированный, продаваемый файл PDF" />+</Frame>++<Note>+Встроенные шрифты pdf-lib используют кодировку WinAnsi, поэтому западноевропейские символы с диакритикой отображаются+"из коробки"; вспомогательная функция отображает типографские кавычки и тире и отбрасывает символы, которые она+не может закодировать. Отображение нелатинских скриптов (китайский, арабский, кириллица) означало бы+встраивание шрифта Unicode.+</Note>++Затем загрузите его и сохраните ссылку на запись. `uploadFile` маршруты байт+в поле файлы, принадлежащее приложению; возвращается `id`, что вы сохраните:++```ts filename="src/logic-functions/handlers/generate-document-handler.ts"+import { MetadataApiClient } from 'twenty-client-sdk/metadata';+import { generateDocumentPdf } from 'src/logic-functions/utils/generate-document-pdf';++const documentName = `${documentTemplate.name} — ${record.displayName}`;+const bytes = await generateDocumentPdf(documentName, content);+const fileName = 'proposal.pdf';++const uploaded = await new MetadataApiClient().uploadFile(+ Buffer.from(bytes),+ fileName,+ 'application/pdf',+ DOCUMENT_FILE_FIELD_UNIVERSAL_IDENTIFIER,+);++await client.mutation({+ updateDocument: {+ __args: {+ id: documentId,+ data: { file: [{ fileId: uploaded.id, label: fileName }] },+ },+ id: true,+ },+});+```++Сгенерированный документ теперь поддерживает загрузку PDF:++<Frame caption="Сгенерированный PDF, хранится в поле File документа.">+ <img src="/images/docs/developers/extends/apps/document-generator/08-document-with-pdf.png" alt="Документ записи с созданным PDF файлом" />+</Frame>++<Note>+`uploadFile` только цели **app-owned** полей файлов (поэтому для загрузки всегда требуется+приложение, которое владеет полем и флаг роли `UPLOAD_FILE`). Поэтому PDF+опирается на собственное поле `file` (`file`) — тот же шаблон, что и+[call-recorder app](https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/public/call-recorder)+используется для записей.+</Note>++**После этого шага:** у каждого сгенерированного документа есть реальный, загружаемый PDF. Но+ничего не может *вызвать* генератор из пользовательского интерфейса — для этого нам нужен HTTP маршрут.++<Card title="Далее: HTTP-маршруты →" icon="земля" href="/l/ru/developers/extend/apps/tutorials/document-generator/http-routes">+ Сервис функции по HTTP и рендеринг документов как веб-страниц.+</Card>diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/http-routes.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/http-routes.mdxnew file mode 100644index 00000000000..8dd1726effc--- /dev/null+++ b/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/http-routes.mdx@@ -0,0 +1,150 @@+---+title: 3. HTTP-маршруты+icon: globe+description: Включает функцию по HTTP и отображает документы как веб-страницы.+---++Этот же обработчик также может отвечать на HTTP-запросы. Мы добавим два маршрута:++* **POST** конечная точка интерфейса для генерации документа, и+* публичная **GET** конечная точка, которая отображает документ в виде печатной веб-страницы.++Оба используют `httpRouteTriggerSettings`. Маршруты приложения доступны по пути `/s/`; на локальных+и самостоятельно размещенных инстансах этот путь обслуживается вашим сервером Twenty+(например, `http://localhost:2020/s/documents/generate`). В Twenty Cloud `RestApiClient`+разрешает путь через домен функций рабочего пространства.++## Маршрут POST — генерировать по запросу++Это повторно использует `generateDocumentHandler`, так что нет логики повторять — просто тонкий+адаптер, который читает тело запроса.++```ts filename="src/logic-functions/generate-document-route.ts"+import { defineLogicFunction, type RoutePayload } from 'twenty-sdk/define';+import { Response } from 'twenty-sdk/logic-function';+import { generateDocumentHandler } from 'src/logic-functions/handlers/generate-document-handler';++const handler = async (event: RoutePayload): Promise<Response> => {+ const body = event.body as Record<string, unknown> | null;++ const result = await generateDocumentHandler({+ templateId: (body?.templateId as string) ?? '',+ recordId: (body?.recordId as string) ?? '',+ });++ // Map the handler's failure reason onto a real HTTP status (400/404/500)+ // instead of always returning 200.+ return new Response(JSON.stringify(result), {+ status: result.success ? 200 : (result.status ?? 400),+ headers: { 'Content-Type': 'application/json' },+ });+};++export default defineLogicFunction({+ universalIdentifier: GENERATE_DOCUMENT_ROUTE_UNIVERSAL_IDENTIFIER,+ name: 'generate-document-route',+ timeoutSeconds: 30,+ handler,+ httpRouteTriggerSettings: {+ path: '/documents/generate',+ httpMethod: 'POST',+ isAuthRequired: true,+ },+});+```++Общий обработчик при сбое возвращает предлагаемое значение `status`, чтобы маршрут+мог ответить корректным кодом `4xx`/`5xx`. `isAuthRequired: true` означает, что звонящий+должен представить действительный токен — передний компонент в следующей главе передает токен доступа пользователя+.++## GET маршрут — отображается как веб-страница++Чтобы вернуть HTML вместо JSON, оберните тело в `Response` с заголовком+`Content-Type`. Этот маршрут является публичным (`isAuthRequired: false`), так что сгенерированный+документ может быть использован как ссылка.++```ts filename="src/logic-functions/view-document.ts"+import { defineLogicFunction, type RoutePayload } from 'twenty-sdk/define';+import { Response } from 'twenty-sdk/logic-function';+import { CoreApiClient } from 'twenty-client-sdk/core';+import { documentHtmlPage } from 'src/utils/render-document';++const htmlResponse = (html: string, status = 200): Response =>+ new Response(html, { status, headers: { 'Content-Type': 'text/html; charset=utf-8' } });++const handler = async (event: RoutePayload): Promise<Response> => {+ const documentId = event.queryStringParameters?.id;++ if (!documentId) {+ return htmlResponse(documentHtmlPage('Missing document id', 'Provide ?id=<documentId>.'), 400);+ }++ // Filtered list query so an unknown id renders a clean 404 page instead of throwing.+ const { documents } = await new CoreApiClient().query({+ documents: {+ __args: { filter: { id: { eq: documentId } }, first: 1 },+ edges: { node: { id: true, name: true, content: true } },+ },+ });++ const document = documents?.edges?.[0]?.node;+ if (!document?.id) {+ return htmlResponse(documentHtmlPage('Document not found', `No document with id ${documentId}.`), 404);+ }++ return htmlResponse(documentHtmlPage(document.name ?? 'Document', document.content ?? ''));+};++export default defineLogicFunction({+ universalIdentifier: VIEW_DOCUMENT_ROUTE_UNIVERSAL_IDENTIFIER,+ name: 'view-document',+ timeoutSeconds: 15,+ handler,+ httpRouteTriggerSettings: {+ path: '/documents/view',+ httpMethod: 'GET',+ isAuthRequired: false,+ },+});+```++`documentHtmlPage` отображает тело Markdown в HTML (с [marked](https://marked.js.org/),+увлажняет) и выбросит его в чистый, страница для печати, которая показывает только содержимое шаблона+— так же, как и PDF и превью для приложений.+[См. помощник](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/examples/document-generator/src/utils/render-document.ts).++## Попробовать++С помощью шаблона и персона в вашей рабочей области, вызовите маршрут (захватите токен из+**Settings → APIs и Webhooks**):++```bash filename="Terminal"+curl -X POST http://localhost:2020/s/documents/generate \+ -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \+ -d '{"templateId":"<templateId>","recordId":"<personId>"}'+# → {"success":true,"documentId":"...","content":"Dear Jeffery Griffin, ..."}+```++Откройте возвращаемый документ в вашем браузере:++```+http://localhost:2020/s/documents/view?id=<documentId>+```++<Frame caption="Публичный GET маршрут отображает документ в виде страницы для печати.">+ <img src="/images/docs/developers/extends/apps/document-generator/07-rendered-document.png" alt="Веб-страница документа" />+</Frame>++<Tip>+Вы также можете транслировать журналы функций в процессе тестирования с помощью+`yarn twenty dev:function:logs` или вызвать их напрямую с помощью+`yarn twenty dev:function:exec`.+</Tip>++**После этого шага:** приложение может генерировать документы по HTTP и отдавать их как+веб-страницы. Теперь давайте сделаем его пригодным для использования без `curl`.++<Card title="Далее: построение пользовательского интерфейса →" icon="table-columns" href="/l/ru/developers/extend/apps/tutorals/document-generator/building-the-ui">+ Виды, навигация, команда и передний компонент.+</Card>diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/overview.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/overview.mdxnew file mode 100644index 00000000000..9a4b368e1c4--- /dev/null+++ b/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/overview.mdx@@ -0,0 +1,67 @@+---+title: "Учебник: Генератор документов"+icon: wand-magic-sparkles+description: Создайте реальное приложение Twenty, которое генерирует персонализированные документы из ваших данных CRM.+---++В этом учебнике вы создадите **Document Generator** — приложение, которое преобразует многоразовые шаблоны в персонализированные документы, используя данные, уже находящиеся в вашей CRM.++Один раз напишите шаблон с `{{placeholders}}`, затем генерируйте заполненный документ для любого Контакта или Компании в один клик — из командного меню, от агента ИИ или из рабочего процесса.++<Frame caption="Один шаблон, сгенерированный для конкретного человека, открыт как страница для печати.">+ <img src="/images/docs/developers/extends/apps/document-generator/07-rendered-document.png" alt="Сгенерированное коммерческое предложение" />+</Frame>++## Чему вы научитесь++Каждая глава добавляет одну возможность. К концу вы познакомитесь с большинством возможностей SDK.++| Глава | Возможность | Справочник |+| --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- |+| [1. Модель данных](/l/ru/developers/extend/apps/tutorials/document-generator/data-model) | Объекты, поля и связь | [Данные](/l/ru/developers/extend/apps/data/overview) |+| [2. Создание документов](/l/ru/developers/extend/apps/tutorials/document-generator/generating-documents) | Логическая функция (инструмент ИИ + действие рабочего процесса), которая заполняет шаблон Markdown и прикрепляет отточенный PDF | [Логические функции](/l/ru/developers/extend/apps/logic/logic-functions) |+| [3. HTTP-маршруты](/l/ru/developers/extend/apps/tutorials/document-generator/http-routes) | Выдача JSON и доступной по ссылке HTML-страницы из маршрутов | [Логические функции](/l/ru/developers/extend/apps/logic/logic-functions) |+| [4. Создание интерфейса](/l/ru/developers/extend/apps/tutorials/document-generator/building-the-ui) | Представления, навигация, командное меню и фронтенд-компоненты, которые показывают предварительный просмотр документа и позволяют редактировать шаблон | [Макет](/l/ru/developers/extend/apps/layout/overview) |+| [5. Агент ИИ](/l/ru/developers/extend/apps/tutorials/document-generator/ai-agent) | Агент + навык | [Навыки и агенты](/l/ru/developers/extend/apps/logic/skills-and-agents) |+| [6. Публикация](/l/ru/developers/extend/apps/tutorials/document-generator/publishing) | Выпустить в маркетплейс | [Публикация](/l/ru/developers/extend/apps/operations/publishing) |++## Требования++К этому моменту вы уже должны были пройти [быстрый старт](/l/ru/developers/extend/apps/getting-started/quick-start):+локальный сервер Twenty, запущенный на порту `2020`, и CLI, аутентифицированный в нем.++Если нет, разверните и запустите его сейчас:++```bash filename="Terminal"+npx create-twenty-app@latest document-generator+cd document-generator+yarn twenty dev+```++<Note>+Предпочитаете читать готовый код? Полное приложение находится в+[`packages/twenty-apps/examples/document-generator`](https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/examples/document-generator).+Каждый фрагмент кода ниже скопирован из него.+</Note>++## Как устроено приложение++<Frame>+ <img src="/images/docs/developers/extends/apps/document-generator/how-it-fits.svg" alt="Шаблон с плейсхолдерами преобразуется в отточенный документ с PDF, запускаемый из командного меню, агентом ИИ, рабочим процессом или общей ссылкой" />+</Frame>++Вы один раз пишете **шаблон** в редакторе форматированного текста с `{{placeholders}}`. Выбор+шаблона и записи CRM заполняет плейсхолдеры и сохраняет отточенный+**документ** (с PDF-файлом). Все остальное — командное меню, агент ИИ,+шаг рабочего процесса, общая ссылка — это всего лишь разные способы запустить+один и тот же генератор.++## Поддерживайте этот цикл++Оставьте `yarn twenty dev` запущенной в терминале на протяжении всего учебника. Каждый раз, когда+вы добавляете или изменяете файл в `src/`, он заново синхронизируется с вашим сервером в течение нескольких+секунд, так что вы можете наблюдать, как каждая новая возможность появляется в интерфейсе по мере ее создания.++<Card title="Начните разработку →" icon="database" href="/l/ru/developers/extend/apps/tutorials/document-generator/data-model">+ Глава 1: моделируем документы и шаблоны.+</Card>diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/publishing.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/publishing.mdxnew file mode 100644index 00000000000..7e016d33716--- /dev/null+++ b/packages/twenty-docs/l/ru/developers/extend/apps/tutorials/document-generator/publishing.mdx@@ -0,0 +1,137 @@+---+title: 6. Публикация+icon: rocket+description: Добавьте метаданные торговой площадки и публикуйте свое приложение.+---++Ваше приложение работает. Последним шагом является его описание для рынка и публикации.++## Добавить метаданные торговой площадки++[Конфигурация приложений](/l/ru/developers/extend/apps/config/application) имеет идентификацию+отображаемую на рынке: автор, категорию, логотип и поддержку+ссылок. Поместите логотип в `public/` и укажите его в `logo`.++```ts filename="src/application-config.ts"+import { defineApplication } from 'twenty-sdk/define';++export default defineApplication({+ universalIdentifier: APPLICATION_UNIVERSAL_IDENTIFIER,+ displayName: 'Document Generator',+ description:+ 'Create reusable document templates and generate personalized documents from your CRM records.',+ logo: 'public/document-generator.svg',+ author: 'Twenty',+ category: 'Productivity',+ websiteUrl: 'https://docs.twenty.com/l/ru/developers/extend/apps',+ termsUrl: 'https://www.twenty.com/terms',+ emailSupport: '[email protected]',+ issueReportUrl: 'https://github.com/twentyhq/twenty/issues',+});+```++<Tip>+Роль по умолчанию объявлена `defineApplicationRole()` в своем собственном файле — вы+больше не передаете `defaultRoleUniversalIdentifier` здесь.+</Tip>++Также добавьте ключевое слово `twenty-app` в `package.json`, чтобы приложение было найдено:++```json filename="package.json"+{ "keywords": ["twenty-app"] }+```++## Добавить скриншоты галереи++Список торговых площадок продается со скриншотами. Поместите несколько PNG-файлов в+`public/gallery/` и укажите их в `galleryImages` — они будут отображаться как галерея+на странице каталога, в порядке следования в массиве.++```ts filename="src/application-config.ts"+export default defineApplication({+ // ...identity from above+ galleryImages: [+ 'public/gallery/01-generated-document.png',+ 'public/gallery/02-command-menu.png',+ 'public/gallery/03-template-editor.png',+ 'public/gallery/04-documents.png',+ ],+});+```++<Tip>+Возглавие с выплатом: сделайте первый скриншот завершённый результат (сгенерированный+документ), затем покажите как он срабатывает и аутентифицирует. Используйте четкие, высококачественные+скриншоты — это первое, что видит пользователь.+</Tip>++Дайте `README.md` ту же обработку — это главная страница npm и GitHub.+Начните с описания ценностного предложения и скриншота, перечислите ключевые функции,+а затем поместите технические детали ниже основной части страницы.++## Проверить перед отправкой++Выполнить те же ворота CI делает:++```bash filename="Terminal"+yarn lint # oxlint+yarn typecheck # tsgo+yarn test:unit # unit tests+yarn twenty plan # preview the metadata diff+```++План точно показывает, что изменится на сервере, не применяя эти изменения —+хорошая финальная проверка. См.+[Testing](/l/ru/developers/extend/apps/operations/testing) и+[Синхронизация и восстановление](/l/ru/developers/extend/apps/operations/sync-and-recovery).++## Публикация++```bash filename="Terminal"+# Public app → npm (default)+yarn twenty app:publish++# Or deploy privately to a specific server's registry+yarn twenty app:publish --private -r <remote>+```++`app:publish` строит и публикует в npm по умолчанию; `--private` загружает+tarball в частный реестр Twenty сервера. Для постройки опубликованного приложения+в магазине экземпляра, запустите синхронизацию каталога:++```bash filename="Terminal"+yarn twenty dev:catalog-sync -r <remote>+```++Подробности и контрольный список для выпуска:+[Публикация](/l/ru/developers/extend/apps/operations/publishing).++## Вы создали приложение 🎉++В шести главах вы использовали большую часть поверхности SDK:++* **Объекты, поля и отношение** для моделирования данных+* **логическая функция** выставлена как **ИИ инструмент**, **действие рабочего процесса** и **HTTP маршруты**+* **Виды, навигация, команда и передний компонент** для интерфейса+* **Агент + навык** для естественного поколения+* **Метаданные торговой площадки** и поток публикаций++Готовое приложение находится по адресу+[`packages/twenty-apps/examples/document-generator`](https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/examples/document-generator).++## Где перейти далее++<CardGroup cols={2}>+ <Card title="Ссылка на данные" icon="database" href="/l/ru/developers/extend/apps/data/overview">+ Каждый параметр типа поля, отношения и индекса.+ </Card>+ <Card title="Ссылка на логику" icon="bolt" href="/l/ru/developers/extend/apps/logic/overview">+ Вызовы cron и события базы данных, хранилище ключевого значения, OAuth соединения.+ </Card>+ <Card title="Ссылка на макет" icon="table-columns" href="/l/ru/developers/extend/apps/layout/overview">+ Панели страниц, виджеты панели управления и другие поверхности интерфейса.+ </Card>+ <Card title="Операции" icon="rocket" href="/l/ru/developers/extend/apps/operations/overview">+ CLI, testing, remotes and CI.+ </Card>+</CardGroup>diff --git a/packages/twenty-docs/l/ru/developers/extend/extend.mdx b/packages/twenty-docs/l/ru/developers/extend/extend.mdxindex 756c1359873..63aa3dac18e 100644--- a/packages/twenty-docs/l/ru/developers/extend/extend.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/extend.mdx@@ -26,7 +26,7 @@ Twenty разработан с учетом расширяемости. Испо<Card title="Вебхуки" icon="bell" href="/l/ru/developers/extend/webhooks">Получайте уведомления о событиях в реальном времени</Card>- <Card title="Приложения" icon="puzzle-piece" href="/l/ru/developers/extend/apps/getting-started">+ <Card title="Приложения" icon="puzzle-piece" href="/l/ru/developers/extend/apps/getting-started/quick-start">Создавайте настройки как код</Card></CardGroup>diff --git a/packages/twenty-docs/l/ru/developers/extend/oauth.mdx b/packages/twenty-docs/l/ru/developers/extend/oauth.mdxindex 2033607ed3a..77868f97bec 100644--- a/packages/twenty-docs/l/ru/developers/extend/oauth.mdx+++ b/packages/twenty-docs/l/ru/developers/extend/oauth.mdx@@ -8,12 +8,12 @@ Twenty реализует OAuth 2.0 с потоком авторизационн## Когда использовать OAuth-| Сценарий | Метод аутентификации |-| ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |-| Внутренние скрипты, автоматизация | [Ключ API](/l/ru/developers/extend/api#authentication) |-| Внешнее приложение, действующее от имени пользователя | **OAuth — авторизационный код** |-| Между серверами, без контекста пользователя | **OAuth — клиентские учётные данные** |-| Приложение Twenty с расширениями пользовательского интерфейса (UI) | [Приложения](/l/ru/developers/extend/apps/getting-started) (OAuth обрабатывается автоматически) |+| Сценарий | Метод аутентификации |+| ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ |+| Внутренние скрипты, автоматизация | [Ключ API](/l/ru/developers/extend/api#authentication) |+| Внешнее приложение, действующее от имени пользователя | **OAuth — авторизационный код** |+| Между серверами, без контекста пользователя | **OAuth — клиентские учётные данные** |+| Приложение Twenty с расширениями пользовательского интерфейса (UI) | [Приложения](/l/ru/developers/extend/apps/getting-started/quick-start) (OAuth обрабатывается автоматически) |## Зарегистрировать клиентаdiff --git a/packages/twenty-docs/l/ru/developers/introduction.mdx b/packages/twenty-docs/l/ru/developers/introduction.mdxindex f36df8b031d..3a72d967fc4 100644--- a/packages/twenty-docs/l/ru/developers/introduction.mdx+++ b/packages/twenty-docs/l/ru/developers/introduction.mdx@@ -6,7 +6,7 @@ description: Создавайте приложения, используйте Aimport { CardTitle } from "/snippets/card-title.mdx"<CardGroup cols={3}>- <Card href="/l/ru/developers/extend/apps/getting-started" img="/images/user-guide/halftone/dev-apps.png">+ <Card href="/l/ru/developers/extend/apps/getting-started/quick-start" img="/images/user-guide/halftone/dev-apps.png"><CardTitle>Приложения</CardTitle>Расширяйте Twenty с помощью пользовательских объектов, серверной логики, UI-компонентов и ИИ-агентов — всё в виде пакетов TypeScript.</Card>diff --git a/packages/twenty-docs/l/ru/developers/self-host/capabilities/docker-compose.mdx b/packages/twenty-docs/l/ru/developers/self-host/capabilities/docker-compose.mdxindex 2e4aa8d1625..878c41a237a 100644--- a/packages/twenty-docs/l/ru/developers/self-host/capabilities/docker-compose.mdx+++ b/packages/twenty-docs/l/ru/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: сервер использует его для сгенерированных ссылок (email‑сообщений, OAuth‑обратных вызовов) и для определения HTTPS для защищённых cookie.#### Понимание `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. Восстановите базу данных:@@ -254,3 +254,9 @@ docker compose up -d## Устранение неполадокЕсли у вас возникли проблемы, проверьте [Устранение неполадок](/l/ru/developers/self-host/capabilities/troubleshooting) для получения решений.++## Управляемый хостинг++<Tip>+ Не хотите запускать и поддерживать Twenty самостоятельно? [Найдите сертифицированного партнёра по хостингу Twenty](https://twenty.com/partners/list?categories=HOSTING\&ref=docs-docker-compose), который развернёт, разместит и полностью возьмёт на себя управление вашим экземпляром. *(Или свяжитесь с нашей командой: [[email protected]](mailto:[email protected]).)*+</Tip>diff --git a/packages/twenty-docs/l/ru/developers/self-host/capabilities/setup.mdx b/packages/twenty-docs/l/ru/developers/self-host/capabilities/setup.mdxindex 1181ab56462..5ffe542f8bb 100644--- a/packages/twenty-docs/l/ru/developers/self-host/capabilities/setup.mdx+++ b/packages/twenty-docs/l/ru/developers/self-host/capabilities/setup.mdx@@ -204,7 +204,13 @@ IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=true* Microsoft Graph: profile* Microsoft Graph: offline_access-Примечание: «Mail.ReadWrite» и «Mail.Send» обязательны только если вы хотите отправлять письма с использованием наших действий рабочего процесса. Вы можете использовать «Mail.Read», если хотите получать только письма.+<Note>+«Mail.ReadWrite» и «Mail.Send» обязательны только если вы хотите отправлять письма с использованием наших действий рабочего процесса. Вы можете использовать «Mail.Read», если хотите получать только письма.+</Note>++<Note>+«Calendars.ReadWrite» является обязательным, если вы хотите создавать события календаря с использованием наших действий рабочего процесса. Если вы хотите только синхронизировать события календаря, используйте «Calendars.Read».+</Note>### Авторизованные URI перенаправления@@ -271,9 +277,9 @@ yarn command:prod cron:workflow:automated-cron-trigger2. Найдите раздел **Электронной почты**.3. Настройте параметры вашего SMTP:-<ArticleTabs label1="Gmail" label2="Office365" label3="Smtp4dev">+<Tabs>- <ArticleTab>+ <Tab title="Gmail">Вам потребуется предоставить [Пароль Приложения](https://support.google.com/accounts/answer/185833).* EMAIL_DRIVER=smtp@@ -282,9 +288,9 @@ yarn command:prod cron:workflow:automated-cron-trigger* EMAIL_SMTP_USER=gmail_email_address* EMAIL_SMTP_PASSWORD='gmail_app_password'- </ArticleTab>+ </Tab>- <ArticleTab>+ <Tab title="Office365">Помните, что если у вас включена двухфакторная аутентификация, вам потребуется предоставить [пароль приложения](https://support.microsoft.com/en-us/account-billing/manage-app-passwords-for-two-step-verification-d6dc8c6d-4bf7-4851-ad95-6d07799387e9).* EMAIL_DRIVER=smtp@@ -293,9 +299,9 @@ yarn command:prod cron:workflow:automated-cron-trigger* EMAIL_SMTP_USER=office365_email_address* EMAIL_SMTP_PASSWORD='office365_password'- </ArticleTab>+ </Tab>- <ArticleTab>+ <Tab title="smtp4dev">**smtp4dev** - это поддельный SMTP почтовый сервер для разработки и тестирования.* Запустите образ smtp4dev: `docker run --rm -it -p 8090:80 -p 2525:25 rnwood/smtp4dev`@@ -305,9 +311,9 @@ yarn command:prod cron:workflow:automated-cron-trigger* EMAIL_SMTP_HOST=localhost* EMAIL_SMTP_PORT=2525- </ArticleTab>+ </Tab>-</ArticleTabs>+</Tabs><Warning>**Режим только для среды:** если вы установили `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, добавьте эти переменные в свой `.env` файл вместо этого.@@ -380,3 +386,28 @@ LOGIC_FUNCTION_TYPE=DISABLED # default when NODE_ENV=production<Note>При использовании `LOGIC_FUNCTION_TYPE=DISABLED` или `CODE_INTERPRETER_TYPE=DISABLED` любая попытка выполнения вернёт ошибку. Это полезно, если вы хотите запускать Twenty без этих возможностей.</Note>++## API и фронтенд на отдельных хостах++Актуально только в том случае, если вы не позволяете бэкенду обслуживать фронтенд. Для развертываний с одинаковым origin+здесь ничего не требуется.++Укажите каждый браузерный origin, который обращается к API, через запятую. `SERVER_URL`+и `FRONTEND_URL` уже считаются доверенными. Сервер записывает предупреждение в журнал, когда браузер+обращается к нему с неуказанного источника.++```bash+AUTH_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/ru/developers/self-host/capabilities/troubleshooting.mdx b/packages/twenty-docs/l/ru/developers/self-host/capabilities/troubleshooting.mdxindex 04fd2ddf5d8..af74d1e0c6a 100644--- a/packages/twenty-docs/l/ru/developers/self-host/capabilities/troubleshooting.mdx+++ b/packages/twenty-docs/l/ru/developers/self-host/capabilities/troubleshooting.mdx@@ -21,7 +21,7 @@ icon: wrench⚠️ ПРЕДУПРЕЖДЕНИЕ: Следующие шаги ПОЛНОСТЬЮ УДАЛЯТ все данные базы данных! ⚠️Продолжайте, только если это новая установка без важной информации.-Чтобы обновить `PG_DATABASE_PASSWORD`, вам нужно:+Для обновления `PG_DATABASE_PASSWORD` необходимо:```sh# Update the PG_DATABASE_PASSWORD in .env@@ -31,7 +31,7 @@ docker compose up -d#### CR разрывы строк обнаружены [Windows]-Это связано с разрывами строк Windows и конфигурацией git. Попробуйте выполнить:+Это происходит из-за строчных символов Windows в сочетании с вашей Git конфигурацией. Попробуйте выполнить:```git config --global core.autocrlf false@@ -43,11 +43,11 @@ git config --global core.autocrlf falseВо время установки Twenty, вам нужно настроить базу данных postgres с правильными схемами, расширениями и пользователями.Если вы успешно выполнили эту настройку, в вашей базе данных должны быть схемы `default` и `metadata`.-Если их нет, убедитесь, что у вас на компьютере не запущено более одного экземпляра postgres.+Если нет, убедитесь, что на вашем компьютере запущено не более одного экземпляра PostgreSQL.#### Невозможно найти модуль 'twenty-emails' или его соответствующие определения типа.-Вам нужно собрать пакет `twenty-emails` перед запуском инициализации базы данных с помощью `npx nx run twenty-emails:build`.+Перед запуском инициализации базы данных вы должны создать пакет `двадцать emails` (`npx nx run twenty-emails:build`).#### Отсутствует пакет twenty-x@@ -55,7 +55,7 @@ git config --global core.autocrlf false#### Lint on Save не работает-Это должно работать из коробки с установленным расширением Oxc (`oxc.oxc-vscode`). Если это не работает, попробуйте добавить это в настройки vscode (на уровне контейнера разработчика):+Это должно работать из коробки с установленным расширением Oxc (`oxc.oxc-vscode`). Если это не работает, попробуйте добавить это в настройки кода VS (область Dev контейнера dev):```"editor.codeActionsOnSave": {@@ -65,7 +65,7 @@ git config --global core.autocrlf false}```-#### При запуске `npx nx start` или `npx nx start twenty-front` возникает ошибка нехватки памяти+#### Во время выполнения `npx nx start` или `npx nx start twenty-front`, произошла ошибка памятиЗапускайте только те сервисы, которые вам нужны, вместо `npx nx start`. Например, если вы работаете на сервере, запускайте только `npx nx worker twenty-server`@@ -74,18 +74,18 @@ git config --global core.autocrlf false`FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memory`-Решение проблемы - выполнить нижеуказанную команду в терминале или добавить её в профиль .bashrc, чтобы настроить автоматически:+Обсуждайтесь с командой ниже в терминале, или добавьте её в свой профиль `.bashrc`, чтобы он применялся автоматически:`export NODE_OPTIONS="--max-old-space-size=8192"`Флаг --max-old-space-size=8192 устанавливает верхний предел 8 ГБ для heap Node.js; использование этого значения зависит от потребностей приложения.Источник: https://stackoverflow.com/questions/56982005/where-do-i-set-node-options-max-old-space-size-2048-**Если это не работает:**-Исследуйте, какие процессы занимают большую часть оперативной памяти вашей машины. В Twenty мы заметили, что некоторые расширения VScode потребляют много оперативной памяти, поэтому мы временно их отключаем.+**Если это не сработает:**+Узнайте, какие процессы занимают большую часть оперативной памяти вашей машины. В Twenty, мы заметили, что некоторые расширения VS Code занимают много оперативной памяти, поэтому мы временно отключили их.-**Если это не работает:**-Перезагрузка вашей машины помогает очистить зависшие процессы.+**Если это не сработает:**+Перезапуск вашей машины помогает очистить привязные процессы.#### При запуске `npx nx start` в логах появляются странные [0] и [1]@@ -99,19 +99,19 @@ git config --global core.autocrlf falsenpx nx worker twenty-server```-#### Не удается подключить свой аккаунт Microsoft 365+#### Не удается подключить мой аккаунт Microsoft 365 к TwentyВ большинстве случаев это происходит из-за того, что ваш администратор не включил лицензию Microsoft 365 для вашего аккаунта. Проверьте [https://admin.microsoft.com/](https://admin.microsoft.com/Adminportal/Home).Если вы получили код ошибки `AADSTS50020`, это, вероятно, означает, что вы используете личную учетную запись Microsoft. Это пока не поддерживается. Подробнее [здесь](https://learn.microsoft.com/fr-fr/troubleshoot/entra/entra-id/app-integration/error-code-aadsts50020-user-account-identity-provider-does-not-exist).-#### При запуске `yarn` появляются предупреждения в консоли+#### При запуске `yarn`, предупреждения появятся в консолиПредупреждения информируют о добавлении дополнительных зависимостей, которые не указаны явно в `package.json`, поэтому, пока не появляются критичные ошибки, всё должно работать как ожидается.-#### Когда пользователь получает доступ к странице входа, в логах появляется ошибка о несанкционированном доступе пользователя к рабочему пространству.+#### Когда пользователь обращается к странице входа в систему, в логах появляется ошибка о неавторизованном пользователе, пытающемся получить доступ к проекту-Это ожидаемо, так как пользователь не авторизован при выходе из системы, поскольку его личность не проверена.+Ожидается, что пользователь не авторизован при выходе из системы, так как их личность не была проверена.#### Как проверить, работает ли ваш воркер?@@ -138,9 +138,9 @@ npx nx worker twenty-server* Если **POST запрос** получен, ваш воркер успешно работает. В противном случае, вам нужно устранить неполадки вашего воркера.-#### Фронтэнд не запускается и выдает ошибку TS5042: Опция 'project' не может быть использована вместе с исходными файлами на командной строке+#### Front-end не удается запустить и возвращает ошибку TS5042: Опция 'project' не может быть смешанной с исходными файлами в командной строке-Закомментируйте плагин checker в `packages/twenty-ui/vite-config.ts`, как показано в примере ниже+Прокомментируйте плагин чекера в `packages/twenty-ui/vite-config.ts`, как показано в приведенном ниже примере:```plugins: [@@ -166,13 +166,35 @@ plugins: [#### Административная панель недоступна-Выполните `UPDATE core."user" SET "canAccessFullAdminPanel" = TRUE WHERE email = '[email protected]';` в контейнере базы данных, чтобы получить доступ к административной панели.+Запустите `UPDATE core."user" SET "canAccessFullAdminPanel" = ПОЛУЧИТЬ ЧЕЕ email = '[email protected]';` в контейнере базы данных, чтобы получить доступ к панели администратора.#### При запуске рабочего процесса выполнение завершается ошибкой: "Выполнение логической функции отключено. Установите LOGIC_FUNCTION_TYPE в значение LOCAL или LAMBDA, чтобы их включить.В производственной среде логические функции по умолчанию отключены. Установите переменную окружения `LOGIC_FUNCTION_TYPE` в `LOCAL` или `LAMBDA`, чтобы их включить. Это можно настроить через переменные окружения или через переменные базы данных в панели администратора. См. [руководство по настройке логических функций](/l/ru/developers/self-host/capabilities/setup#logic-functions-available-drivers) для получения подробной информации.-### Docker Compose в один клик+#### Когда я набираю сообщение в AI чате, оно не отвечает немедленно и я должен обновить страницу, чтобы увидеть ответ++Это означает, что ваш обратный прокси отсутствует конфигурация ответов на потоковый API. Ниже приведен пример конфигурации Nginx:++```+location ~* ^/api/.*stream|\/graphql\/stream {+proxy_pass http://twenty_backend;+proxy_http_version 1.1;+proxy_set_header Connection "";+proxy_set_header Host $host;+proxy_set_header X-Real-IP $remote_addr;+proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;+proxy_set_header X-Forwarded-Proto $scheme;+proxy_buffering off;+proxy_request_buffering off;+proxy_cache off;+gzip off;+#chunked_transfer_encoding off;+add_header X-Accel-Buffering no always;+}+```++### Докер написать 1 клик#### Не удается войти в систему@@ -189,7 +211,7 @@ plugins: [docker compose up -d```-Учтите, что команда database:reset полностью удалит вашу базу данных и создаст её заново.+Обратите внимание, что команда `database:reset` полностью очистит вашу базу данных и пересоздаст ее с нуля.#### Проблемы подключения за обратным проксиdiff --git a/packages/twenty-docs/l/ru/developers/self-host/capabilities/upgrade-guide.mdx b/packages/twenty-docs/l/ru/developers/self-host/capabilities/upgrade-guide.mdxindex 6f3059748dc..9244c7f35e3 100644--- a/packages/twenty-docs/l/ru/developers/self-host/capabilities/upgrade-guide.mdx+++ b/packages/twenty-docs/l/ru/developers/self-host/capabilities/upgrade-guide.mdx@@ -25,11 +25,11 @@ cat databases_backup.sql | docker exec -i {db_container_name_or_id} psql -U {posСервер автоматически выполняет все необходимые миграции обновления при запуске. Ручных команд не требуется.-## Межверсионные обновления (v1.22+)+## Межверсионные обновления (v1.23+)-Начиная с **v1.22**, Twenty поддерживает межверсионные обновления. Вы можете перейти напрямую с любой поддерживаемой версии на последний релиз, не проходя каждую промежуточную версию.+Начиная с **v1.23**, Twenty поддерживает межверсионные обновления. Вы можете перейти напрямую с любой поддерживаемой версии на последний релиз, не проходя каждую промежуточную версию.-Например, полностью поддерживается обновление с v1.22 сразу до v2.0.+Например, полностью поддерживается обновление с v1.23 сразу до v2.0.## Переход на v2.5+ — конверт шифрования данных в состоянии покоя@@ -97,6 +97,6 @@ docker exec -it {server_container_name_or_id} yarn command:prod upgrade:status -Будут показаны только рабочие пространства, которые отстают или завершились с ошибкой, вместе с сообщением об ошибке для каждого сбоя.-## До v1.22+## До v1.23-Если ваш экземпляр старее v1.22, необходимо поэтапно обновляться через каждую основную помеченную версию (с v1.6 до v1.7, затем с v1.7 до v1.8 и так далее) до v1.22. После этого можно перейти сразу на последнюю версию.+Если ваш экземпляр старее v1.23, необходимо поэтапно обновляться через каждую основную помеченную версию (с v1.6 до v1.7, затем с v1.7 до v1.8 и так далее) до v1.23. После этого можно перейти сразу на последнюю версию.diff --git a/packages/twenty-docs/l/ru/getting-started/core-concepts/apps.mdx b/packages/twenty-docs/l/ru/getting-started/core-concepts/apps.mdxindex 6a67e6f06ec..c764348529f 100644--- a/packages/twenty-docs/l/ru/getting-started/core-concepts/apps.mdx+++ b/packages/twenty-docs/l/ru/getting-started/core-concepts/apps.mdx@@ -36,6 +36,6 @@ description: Расширяйте Twenty с помощью кода — польВы пишете своё приложение как TypeScript-проект на своём компьютере. CLI отслеживает ваши исходные файлы и в реальном времени синхронизирует их с запущенным сервером Twenty — редактируйте файл и увидите изменения в интерфейсе за секунду. Типизированный клиент API автоматически пересоздаётся при изменении схемы. Когда будете готовы, `yarn twenty app:publish --private` развернёт приложение на production-сервере, а `yarn twenty app:publish` опубликует его в npm и на маркетплейсе Twenty.-<Card title="Создайте своё первое приложение" icon="arrow-right" href="/l/ru/developers/extend/apps/getting-started">+<Card title="Создайте своё первое приложение" icon="arrow-right" href="/l/ru/developers/extend/apps/getting-started/quick-start">Пошаговое руководство из трёх этапов — создание каркаса, запуск локального сервера, синхронизация изменений.</Card>diff --git a/packages/twenty-docs/l/ru/navigation.json b/packages/twenty-docs/l/ru/navigation.jsonindex ad847cd1f51..a2960307968 100644--- a/packages/twenty-docs/l/ru/navigation.json+++ b/packages/twenty-docs/l/ru/navigation.json@@ -145,6 +145,14 @@"label": "Инструкции"}}+ },+ "legal": {+ "label": "Юридическая информация",+ "groups": {+ "legalHowTos": {+ "label": "Инструкции"+ }+ }}}},@@ -160,6 +168,9 @@"appsGettingStarted": {"label": "Начало работы"},+ "appsTutorial": {+ "label": "Обучение"+ },"appsConfig": {"label": "Конфигурация"},@@ -174,6 +185,9 @@},"appsOperations": {"label": "Операции"+ },+ "appsTranslations": {+ "label": "Переводы"}}},diff --git a/packages/twenty-docs/l/ru/user-guide/ai/capabilities/ai-agents.mdx b/packages/twenty-docs/l/ru/user-guide/ai/capabilities/ai-agents.mdxindex ca10cfd5c07..aa3b813beb7 100644--- a/packages/twenty-docs/l/ru/user-guide/ai/capabilities/ai-agents.mdx+++ b/packages/twenty-docs/l/ru/user-guide/ai/capabilities/ai-agents.mdx@@ -3,10 +3,6 @@ title: Агенты ИИdescription: Интегрируйте возможности ИИ напрямую в рабочие процессы автоматизации.----<Note>-Эта функция находится в разработке и вскоре будет доступна в бета-версии.-</Note>-## ОбзорИнтегрируйте возможности ИИ напрямую в рабочие процессы автоматизации для интеллектуальной обработки данных и принятия решений.diff --git a/packages/twenty-docs/l/ru/user-guide/ai/capabilities/ai-chatbot.mdx b/packages/twenty-docs/l/ru/user-guide/ai/capabilities/ai-chatbot.mdxindex b2373ccb5af..ffdda532cd7 100644--- a/packages/twenty-docs/l/ru/user-guide/ai/capabilities/ai-chatbot.mdx+++ b/packages/twenty-docs/l/ru/user-guide/ai/capabilities/ai-chatbot.mdx@@ -3,13 +3,9 @@ title: Чат-бот на базе ИИdescription: Интеллектуальный помощник, который помогает взаимодействовать с данными вашей CRM на естественном языке.----<Note>-Эта функция находится в разработке и вскоре будет доступна в бета-версии.-</Note>-## Обзор-Интеллектуальный помощник, который помогает взаимодействовать с данными вашей CRM на естественном языке.+Задавайте вопросы на естественном языке и получайте ассистент и объясняйте данные CRM для вас.## Возможностиdiff --git a/packages/twenty-docs/l/ru/user-guide/ai/capabilities/mcp.mdx b/packages/twenty-docs/l/ru/user-guide/ai/capabilities/mcp.mdxindex 8c5a5c01337..20114b9076f 100644--- a/packages/twenty-docs/l/ru/user-guide/ai/capabilities/mcp.mdx+++ b/packages/twenty-docs/l/ru/user-guide/ai/capabilities/mcp.mdx@@ -3,10 +3,6 @@ title: Сервер MCPdescription: Подключайте ИИ-ассистентов к вашему рабочему пространству Twenty с помощью протокола Model Context Protocol.----<Warning>-В настоящее время MCP находится на стадии **alpha** и доступен только в некоторых рабочих пространствах. В вашем рабочем пространстве он может быть ещё не включён.-</Warning>-Twenty предоставляет сервер [MCP](https://modelcontextprotocol.io/), чтобы ИИ-ассистенты — Claude Desktop, Claude Code, Cursor, ChatGPT и другие — могли читать и записывать ваши данные CRM на естественном языке.Используйте **URL рабочей области** (URL, который вы используете для доступа к Twenty) в качестве конечной точки MCP. В Twenty Cloud URL вашей рабочей области может быть `https://{mycompany}.twenty.com` или собственный домен. Сервер доступен по адресу:@@ -72,20 +68,20 @@ Twenty предоставляет сервер [MCP](https://modelcontextprotocoВаш ключ API предоставляет доступ к данным рабочей области. Не храните его в системе контроля версий и общих dotfiles.</Warning>-Чтобы создать ключ API, перейдите в **Settings > APIs & Webhooks > + Create key**. См. [API](/l/ru/developers/extend/api#create-an-api-key) для подробностей.+Чтобы создать ключ API, перейдите в **Settings → MCP & APIs → API → + Create key**. См. [API](/l/ru/developers/extend/api#create-an-api-key) для подробностей.## Быстрый старт### 1. Скопируйте конфигурацию-Перейдите в **Settings > AI > More > MCP Server** в Twenty. Выберите метод аутентификации (OAuth или ключ API), скопируйте фрагмент JSON (в нём уже будет использован URL вашей рабочей области) и вставьте его в файл конфигурации вашего MCP-клиента.+Перейдите в **Settings → MCP & APIs → MCP** в Twenty. Выберите метод аутентификации (OAuth или ключ API), скопируйте фрагмент 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**, затем используйте **Create** в **Settings > Apps & Connectors**, чтобы добавить сервер 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**, затем используйте **Create** в **Settings → Apps & Connectors**, чтобы добавить сервер MCP. |### 2. Подключение@@ -113,7 +109,7 @@ Twenty предоставляет сервер [MCP](https://modelcontextprotocoПодключения MCP наследуют разрешения аутентифицированного пользователя (OAuth) или роль, назначенную ключу API. Чтобы ограничить действия, доступные серверу MCP:* **OAuth**: Применяется роль пользователя в рабочей области.-* **API Key**: Назначьте ключу API роль в **Settings > Roles**. См. [Разрешения](/l/ru/user-guide/permissions-access/capabilities/permissions).+* **API Key**: Назначьте ключу API роль в **Settings → Members → Roles**. См. [Разрешения](/l/ru/user-guide/permissions-access/capabilities/permissions).## Конфигурация для самостоятельного хостингаdiff --git a/packages/twenty-docs/l/ru/user-guide/ai/how-tos/ai-faq.mdx b/packages/twenty-docs/l/ru/user-guide/ai/how-tos/ai-faq.mdxindex 44fd1693d85..a0ea78d146d 100644--- a/packages/twenty-docs/l/ru/user-guide/ai/how-tos/ai-faq.mdx+++ b/packages/twenty-docs/l/ru/user-guide/ai/how-tos/ai-faq.mdx@@ -5,27 +5,27 @@ description: Часто задаваемые вопросы о функциях<AccordionGroup>- <Accordion title="Когда функции ИИ будут доступны?">- Функции ИИ сейчас находятся в разработке и вскоре будут выпущены в бета-версии. Следите за обновлениями!- </Accordion>-- <Accordion title="Какие возможности ИИ планируются?">- Мы разрабатываем две основные возможности ИИ:+ <Accordion title="Какие возможности ИИ доступны?">+ У ИИ есть две основные возможности:1. **ИИ-чат-бот**: контекстный помощник, который может получать доступ к вашим данным в Twenty и помогать с запросами2. **ИИ-агенты в рабочих процессах**: интеллектуальная автоматизация, которая может обрабатывать данные, принимать решения и выполнять задачи в рамках ваших рабочих процессов</Accordion>- <Accordion title="Будут ли ИИ-агенты иметь доступ ко всем моим данным?">- ИИ-агенты будут работать в рамках системы разрешений. Вы можете назначать ИИ-агентам конкретные роли в **Настройки → Участники → Роли**, получая полный контроль над тем, к каким данным у них есть доступ и какие действия они могут выполнять.+ <Accordion title="Есть ли у ИИ-агентов доступ ко всем моим данным?">+ Агенты AI работают под разрешенной системой. Вы можете назначать ИИ-агентам конкретные роли в **Настройки → Участники → Роли**, получая полный контроль над тем, к каким данным у них есть доступ и какие действия они могут выполнять.</Accordion>- <Accordion title="Как будут работать кредиты ИИ?">- Действия ИИ будут расходовать кредиты рабочих процессов в зависимости от сложности задачи и используемой модели ИИ. Дополнительные сведения будут доступны при запуске функций.+ <Accordion title="Как работают кредиты ИИ?">+ Действия ИИ расходуют кредиты рабочих процессов в зависимости от сложности задачи и используемой модели ИИ.</Accordion><Accordion title="Могу ли я использовать собственные модели ИИ?">- Изначально Twenty будет использовать встроенные модели ИИ. Поддержка пользовательских или внешних моделей ИИ может быть добавлена в будущих релизах на основе отзывов пользователей.+ В облаке вы можете использовать только модели ИИ, предоставленные Twenty. В вашем саморазмещённом инстансе вы можете использовать собственные модели ИИ после получения лицензии Organization.+ </Accordion>++ <Accordion title="Я не вижу роль, которую я назначаю агенту ИИ, где это?">+ По умолчанию список ролей отфильтрован так, чтобы показывать только роли, назначаемые участникам рабочего пространства. Если роль присваивается только агентам ИИ, вам нужно изменить фильтр, чтобы включить роли агента AI-Агента.</Accordion></AccordionGroup>diff --git a/packages/twenty-docs/l/ru/user-guide/ai/overview.mdx b/packages/twenty-docs/l/ru/user-guide/ai/overview.mdxindex 23d19ba5bf5..e04d9824a52 100644--- a/packages/twenty-docs/l/ru/user-guide/ai/overview.mdx+++ b/packages/twenty-docs/l/ru/user-guide/ai/overview.mdx@@ -1,15 +1,15 @@---title: ИИ-description: Функции на базе ИИ скоро появятся в Twenty.+description: Функции на базе ИИ в Twenty.---<Frame><img src="/images/user-guide/workflows/robot.png" alt="ИИ" /></Frame>-## Что нового+## Возможности-Twenty разрабатывает возможности ИИ, чтобы помочь вашей команде работать эффективнее. Мы сосредоточены на двух основных направлениях:+В настоящее время Twenty предлагает:### 1. Чат-бот на базе ИИ@@ -46,7 +46,7 @@ Twenty разрабатывает возможности ИИ, чтобы пом## Разрешения и контроль доступа-ИИ-агенты будут управляться через существующую систему разрешений:+ИИ-агенты управляются через существующую систему разрешений:1. Перейдите в **Настройки → Участники → Роли**2. Настройте, к каким данным каждый ИИ-агент может получать доступ@@ -54,9 +54,5 @@ Twenty разрабатывает возможности ИИ, чтобы помЭто гарантирует, что ИИ-агенты соблюдают ваши политики управления данными и получают доступ только к необходимому.-## Будьте в курсе--Мы будем обновлять этот раздел по мере появления функций ИИ. А пока:-* Следите за обновлениями разработки в нашем [GitHub](https://github.com/twentyhq/twenty)* Присоединяйтесь к нашему [Discord](https://discord.gg/UfGNZJfAG6), чтобы делиться отзывами и запросами на функцииdiff --git a/packages/twenty-docs/l/ru/user-guide/billing/capabilities/credits.mdx b/packages/twenty-docs/l/ru/user-guide/billing/capabilities/credits.mdxindex 63a071150f9..c47af7fc8eb 100644--- a/packages/twenty-docs/l/ru/user-guide/billing/capabilities/credits.mdx+++ b/packages/twenty-docs/l/ru/user-guide/billing/capabilities/credits.mdx@@ -13,43 +13,47 @@ description: Один простой баланс, который обеспечСтоимость масштабируется вместе с объемом работы. Повседневные автоматизации и быстрые AI‑сообщения стоят крошечную долю кредита; крупные, многошаговые задачи AI‑агента стоят дороже. Примерно это выглядит так:-| Что вы делаете | Примерная стоимость | Что это означает |-| -------------------------------------------------------------------------------------------- | ------------------------------------- | --------------------------------------- |-| Выполнить стандартный шаг рабочего процесса (поиск, создание, обновление записей) | ~$0.0001 | Около **10 000 шагов на один кредит** |-| Вызвать внешнее API или выполнить узел с кодом | Небольшая доля кредита | Тысячи на один кредит |-| Отправить быстрое AI‑сообщение в чате или простой AI‑шаг | Доля цента | Сотни на один кредит |-| Выполнить крупную задачу AI‑агента (например, «настроить 10 объектов рабочего пространства») | Может стоить **~$1 или больше** | Несколько на один кредит |-| Выполнить AI‑поиск в интернете | Фиксированная стоимость за один поиск | Сотни поисковых запросов на один кредит |+| Что вы делаете | Примерная стоимость | Что это означает |+| ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | --------------------------------------- |+| Запуск стандартного этапа рабочего процесса (поиск, создание или обновление записей) или запуск логической функции приложения | $0.0001 | **10 000 запусков на один кредит** |+| Вызвать внешнее API или выполнить узел с кодом | Небольшая доля кредита | Тысячи на один кредит |+| Отправить быстрое AI‑сообщение в чате или простой AI‑шаг | Доля цента | Сотни на один кредит |+| Выполнить крупную задачу AI‑агента (например, «настроить 10 объектов рабочего пространства») | Может стоить **~$1 или больше** | Несколько на один кредит |+| Выполнить AI‑поиск в интернете | Фиксированная стоимость за один поиск | Сотни поисковых запросов на один кредит |<Note>Для большинства команд стандартные автоматизации фактически бесплатны — заметное снижение баланса произойдет только тогда, когда вы активно используете AI‑функции или запускаете ресурсоемкие узлы с кодом. Так задумано: включенные кредиты предназначены для того, чтобы вы могли создавать решения, не следя за счетчиком.</Note>+<Note>+Не каждое приложение взимает плату за свои запуски. Вызов Рекордер и Последний Контакт реагируют на каждый email и календарь, импортированные в ваше рабочее пространство, поэтому их логическая функция работает бесплатно. С вас по-прежнему взимается плата за их тарифицируемую работу, например за записанные минуты звонков.+</Note>+## Как учитывается использование AI-Когда действие вызывает AI‑модель, мы измеряем точное количество использованных токенов и оцениваем их по **опубликованным тарифам поставщика модели**, затем конвертируем эту сумму в долларах напрямую в кредиты — так что ваши расходы отражают реальную стоимость работы, а не внутренний тариф с наценкой. Короткое сообщение в чате стоит долю цента. Крупная задача агента — например, настройка десяти объектов рабочего пространства — делает много запросов к модели по мере роста контекста, поэтому ее стоимость может достигать доллара или больше. С вас берется плата только за фактическое использование, до уровня отдельного токена.+Когда действие вызывает AI‑модель, мы измеряем точное количество использованных токенов и оцениваем их по **опубликованным тарифам поставщика модели**, затем конвертируем эту сумму в долларах напрямую в кредиты — так что ваши расходы отражают реальную стоимость работы, а не внутренний тариф с наценкой. Короткое сообщение в чате стоит долю цента. Большая задача агента — скажем, настройка 10 объектов рабочей области — делает многие модели вызовом растущего контекста, так что он может добавить до доллара или более. С вас берется плата только за фактическое использование, до уровня отдельного токена.-Стоимость зависит от модели: легковесная модель значительно дешевле за сообщение, чем топовая модель для сложных рассуждений. Вы можете увидеть детализацию по каждому действию — включая используемую модель — в **Настройки → Биллинг**.+Стоимость зависит от модели: легковесная модель значительно дешевле за сообщение, чем топовая модель для сложных рассуждений. Вы можете увидеть детализацию по каждому действию — включая используемую модель — в **Настройки → Оплата**.## Что включеноКаждая подписка включает кредиты, и их количество зависит от **платежного периода**, а не от тарифного плана:-| Платёжный цикл | Включенные кредиты | Эквивалент использования |+| Платёжный цикл | Включенные кредиты | Эквивалентное использование || -------------- | ------------------ | ------------------------------ || Ежемесячно | 5 / месяц | ~$5 использования каждый месяц || Ежегодно | 50 / год | ~$50 использования каждый год |-Эти кредиты рассчитаны на то, чтобы с запасом покрывать повседневную автоматизацию. Пяти кредитов хватает на десятки тысяч стандартных шагов автоматизации или сотни быстрых AI‑сообщений — хотя несколько крупных, многошаговых задач агента могут израсходовать их быстрее. Вы можете пополнить баланс в любой момент (см. ниже).+Эти кредиты рассчитаны на то, чтобы с запасом покрывать повседневную автоматизацию. Пять кредитов покрывают десятки тысяч стандартных шагов автоматизации или сотни быстрых сообщений ИИ — хотя и немного, многоэтапные задачи агента могут использовать их быстрее. Вы можете пополнить баланс в любой момент (см. ниже).## Перенос кредитовНеиспользованные кредиты автоматически переносятся на следующий платежный период.-* **Ограничение**: Перенос ограничен полным объемом за один период, поэтому вы не сможете перенести больше кредитов, чем предусмотрено вашим планом за период.-* **Видимость**: Когда у вас есть перенесенные кредиты, они отображаются отдельной строкой **Перенесенные кредиты** в **Настройки → Биллинг**, рядом с балансом **Всего доступно**.+* **Cap**: Ролловера ограничен в один период в полном объеме, поэтому вы никогда не будете переносить больше, чем ваш платежный цикл за один период.+* **Видимость**: Когда у вас есть перенесенные кредиты, они отображаются отдельной строкой **Перенесенные кредиты** в **Настройки → Оплата**, рядом с балансом **Всего доступно**.-## Отслеживание использования+## Использование мониторингаСледите за своим балансом и тем, на что он расходуется:@@ -64,7 +68,7 @@ description: Один простой баланс, который обеспечЕсли кредиты закончились — или вы хотите иметь запас перед крупным запуском автоматизаций — вы можете в любой момент купить дополнительные пакеты кредитов:1. Перейдите в **Настройки → Оплата**-2. Выберите вариант **Приобрести дополнительные кредиты**-3. Выберите нужное количество+2. Нажмите кнопку **Increase**+3. Выберите нужную сумму и подтвердите измененияПриобретенные кредиты сразу же добавляются к вашему доступному балансу.diff --git a/packages/twenty-docs/l/ru/user-guide/billing/capabilities/pricing-plans.mdx b/packages/twenty-docs/l/ru/user-guide/billing/capabilities/pricing-plans.mdxindex 96f31f2e113..68bf58f2635 100644--- a/packages/twenty-docs/l/ru/user-guide/billing/capabilities/pricing-plans.mdx+++ b/packages/twenty-docs/l/ru/user-guide/billing/capabilities/pricing-plans.mdx@@ -19,7 +19,7 @@ Twenty предлагает гибкие тарифы для команд люб* Стандартная поддержка<Note>-Премиальные функции (SSO, разрешения на уровне строк и данные об использовании ИИ) не включены в тариф Pro.+Премиальные функции (SSO, разрешения на уровне строк, данные об использовании ИИ и многое другое) не включены в тариф Pro.</Note>### Организация (облако)@@ -27,7 +27,7 @@ Twenty предлагает гибкие тарифы для команд любДля крупных команд с расширенными потребностями:* Все, что есть в Pro-* **Премиальные функции**: интеграция SSO, разрешения на уровне строк и данные об использовании ИИ+* **Премиальные функции**: интеграция SSO, разрешения на уровне строк, данные об использовании ИИ и многое другое* Приоритетная поддержка## Планы для самостоятельного размещения@@ -45,7 +45,7 @@ Twenty предлагает гибкие тарифы для команд любДля команд, которым нужны премиальные функции при самостоятельном размещении:* Все возможности Pro-* **Премиальные функции**: интеграция SSO, разрешения на уровне строк и данные об использовании ИИ+* **Премиальные функции**: интеграция SSO, разрешения на уровне строк, данные об использовании ИИ и многое другое* Поддержка от команды Twenty* Не требуется публиковать пользовательский код с открытым исходным кодом перед распространением@@ -56,28 +56,36 @@ Twenty предлагает гибкие тарифы для команд люб* **Интеграция с SSO**: единый вход через вашего поставщика идентификации* **Разрешения на уровне записей**: тонкая настройка управления доступом на уровне записей* **Данные об использовании ИИ**: Отслеживайте потребление ИИ в рабочем пространстве+* **Журналы аудита**: проверяйте, какие действия выполнял каждый участник рабочего пространства+* **Email-кампании**: планируйте, какие письма должны быть отправлены (скоро будет доступно)+* **Неограниченное количество рабочих пространств**: Создавайте столько рабочих пространств, сколько хотите (только для самостоятельного размещения)+* **Приватный исходный код**: Нет необходимости публиковать изменения в общедоступном репозитории (только для самостоятельного размещения)## Переключение планов### Переход на план «Организация»-1. Перейдите в **Настройки → Оплата**+1. Перейдите в **Настройки → Оплата → Тарифы**2. Нажмите **Switch to Organization**3. Подтвердите обновление### Переход на Pro-Свяжитесь со службой поддержки, чтобы понизить ваш план.+1. Перейдите в **Настройки → Оплата → Тарифы**+2. Нажмите **Переключиться на Pro**+3. Подтвердите понижение тарифа### Переход на годовую оплату1. Перейдите в **Настройки → Оплата**-2. Нажмите **Switch to Yearly**+2. Нажмите **Перейти на годовой тариф**3. Экономьте с годовой оплатой### Переход на ежемесячную оплату-Свяжитесь со службой поддержки, чтобы вернуться на ежемесячную оплату.+1. Перейдите в **Настройки → Оплата**+2. Нажмите **Перейти на помесячный тариф**+3. Экономьте с помесячной оплатой## Получите ключ Enterprise для организации (самостоятельный хостинг)diff --git a/packages/twenty-docs/l/ru/user-guide/billing/how-tos/billing-faq.mdx b/packages/twenty-docs/l/ru/user-guide/billing/how-tos/billing-faq.mdxindex 47cc0320f5e..0277360fe64 100644--- a/packages/twenty-docs/l/ru/user-guide/billing/how-tos/billing-faq.mdx+++ b/packages/twenty-docs/l/ru/user-guide/billing/how-tos/billing-faq.mdx@@ -7,9 +7,9 @@ description: Часто задаваемые вопросы о тарифах и<AccordionGroup><Accordion title="Могу ли я использовать Twenty бесплатно, если я размещаю его сам?">-Да, вы можете использовать Twenty бесплатно при самостоятельном размещении. Вы получите доступ ко всему, что включено в план Pro (облако), за исключением поддержки от нашей основной команды. Поддержка доступна через наше сообщество Discord.+Да, вы можете использовать Twenty бесплатно при самостоятельном размещении. Вы получите доступ ко всему, что включено в план Pro (Облачно), за исключением поддержки от нашей основной команды. Поддержка доступна через наше сообщество Discord.-Если вы хотите использовать самостоятельный хостинг и вам нужны Премиум-функции (SSO и разрешения на уровне записей), вы можете выбрать платную лицензию Organization (Self-Hosted). Это также включает поддержку от команды Twenty и снимает требование публиковать пользовательский код с открытым исходным кодом перед распространением.+Если вы хотите использовать самостоятельный хостинг и вам нужны Премиум-функции (SSO, разрешения на уровне записей и другое), вы можете выбрать платную лицензию Organization (Self-Hosted). Это также включает поддержку от команды Twenty и снимает требование публиковать пользовательский код с открытым исходным кодом перед распространением.</Accordion><Accordion title="Какие премиум‑функции доступны?">@@ -17,30 +17,34 @@ description: Часто задаваемые вопросы о тарифах и* **Интеграция с SSO**: единый вход с вашим провайдером идентификации* **Разрешения на уровне записей**: детализированное управление доступом на уровне записей* **Данные об использовании ИИ**: Отслеживайте потребление ИИ в рабочем пространстве+* **Журналы аудита**: проверяйте, что делает каждый участник рабочего пространства+* **Email-кампании**: планируйте, какие письма должны быть отправлены (скоро будет доступно)+* **Неограниченное количество рабочих пространств**: Создавайте столько рабочих пространств, сколько хотите (только для самостоятельного размещения)+* **Частный исходный код**: не требуется публиковать изменения в общедоступном репозитории (только для самостоятельного хостинга)</Accordion>-<Accordion title="Одинаков ли тариф Organization в облаке и в самостоятельно размещаемой версии?">+<Accordion title="Планирует ли Облако и Самостоятельная Организация?">Они предлагают одинаковые премиум-функции. Однако облачную подписку нельзя использовать для развертываний на собственном хостинге. Для самостоятельно размещаемой версии требуется ключ Enterprise.</Accordion><Accordion title="Предлагаете ли вы бесплатные места для пользователей с правами только просмотра?">-Мы не предлагаем бесплатные места. Стоимость рассчитывается на каждого пользователя, и каждый пользователь нуждается в лицензии для доступа к Twenty.+Мы не предлагаем бесплатные места. Цены указаны для каждого пользователя, и каждому пользователю нужна лицензия на доступ к Twenty.</Accordion><Accordion title="Где я могу переключить свою подписку на план Organization?">-Вы можете сделать это в разделе `Настройки → Оплата`. Затем нажмите на `Переключить на Organization`.+Вы можете сделать это в разделе `Settings → Billing → Plans`. Затем нажмите на `Переключить на Organization`.</Accordion><Accordion title="Где я могу переключить свою подписку на план Pro?">-Пожалуйста, свяжитесь с нашей командой напрямую через раздел «Поддержка», в данный момент нет простого способа сделать это через пользовательский интерфейс.+Вы можете сделать это в разделе `Settings → Billing → Plans`. Затем нажмите на `Switch to Pro`.</Accordion><Accordion title="Где я могу переключить свою подписку на годовой период?">-Вы можете сделать это в разделе `Настройки → Оплата`. Затем нажмите на `Switch to Yearly`.+Вы можете сделать это в разделе `Настройки → Оплата`. Затем нажмите на `Upgrade to yearly`.</Accordion><Accordion title="Где я могу переключить свою подписку на ежемесячный период?">-Пожалуйста, свяжитесь с нашей командой напрямую через Поддержку, в данный момент нет простого способа сделать это через пользовательский интерфейс.+Вы можете сделать это в разделе `Настройки → Оплата`. Затем нажмите на `Downgrade to monthly`.</Accordion><Accordion title="Где я могу посмотреть расход кредитов?">@@ -55,16 +59,21 @@ description: Часто задаваемые вопросы о тарифах и<Accordion title="Как работает расход кредитов для рабочих процессов?">Каждое действие рабочего процесса потребляет кредиты в зависимости от своей сложности:-* **Основные внутренние операции** (такие как поиск, обновление, создание записей) потребляют очень мало кредитов+* **Основные внутренние операции** (например, поиск, обновление или создание записей) потребляют очень мало кредитов* **Более сложные операции**, такие как узлы кода и запросы к внешним службам, потребляют больше кредитов-* **Запросы AI** (скоро будут) также будут потреблять больше кредитов в зависимости от использования+* **AI-промпты** также потребляют больше кредитов в зависимости от использования+* **Приложения** также расходуют больше кредитов подобно узлам кода-Кредиты списываются в режиме реального времени при выполнении рабочих процессов. Вы можете отслеживать использование в **Настройки → Биллинг**, чтобы контролировать расход и оставшиеся кредиты.+Кредиты списываются в режиме реального времени при выполнении рабочих процессов или приложений. Вы можете отслеживать использование в **Настройки → Биллинг**, чтобы контролировать расход и оставшиеся кредиты.</Accordion><Accordion title="Могу ли я купить больше кредитов для рабочих процессов?">Вы можете купить дополнительные кредиты в разделе `Настройки → Оплата`.</Accordion>++<Accordion title="Могу ли я купить больше кредитов для рабочих процессов только на 1 месяц?">+Да, зайдите в `Settings → Billing`, нажмите кнопку `Increase`, выберите сколько кредитов вы хотите, и подтвердите. Они будут поданы на текущий расчетный период. Затем снова нажмите кнопку `Increase`, измените значение обратно на оригинал, и подтвердить — понижение будет применено начиная со следующего расчетного периода.+</Accordion></AccordionGroup>## Биллинг@@ -85,4 +94,12 @@ description: Часто задаваемые вопросы о тарифах и<Accordion title="Где я могу получить доступ к своим счетам?">Вы можете сделать это в разделе `Настройки → Оплата`. Затем нажмите на `Просмотр сведений о платеже`. Все ваши счета будут видны в нижней части экрана.</Accordion>++<Accordion title="Почему количество мест отличается от количества пользователей в моем рабочем пространстве?">+Количество мест рабочего пространства синхронизируется с платежной системой каждые 6 часов; счета корректируются на основе разницы.+</Accordion>++<Accordion title="Почему я получил счет за нового участника рабочего пространства?">+При добавлении нового участника проекта в рабочую область высылается счет-фактура на покрытие расхождения. Когда участник рабочего пространства удаляется, изменение применяется в следующем стандартном ежемесячном/годовом счете.+</Accordion></AccordionGroup>diff --git a/packages/twenty-docs/l/ru/user-guide/billing/overview.mdx b/packages/twenty-docs/l/ru/user-guide/billing/overview.mdxindex a3d3286bb2a..22f58b782b5 100644--- a/packages/twenty-docs/l/ru/user-guide/billing/overview.mdx+++ b/packages/twenty-docs/l/ru/user-guide/billing/overview.mdx@@ -18,12 +18,12 @@ Twenty предлагает гибкие тарифные планы, соотв## Краткий обзор-| План | Ключевые функции |-| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |-| **Бесплатно (самостоятельный хостинг)** | Все функции Pro, поддержка сообщества |-| **Pro (облако)** | Всё, кроме функций Premium (SSO и разрешения на уровне строк), стандартная поддержка |-| **Организация (облако)** | Всё из Pro + функции Premium (SSO и разрешения на уровне строк), приоритетная поддержка |-| **Организация (самостоятельный хостинг)** | Всё из Pro + функции Premium (SSO, разрешения на уровне строк), поддержка команды Twenty, не требуется публиковать ваш пользовательский код как программное обеспечение с открытым исходным кодом перед распространением |+| План | Ключевые функции |+| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |+| **Бесплатно (самостоятельный хостинг)** | Все функции Pro, поддержка сообщества |+| **Pro (облако)** | Всё, кроме функций Premium (SSO, разрешения на уровне строк и другое), стандартная поддержка |+| **Организация (облако)** | Всё из Pro + функции Premium (SSO, разрешения на уровне строк и другое), приоритетная поддержка |+| **Организация (самостоятельный хостинг)** | Всё из Pro + функции Premium (SSO, разрешения на уровне строк и другое), поддержка команды Twenty, не требуется публиковать ваш пользовательский код как программное обеспечение с открытым исходным кодом перед распространением |## Быстрые ответыdiff --git a/packages/twenty-docs/l/ru/user-guide/calendar-emails/capabilities/mailbox.mdx b/packages/twenty-docs/l/ru/user-guide/calendar-emails/capabilities/mailbox.mdxindex f9776a41371..c045703cbc1 100644--- a/packages/twenty-docs/l/ru/user-guide/calendar-emails/capabilities/mailbox.mdx+++ b/packages/twenty-docs/l/ru/user-guide/calendar-emails/capabilities/mailbox.mdx@@ -15,7 +15,7 @@ Twenty автоматически связывает письма из ваши* **Люди**: просмотр всех писем, обмененных с определенным контактом* **Компании**: просмотр всех писем, связанных с компанией и её сотрудниками-* **Возможности**: доступ к веткам электронной почты, связанным с компанией, связанной с этой возможностью. Ветки электронной почты от отдельных людей по этой возможности пока не отображаются.+* **Возможности**: доступ к потокам электронной почты, связанным с этой возможностью. Ветки электронной почты от отдельных людей по этой возможности пока не отображаются.### Просмотр почтовых веток@@ -62,14 +62,21 @@ Twenty импортирует письма примерно со скорост* **Внешние письма**: все письма с контактами вне вашей организации* **Автоматическое связывание**: электронные письма связываются с существующими записями Людей и Компаний* **Несколько адресов**: письма с любого адреса связываются с той же контактной записью-* **Обновления**: новые письма появляются в течение 5 минут+* **Обновления**: новые письма появляются сразу### Что не синхронизируется-* **Внутренние письма**: письма между коллегами (один и тот же домен) остаются частными+* **Внутренние письма**: по умолчанию письма между коллегами (один домен) остаются приватными (настраивается в Настройки → Общие → Безопасность)* **Групповые письма**: списки рассылки и групповые письма исключены* **Исключенные папки**: папки, которые вы выбрали не синхронизировать (настроено в разделе Настройки → Аккаунты → Электронная почта)+### Внутренняя почта++Выберите, будут ли внутренние письма синхронизироваться в Twenty:++1. Перейдите в **Настройки → Общие → Безопасность**+2. Переключите **Синхронизировать внутренние письма** в положение вкл./выкл.+### Выборочная синхронизация папокУправляйте, какие папки электронной почты синхронизируются с Twenty:@@ -82,7 +89,7 @@ Twenty импортирует письма примерно со скорост### Общие проблемы синхронизации-* **Задержки синхронизации**: письма появляются в течение 5 минут, но начальный импорт занимает больше времени+* **Задержки синхронизации**: письма появляются сразу, но начальный импорт занимает больше времени* **Отсутствующие письма**: проверьте, если:* Папки исключены в настройках Папки сообщений* Автоматическое создание контактов отключено (письма требуют существующих записей в Twenty)diff --git a/packages/twenty-docs/l/ru/user-guide/calendar-emails/how-tos/can-i-book-meetings-from-twenty.mdx b/packages/twenty-docs/l/ru/user-guide/calendar-emails/how-tos/can-i-book-meetings-from-twenty.mdxindex 5d8cf9a8ed2..49c536e47c1 100644--- a/packages/twenty-docs/l/ru/user-guide/calendar-emails/how-tos/can-i-book-meetings-from-twenty.mdx+++ b/packages/twenty-docs/l/ru/user-guide/calendar-emails/how-tos/can-i-book-meetings-from-twenty.mdx@@ -5,9 +5,17 @@ description: Информация о назначении встреч непо## Текущий статус-**Нет, в настоящее время в Twenty нельзя напрямую назначать встречи.**+Интеграция календаря Twenty предназначена для того, чтобы **синхронизировать и отображать** ваши существующие события календаря.-Интеграция календаря Twenty предназначена для того, чтобы **синхронизировать и отображать** ваши существующие события календаря, а не создавать новые. Все планирование встреч следует выполнять через ваше родное приложение календаря (Google Calendar, Microsoft Outlook и т. д.).+## Планирование встреч через рабочие процессы++Хотя планировать встречи невозможно вручную, вы можете планировать их в двадцати используя рабочие процессы.++1. Создайте новый рабочий процесс+2. Выберите любой триггер в зависимости от ваших потребностей+3. Добавьте узел **Create Calendar Event**+4. Настройте все необходимые данные+5. Активируйте рабочий процесс## Что вы можете сделать@@ -15,14 +23,3 @@ description: Информация о назначении встреч непо* **Просматривать предстоящие встречи** с контактами в вашей CRM* **Отслеживать контекст встреч** наряду с электронной перепиской* **Автоматически создавать контакты** из участников встреч--## Как назначать встречи--1. Используйте ваше родное приложение календаря (Google Calendar, Outlook и т. д.)-2. Создайте встречу как обычно-3. Встреча автоматически синхронизируется с Twenty в течение 5 минут-4. Просматривайте встречу в соответствующих записях CRM--## Планы на будущее--В нашей дорожной карте запланирована возможность создания встреч прямо в Twenty. Присоединяйтесь к нашим [обсуждениям на GitHub](https://github.com/twentyhq/twenty/discussions), чтобы поделиться своим сценарием использования и помочь расставить приоритеты для этой функции.diff --git a/packages/twenty-docs/l/ru/user-guide/calendar-emails/how-tos/can-i-send-emails-from-twenty.mdx b/packages/twenty-docs/l/ru/user-guide/calendar-emails/how-tos/can-i-send-emails-from-twenty.mdxindex f46b36fd91b..46257074558 100644--- a/packages/twenty-docs/l/ru/user-guide/calendar-emails/how-tos/can-i-send-emails-from-twenty.mdx+++ b/packages/twenty-docs/l/ru/user-guide/calendar-emails/how-tos/can-i-send-emails-from-twenty.mdx@@ -5,9 +5,18 @@ description: Информация об отправке писем непоср## Текущий статус-Интеграция электронной почты Twenty предназначена для того, чтобы **синхронизировать и отображать** вашу историю переписки по электронной почте. Письма нельзя составлять или отправлять непосредственно из интерфейса Twenty.+Интеграция электронной почты Twenty предназначена для того, чтобы **синхронизировать и отображать** вашу историю переписки по электронной почте, а также создавать и отправлять письма.-Когда вы просматриваете цепочку писем на странице записи и нажимаете **Ответить**, вы будете перенаправлены к исходной переписке в своём почтовом ящике (Gmail, Outlook и т. п.). Именно там вы создаёте и отправляете свой ответ.+Когда вы просматриваете цепочку писем на странице записи и нажимаете **Ответить**, вы можете напрямую создать и отправить письмо.++## Как отправить сообщение из Twenty++Предварительное условие: подключённая учётная запись почты с возможностью отправки писем++1. Откройте командное меню с помощью сочетания клавиш **Ctrl+K** или **Cmd+K**+2. Выберите пункт «Написать письмо»+3. Выберите получателей, добавьте тему, текст и вложения к вашему письму+4. Нажмите кнопку «Отправить», чтобы отправить письмо## Что вы можете делать уже сегодня@@ -19,7 +28,7 @@ description: Информация об отправке писем непоср## Отправка писем через рабочие процессы-Хотя вы не можете отправлять письма вручную из Twenty, вы **можете автоматически отправлять письма с помощью рабочих процессов**. Это полезно для:+Вы **можете автоматически отправлять письма с помощью рабочих процессов**. Это полезно для:* Автоматические последующие письма* Уведомления контактамdiff --git a/packages/twenty-docs/l/ru/user-guide/calendar-emails/how-tos/connect-several-mailboxes-per-user.mdx b/packages/twenty-docs/l/ru/user-guide/calendar-emails/how-tos/connect-several-mailboxes-per-user.mdxindex 276b4938ccc..5ced1e6d2e0 100644--- a/packages/twenty-docs/l/ru/user-guide/calendar-emails/how-tos/connect-several-mailboxes-per-user.mdx+++ b/packages/twenty-docs/l/ru/user-guide/calendar-emails/how-tos/connect-several-mailboxes-per-user.mdx@@ -15,7 +15,7 @@ Twenty поддерживает **неограниченное количест1. Перейдите в **Настройки → Аккаунты**2. Нажмите **Добавить аккаунт**-3. Подключите дополнительную учетную запись Google или Microsoft+3. Подключите дополнительный аккаунт Google или Microsoft либо аккаунт любого другого почтового провайдера, поддерживающего протоколы IMAP/SMTP4. Настройте параметры синхронизации для этого почтового ящика5. Повторите для каждого почтового ящика, который вы хотите подключить@@ -35,7 +35,7 @@ Twenty поддерживает **неограниченное количест* **Записи компаний**: на основе домена электронной почты* **Возможности**: на основе связанной компании-<Note>В каждом письме указано, из какого почтового ящика оно отправлено/в какой получено, поэтому вы можете отслеживать, какой аккаунт использовался для каждого общения.</Note>+<Note>В каждом письме указано, из какого почтового ящика оно отправлено или в каком получено, поэтому вы можете отслеживать, какой аккаунт использовался для каждого общения.</Note>## Важные замечанияdiff --git a/packages/twenty-docs/l/ru/user-guide/calendar-emails/how-tos/limit-emails-imported.mdx b/packages/twenty-docs/l/ru/user-guide/calendar-emails/how-tos/limit-emails-imported.mdxindex 831265a5ca6..afa0001315d 100644--- a/packages/twenty-docs/l/ru/user-guide/calendar-emails/how-tos/limit-emails-imported.mdx+++ b/packages/twenty-docs/l/ru/user-guide/calendar-emails/how-tos/limit-emails-imported.mdx@@ -22,7 +22,7 @@ description: Управляйте тем, какие письма импорти| **Архив** | Архивированные сообщения || **Пользовательские папки** | Любые нужные вам папки |-6. Исключите папки, которые вы не хотите синхронизировать (Спам, Корзина, личные папки)+4. Исключите папки, которые вы не хотите синхронизировать (Спам, Корзина, личные папки)<Note>Это даёт вам точный контроль над тем, какие письма отображаются в вашей CRM, без синхронизации всего.</Note>@@ -37,14 +37,22 @@ description: Управляйте тем, какие письма импорти* **Отправленные и полученные**: Создавать контакты из всех внешних писем* **Только отправленные**: Создавать контакты только из писем, которые вы отправляете+## Внутренние письма++Сообщения между коллегами (один и тот же домен) могут синхронизироваться в Twenty:++1. Перейдите в **Настройки → Общие → Безопасность**+2. Переключите **Синхронизировать внутренние письма** в положение вкл./выкл.++<Note>По умолчанию этот параметр отключен.</Note>+## Что всегда исключаетсяЭти письма никогда не синхронизируются, независимо от настроек:-* **Внутренние письма**: сообщения между коллегами (один и тот же домен)* **Групповые письма**: списки рассылки и групповые сообщения* **Спам/Корзина**: системные папки обычно исключаются## Важное замечание-<Note>Мы не предоставляем адрес электронной почты CC для выборочной синхронизации. Используйте функцию выбора папок выше, чтобы добиться такого же уровня контроля.</Note>+<Note>Пока мы не предоставляем адрес электронной почты CC для выборочной синхронизации. Используйте функцию выбора папок выше, чтобы добиться такого же уровня контроля.</Note>diff --git a/packages/twenty-docs/l/ru/user-guide/calendar-emails/overview.mdx b/packages/twenty-docs/l/ru/user-guide/calendar-emails/overview.mdxindex 1b1ec627008..92acf4898c4 100644--- a/packages/twenty-docs/l/ru/user-guide/calendar-emails/overview.mdx+++ b/packages/twenty-docs/l/ru/user-guide/calendar-emails/overview.mdx@@ -67,7 +67,7 @@ OUTBOUND_HTTP_SAFE_MODE_ENABLED=false### Автоматическое создание контактов* **Отключено**: Автоматическое создание контактов не производится-* **Для отправленных и полученных сообщений**: Создайте контакты для всех внешних email-интеракций+* **Для отправленных и полученных сообщений**: создание контактов для всех внешних взаимодействия по электронной почте* **Только для отправленных сообщений**: Создайте контакты только для отправленных вами писем* **Примечание**: по умолчанию внутренние письма (где все участники используют ваш домен) не синхронизируются для защиты конфиденциальности@@ -109,8 +109,8 @@ OUTBOUND_HTTP_SAFE_MODE_ENABLED=falseВыберите, что будет видно другим пользователям в вашем рабочем пространстве:-* **Всё**: Подробности события будут доступны вашей команде-* **Метаданные**: Только дата и участники будут видны вашей команде+* **Всего**: вся информация о событии будет передана вашей команде+* **Метаданные**: Только дата и участники будут переданы вашей команде### Авто создание контактов для встреч@@ -119,7 +119,7 @@ OUTBOUND_HTTP_SAFE_MODE_ENABLED=false<Note>Когда эта опция включена, контакты автоматически связываются с записями компании на основе их домена электронной почты. Если компании еще не существует, Twenty создаст ее для вас.</Note>-### Контролируйте, какие события будут синхронизированы+### Контролировать, какие события синхронизируются* **Импорт встреч**: Автоматически импортируйте события в календаре* **Связь с контактами**: Связывайте встречи с записями о людях и компанияхdiff --git a/packages/twenty-docs/l/ru/user-guide/dashboards/capabilities/dashboards.mdx b/packages/twenty-docs/l/ru/user-guide/dashboards/capabilities/dashboards.mdxindex 3f038ca2195..8f0ab090ac9 100644--- a/packages/twenty-docs/l/ru/user-guide/dashboards/capabilities/dashboards.mdx+++ b/packages/twenty-docs/l/ru/user-guide/dashboards/capabilities/dashboards.mdx@@ -23,7 +23,7 @@ description: Создавайте и организуйте панели мон### Создание вкладок-1. В режиме редактирования нажмите **+** на панели вкладок, справа откроется боковая панель+1. В режиме редактирования, нажмите **+** в панели вкладок, а боковая панель откроется справа2. Назовите вкладку (например, "Обзор воронки", "Результативность команды")3. Добавьте виджеты на вкладку@@ -31,7 +31,7 @@ description: Создавайте и организуйте панели мон1. В режиме редактирования нажмите и удерживайте вкладку, которую хотите переместить2. Перетащите на новую позицию-3. Также можно нажать на вкладку и использовать командное меню, чтобы переместить её влево или вправо+3. Вы также можете нажать на вкладку и использовать меню команд, чтобы переместить вкладку влево или вправо### Удаление вкладокdiff --git a/packages/twenty-docs/l/ru/user-guide/dashboards/capabilities/widgets.mdx b/packages/twenty-docs/l/ru/user-guide/dashboards/capabilities/widgets.mdxindex d89de242627..2c64d3cd52d 100644--- a/packages/twenty-docs/l/ru/user-guide/dashboards/capabilities/widgets.mdx+++ b/packages/twenty-docs/l/ru/user-guide/dashboards/capabilities/widgets.mdx@@ -102,6 +102,26 @@ Twenty предоставляет различные типы виджетовВстраивайте внешние инструменты и контент прямо в ваш дашборд.+<Frame>+<img src="/images/user-guide/dashboard/dashboard-widget-table.png" alt="График таблицы" />+</Frame>++**Лучше всего подходит для:**++* Поиск отдельных записей+* Проверка точных значений+* Аудит или для справки++**Примеры использования:**++* Сделки, закрывающиеся в этом месяце+* Новые лиды на этой неделе+* Просроченные счета++### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="table" />Таблица</span>++Просматривайте отфильтрованные записи прямо на вашей панели управления.+<Frame><img src="/images/user-guide/dashboard/dashboard-widget-iframe.png" alt="iFrame" /></Frame>@@ -139,7 +159,7 @@ Twenty предоставляет различные типы виджетов* Редактирование в стиле Markdown<Note>-**Скоро**: Индикаторные диаграммы и таблицы пока недоступны, но есть в нашей дорожной карте.+**Скоро**: Индикаторные диаграммы пока недоступны, но есть в нашей дорожной карте.</Note>### Дублирование виджетовdiff --git a/packages/twenty-docs/l/ru/user-guide/dashboards/how-tos/dashboards-faq.mdx b/packages/twenty-docs/l/ru/user-guide/dashboards/how-tos/dashboards-faq.mdxindex c122e62b2af..20bb4499d10 100644--- a/packages/twenty-docs/l/ru/user-guide/dashboards/how-tos/dashboards-faq.mdx+++ b/packages/twenty-docs/l/ru/user-guide/dashboards/how-tos/dashboards-faq.mdx@@ -35,8 +35,8 @@ description: Часто задаваемые вопросы о панелях уФильтры на уровне панели управления пока недоступны, но эта функция запланирована в нашей дорожной карте. Сейчас фильтры нужно применять к каждому виджету отдельно.</Accordion>- <Accordion title="Доступны ли диаграммы-спидометры или таблицы?">- Пока нет. Диаграммы-спидометры и таблицы запланированы в нашей дорожной карте и будут добавлены в одном из будущих релизов.+ <Accordion title="Доступны ли диаграммы-спидометры?">+ Пока нет. Диаграммы-спидометры запланированы в нашей дорожной карте и будут добавлены в одном из будущих релизов.</Accordion><Accordion title="Как дублировать панель управления?">diff --git a/packages/twenty-docs/l/ru/user-guide/dashboards/overview.mdx b/packages/twenty-docs/l/ru/user-guide/dashboards/overview.mdxindex b74e3d7de09..28c730b08cd 100644--- a/packages/twenty-docs/l/ru/user-guide/dashboards/overview.mdx+++ b/packages/twenty-docs/l/ru/user-guide/dashboards/overview.mdx@@ -3,10 +3,6 @@ title: Панели управленияdescription: Изучите основы отчетности и панелей мониторинга в Twenty.----<Note>-Дашборды сейчас в бета-версии. Активируйте их в разделе **Настройки → Обновления → Ранний доступ**.-</Note>-## Понимание панелей мониторингаПанели мониторинга в Twenty обеспечивают визуальный способ отслеживать ключевые показатели эффективности и получать инсайты из данных вашей CRM-системы.@@ -42,7 +38,7 @@ description: Изучите основы отчетности и панелей<Note>**Текущие ограничения**:* Экспорт панелей мониторинга и предоставление доступа внешним пользователям (не являющимся пользователями Twenty) в настоящее время недоступны.-* Индикаторные диаграммы и таблицы пока недоступны.+* Индикаторные диаграммы пока недоступны.</Note>## Начало работыdiff --git a/packages/twenty-docs/l/ru/user-guide/data-migration/capabilities/error-handling.mdx b/packages/twenty-docs/l/ru/user-guide/data-migration/capabilities/error-handling.mdxindex 8531a0435b2..3d322157945 100644--- a/packages/twenty-docs/l/ru/user-guide/data-migration/capabilities/error-handling.mdx+++ b/packages/twenty-docs/l/ru/user-guide/data-migration/capabilities/error-handling.mdx@@ -68,9 +68,9 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';## Советы для уменьшения количества ошибок-1. **Скачайте шаблон**, чтобы увидеть ожидаемый формат перед импортом файла+1. **Загрузите шаблон** для просмотра ожидаемого формата перед импортом вашего файла2. **Очистите данные** сначала в таблице3. **Импортируйте файлы в правильном порядке**, чтобы импортировать связи (Компании → Контакты → Сделки)4. **Протестируйте на небольших партиях** перед полным импортом5. **Проверьте наличие дублей** перед загрузкой-6. **Ограничьте размер каждого файла 10 000 записями**+6. **Ограничить каждый файл до 10000 записей**diff --git a/packages/twenty-docs/l/ru/user-guide/data-migration/capabilities/import-relations.mdx b/packages/twenty-docs/l/ru/user-guide/data-migration/capabilities/import-relations.mdxindex 4567c34313d..edcdb3e06d8 100644--- a/packages/twenty-docs/l/ru/user-guide/data-migration/capabilities/import-relations.mdx+++ b/packages/twenty-docs/l/ru/user-guide/data-migration/capabilities/import-relations.mdx@@ -24,7 +24,7 @@ Twenty поддерживает стандартные связи, когда о**Паттерн 1: Многие записи, каждая из которых связана с одной записью каждого типа объекта**-Несколько Заметок, Задач или Активностей могут одновременно быть привязаны к нескольким типам объектов:+Несколько заметок или задач можно прикрепить к нескольким типам объектов:* **Заметки** могут одновременно быть связаны с одним Человеком, одной Компанией и одной Сделкой* **Задачи** могут одновременно быть связаны с одним Человеком, одной Компанией и одной Сделкой@@ -58,7 +58,7 @@ Twenty поддерживает стандартные связи, когда о* Многие Люди связаны со многими Проектами-<Note>Связи «многие-ко-многим» запланированы на 1 полугодие 2026 года.</Note>+<Note>Связи «многие-ко-многим» запланированы на 2 полугодие 2026 года.</Note>## Связывание записей при импортеdiff --git a/packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/export-faq.mdx b/packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/export-faq.mdxnew file mode 100644index 00000000000..7640ff79269--- /dev/null+++ b/packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/export-faq.mdx@@ -0,0 +1,32 @@+---+title: Экспорт FAQ+description: Часто задаваемые вопросы об экспорте данных.+---++<AccordionGroup>+<Accordion title="Можем ли мы экспортировать все данные рабочей области до отмены, включая пользовательские объекты, пользовательские поля, отношения, заметки, задачи, вложения, потоки, права доступа и историю аудита?">+Данные проекта могут быть экспортированы перед отменой за некоторыми исключениями: панели управления, процессы и разрешения должны быть переданы вручную; журналы аудита не могут быть переданы.+</Accordion>+<Accordion title="Какие элементы не могут быть экспортированы или перенесены?">+Большинство элементов можно экспортировать или мигрировать за некоторыми исключениями:+* рабочие процессы, панели инструментов и все настройки (ключи API, вебхуки, журналы аудита, пользовательские настройки и т.д.) должно быть перенесено вручную+* Объекты и поля приложения, созданные приложением, могут быть перенесены путем установки указанного приложения в другом проекте. Они не должны быть перенесены вручную+* некоторые записи, такие как версии рабочего процесса и рабочий процесс, не передаются вообще, и ожидается потеря+* некоторые объекты, такие как сообщения и связанные с календарем объекты, не должны экспортироваться, так как они создаются, когда аккаунт подключен и периодически синхронизируется. Они будут синхронизированы снова, как только вы подключите свою учетную запись (пока у вас есть доступ к указанной учетной записи) если это аккаунт члена команды, который покинул вашу компанию, то эти сообщения должны быть экспортированы, в противном случае они будут утеряны)+</Accordion>+<Accordion title="Есть ли официальное облако для самостоятельной процедуры миграции или для службы миграции?">+На данный момент отсутствует официальная процедура миграции с использованием облака на самообслуживание. Общая идея заключается в следующем:+* сначала установите приложения для создания объектов и полей+* репликация пользовательских объектов и полей, добавленных пользователями+* использовать скрипт с клавишами API или инструменты ИИ для переноса всех данных из одной рабочей области в другую+* все непередаваемые объекты должны быть перенесены вручную++Пожалуйста, имейте в виду:+* Вы можете отправить до 50 запросов в минуту на план Pro или 100 запросов в минуту на план организации перед тем, как попасть в запрос / мин. лимит+* каждый запрос API может иметь до 200 записей+* некоторые данные в таких полях, как Created by Timeline активностей и Updated by будут потеряны во время импорта и перезаписаны системой+</Accordion>+<Accordion title="Экспортируются ли файлы в открытых и документированных форматах?">+Экспортированные файлы в интерфейсе находятся в формате Excel, все API запросы могут быть сохранены в формате JSON.+</Accordion>+</AccordionGroup>diff --git a/packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/import-contacts-via-csv.mdx b/packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/import-contacts-via-csv.mdxindex 9ba17d9d772..9dc72a5d530 100644--- a/packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/import-contacts-via-csv.mdx+++ b/packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/import-contacts-via-csv.mdx@@ -5,7 +5,7 @@ description: Полное пошаговое руководство по имп## Обзор-Это руководство проведет вас через процесс импорта ваших контактов (People) в Twenty. **Сначала импортируйте Компании**, если хотите связать Людей с Компаниями.+Это руководство проведет вас через процесс импорта ваших контактов (People) в Twenty.## Перед началомdiff --git a/packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx b/packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/migrating-from-other-crms.mdxindex 89e6c774e23..063853fca12 100644--- a/packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx+++ b/packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx@@ -284,9 +284,6 @@ Jane,Doe,[email protected],https://widgets.co## Нужна Помощь?-Для сложных миграций или больших наборов данных:--* **Настройка с сопровождением:** забронируйте 4-часовой пакет онбординга-* **Полная услуга по миграции:** наши партнёры могут выполнить всю миграцию--Свяжитесь с нами по адресу [[email protected]](mailto:[email protected]) или изучите наши [услуги по внедрению](/l/ru/user-guide/getting-started/capabilities/implementation-services).+<Tip>+ Нужна помощь с переносом данных? [Найти сертифицированного Двадцать партнера](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-migrate-crm) для перемещения данных, трубопроводов и пользователей сквозно.+</Tip>diff --git a/packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx b/packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdxindex e6b98251547..98b71f0126c 100644--- a/packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx+++ b/packages/twenty-docs/l/ru/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx@@ -168,4 +168,6 @@ Acme Corp,https://acme.com,[email protected]## Нужна Помощь?-Для сложных миграций или больших наборов данных свяжитесь с нами по адресу [[email protected]](mailto:[email protected]) или изучите наши [услуги по внедрению](/l/ru/user-guide/getting-started/capabilities/implementation-services).+<Tip>+ Мигрируете крупное или сложное рабочее пространство? [Найдите сертифицированного партнёра Twenty](https://twenty.com/partners/list?categories=HOSTING\&ref=docs-migrate-cloud), который возьмёт перенос на себя от начала и до конца. *(Или подключите нашу команду: [[email protected]](mailto:[email protected]).)*+</Tip>diff --git a/packages/twenty-docs/l/ru/user-guide/data-migration/overview.mdx b/packages/twenty-docs/l/ru/user-guide/data-migration/overview.mdxindex 80f8c8e30b1..69fc9a13983 100644--- a/packages/twenty-docs/l/ru/user-guide/data-migration/overview.mdx+++ b/packages/twenty-docs/l/ru/user-guide/data-migration/overview.mdx@@ -43,8 +43,8 @@ Twenty поддерживает два основных способа импоПри импорте связанных объектов загружайте файлы в следующем порядке:1. Сначала **Компании** (сторона «один» в отношениях)-2. **Люди** во вторую очередь (связаны с компаниями через companyId)-3. **Возможности** в третью очередь (связаны с компаниями/людьми)+2. **Люди** во вторую очередь (связаны с Компаниями через companyId)+3. **Сделки** в третью очередь (связаны с Компаниями/Людьми)4. **Пользовательские объекты** со связями — в последнюю очередьПочему? Сторона «один» в связи типа «один-ко-многим» должна существовать, прежде чем вы сможете на нее ссылаться. Например, запись компании должна существовать до импорта человека с идентификатором этой компании.diff --git a/packages/twenty-docs/l/ru/user-guide/data-model/capabilities/fields.mdx b/packages/twenty-docs/l/ru/user-guide/data-model/capabilities/fields.mdxindex 08b493abb51..fd8d18d0ea9 100644--- a/packages/twenty-docs/l/ru/user-guide/data-model/capabilities/fields.mdx+++ b/packages/twenty-docs/l/ru/user-guide/data-model/capabilities/fields.mdx@@ -60,7 +60,7 @@ Twenty поддерживает различные типы полей:1. Перейдите в `Настройки` в левой боковой панели.2. Перейдите в `Модель Данных`, затем выберите объект, который хотите настроить.-3. Продолжайте, нажав `Добавить Поле`.+3. Продолжайте, нажав `+ Новое Поле`.4. Выберите имя и тип поля, которые подходят вашим требованиям. Рассмотрите возможность добавления описания поля для лучшего понимания.Ваше новосозданное поле теперь доступно в приложении среди других полей. Чтобы отобразить его в конкретном представлении, откройте меню параметров, затем выберите `Поля`.@@ -78,9 +78,7 @@ Twenty поддерживает различные типы полей:Вот как это можно сделать:1. Найдите поле, которое вы хотите деактивировать, в настройках вашего объекта.-2. Щелкните на три точки `⋮` рядом с полем, чтобы открыть меню.-3. Выберите `Деактивировать` из выпадающего списка.<img src="/images/user-guide/fields/deactivate-field.png" style={{width:'100%'}} />@@ -88,9 +86,7 @@ Twenty поддерживает различные типы полей:Что происходит, когда вы деактивируете поле?1. **В приложении:** Поле исчезает, и вы не можете добавлять в него новые значения.-2. **Существующие связи:** Если это реляционное поле, существующие связи остаются, но вы не можете создавать новые.-3. **Доступ по API:** Вы все еще можете получить доступ к полю и его данным через API.Вы можете реактивировать Стандартные и Пользовательские Поля или выбрать их окончательное удаление.diff --git a/packages/twenty-docs/l/ru/user-guide/data-model/capabilities/objects.mdx b/packages/twenty-docs/l/ru/user-guide/data-model/capabilities/objects.mdxindex 25bd46fe335..0065fccfa4d 100644--- a/packages/twenty-docs/l/ru/user-guide/data-model/capabilities/objects.mdx+++ b/packages/twenty-docs/l/ru/user-guide/data-model/capabilities/objects.mdx@@ -15,7 +15,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';Объект `People` хранит ваши контакты. Он включает в себя контактные данные и историю взаимодействия, чтобы вы могли видеть все ваши взаимодействия с клиентами в одном месте.-### Компания+### КомпанииОбъект `Companies` хранит ваши бизнес-аккаунты. В него входят такие данные, как индустрия, размер и местоположение. Компания связана с объектами `People` и `Opportunities`.@@ -42,12 +42,11 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';Чтобы создать новый пользовательский объект:1. Перейдите в Настройки в боковой панели слева.-2. В разделе «Рабочее пространство» перейдите к «Модели данных». Здесь вы сможете увидеть обзор всех ваших существующих Стандартных и Пользовательских объектов (как активных, так и отключенных).+2. В рабочей области перейдите к модели данных. Здесь вы сможете увидеть обзор всех ваших существующих стандартных и пользовательских объектов (как активных, так и деактивированных).<VimeoEmbed videoId="926288174" title="Видеодемонстрация" />3. Нажмите на `+ Новый объект` вверху. Введите имя (как в единственном, так и во множественном числе), выберите значок и добавьте описание для вашего пользовательского объекта, а затем нажмите Сохранить (в правом верхнем углу). Используя Листинг как пример пользовательского объекта, единственное число будет "листинг", а множественное - "листинги", вместе с описанием, например, "Листинги, которые хозяева создали для показа своей собственности."-4. Ваш пользовательский объект создан и появится в боковой панели. Вы можете сразу начать добавлять в него записи.## Управление объектами@@ -57,18 +56,20 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';Если вам не нужен стандартный или пользовательский объект:1. Перейдите в Настройки → Модель данных-2. Найдите объект, который нужно деактивировать-3. Щелкните переключатель, чтобы деактивировать его-4. Объект будет скрыт в вашем рабочем пространстве, но данные сохранятся+2. Найти объект, который вы хотите деактивировать и нажать на него+3. Перейти на вкладку **Настройки** объекта+4. Нажмите кнопку `Deactivate`+5. Объект будет скрыт в вашем рабочем пространстве, но данные сохранятся### Повторная активация объектовЧтобы вернуть деактивированный объект:1. Перейдите в Настройки → Модель данных-2. Найдите деактивированные объекты (они отображаются серым цветом)-3. Щелкните переключатель, чтобы активировать его снова-4. Объект и все его данные будут восстановлены+2. Включить фильтр `Деактивированные`+3. Искать деактивированные объекты (у них есть `Деактивированные` рядом с их именем)+4. Щелкните `⋮`, а затем `Activate`, чтобы снова активировать его+5. Объект и все его данные будут восстановлены## Лучшие практикиdiff --git a/packages/twenty-docs/l/ru/user-guide/data-model/capabilities/relation-fields.mdx b/packages/twenty-docs/l/ru/user-guide/data-model/capabilities/relation-fields.mdxindex 55a114ee7dc..be6260ef33d 100644--- a/packages/twenty-docs/l/ru/user-guide/data-model/capabilities/relation-fields.mdx+++ b/packages/twenty-docs/l/ru/user-guide/data-model/capabilities/relation-fields.mdx@@ -41,10 +41,8 @@ description: Связывайте записи между разными объСвязи многие-ко-многим используют шаблон **объекта-связки**: промежуточный объект, который соединяет обе стороны. С функцией связей через объект-связку Twenty напрямую отображает конечные связанные записи, скрывая промежуточный объект из интерфейса.-<img src="/images/user-guide/fields/junction-relation-diagram.png" style={{width:'100%'}} />-<Warning>-**Экспериментальная функция**: Связи через объект-связку необходимо включить в **Settings → Updates → Lab** перед использованием.+**Бета-функция**: Связи через объект-связку необходимо включить в **Settings → Community → Features** перед использованием.</Warning>См. раздел [Как создать отношения «многие-ко-многим»](/l/ru/user-guide/data-model/how-tos/create-many-to-many-relations) для получения полного пошагового руководства.@@ -53,7 +51,7 @@ description: Связывайте записи между разными объ1. Перейдите в **Настройки → Модель данных**2. Выберите объект, в который вы хотите добавить связь-3. Нажмите **+ Добавить поле**+3. Нажмите **+ Новое поле**4. Выберите **Связь** как тип поля5. Выберите целевые объекты, с которыми нужно установить связь6. Настройте параметры связи:diff --git a/packages/twenty-docs/l/ru/user-guide/data-model/how-tos/create-custom-fields.mdx b/packages/twenty-docs/l/ru/user-guide/data-model/how-tos/create-custom-fields.mdxindex a3cfc758d9d..b28b3bb1f33 100644--- a/packages/twenty-docs/l/ru/user-guide/data-model/how-tos/create-custom-fields.mdx+++ b/packages/twenty-docs/l/ru/user-guide/data-model/how-tos/create-custom-fields.mdx@@ -9,7 +9,7 @@ description: Пошаговое руководство по добавлению1. Перейдите в **Настройки → Модель данных**2. Выберите объект, в который вы хотите добавить поле-3. Нажмите **+ Добавить поле**+3. Нажмите **+ Новое поле**4. Выберите **тип поля** (все типы см. в разделе [Поля](/l/ru/user-guide/data-model/capabilities/fields))5. Введите **имя поля** и при необходимости описание6. Настройте параметры, специфичные для поля (см. ниже)diff --git a/packages/twenty-docs/l/ru/user-guide/data-model/how-tos/create-custom-objects.mdx b/packages/twenty-docs/l/ru/user-guide/data-model/how-tos/create-custom-objects.mdxindex 05b703f22df..ec909662eda 100644--- a/packages/twenty-docs/l/ru/user-guide/data-model/how-tos/create-custom-objects.mdx+++ b/packages/twenty-docs/l/ru/user-guide/data-model/how-tos/create-custom-objects.mdx@@ -12,7 +12,7 @@ description: Пошаговое руководство по созданию п## Шаги1. Перейдите в **Настройки → Модель данных**-2. Нажмите **+ Новый объект**+2. Нажмите **+ Добавить объект**3. Заполните:* **Имя в единственном числе** (например, "Listing")* **Имя во множественном числе** (например, "Listings")@@ -27,7 +27,7 @@ description: Пошаговое руководство по созданию пНовые объекты изначально содержат базовые поля. Добавьте пользовательские поля, чтобы собирать нужные данные:1. В разделе **Настройки → Модель данных** выберите свой объект-2. Нажмите **+ Добавить поле**+2. Нажмите **+ Новое поле**3. Выберите тип поля, настройте и сохранитеСм. [Как создать пользовательские поля](/l/ru/user-guide/data-model/how-tos/create-custom-fields) для подробностей о типах полей и настройке.@@ -40,8 +40,8 @@ description: Пошаговое руководство по созданию пЕсли объект больше не нужен:-1. Перейдите в **Настройки → Модель данных**-2. Отключите объект+1. Перейдите в **Настройки → Модель данных → объект по вашему выбору → Настройки**+2. Нажмите на кнопку **Отключить**Объект будет скрыт, но данные сохранятся. Позже вы сможете повторно активировать или удалить навсегда.diff --git a/packages/twenty-docs/l/ru/user-guide/data-model/how-tos/create-many-to-many-relations.mdx b/packages/twenty-docs/l/ru/user-guide/data-model/how-tos/create-many-to-many-relations.mdxindex f9ac24de3d8..86ed4f0a550 100644--- a/packages/twenty-docs/l/ru/user-guide/data-model/how-tos/create-many-to-many-relations.mdx+++ b/packages/twenty-docs/l/ru/user-guide/data-model/how-tos/create-many-to-many-relations.mdx@@ -51,7 +51,7 @@ People ←→ Project Assignments ←→ ProjectsСначала создайте промежуточный объект, который будет хранить связи.1. Перейдите в **Настройки → Модель данных**-2. Нажмите **+ Новый объект**+2. Нажмите **+ Добавить объект**3. Дайте ему понятное имя (например, "Project Assignment", "Team Member", "Product Order")4. Включите переключатель «Пропустить создание поля „Имя“»@@ -158,7 +158,7 @@ People ←→ Project Assignments ←→ ProjectsПоскольку объект-связка — это настоящий объект, вы можете добавить пользовательские поля для хранения информации о связи:* **Роль**: "Developer", "Designer", "Manager"-* **Дата начала**: Когда они присоединились к проекту+* **Дата начала**: когда человек присоединился к проекту* **Выделенные часы**: Еженедельное количество часов на этот проектЧтобы получить доступ к этим данным, перейдите непосредственно к объекту-связке или выполните запрос к нему через API.diff --git a/packages/twenty-docs/l/ru/user-guide/data-model/how-tos/create-relation-fields.mdx b/packages/twenty-docs/l/ru/user-guide/data-model/how-tos/create-relation-fields.mdxindex 4d17e5b32cd..1f52b0b597d 100644--- a/packages/twenty-docs/l/ru/user-guide/data-model/how-tos/create-relation-fields.mdx+++ b/packages/twenty-docs/l/ru/user-guide/data-model/how-tos/create-relation-fields.mdx@@ -24,7 +24,7 @@ description: Пошаговое руководство по связыванию1. Перейдите в **Настройки → Модель данных**2. Выберите объект, где нужна связь (обычно это сторона «многие»)-3. Нажмите **+ Добавить поле**+3. Нажмите **+ Новое поле**4. Выберите **Связь** как тип поля5. Выберите **целевой объект**6. Выберите **Один-ко-многим** или **Многие-к-одному**@@ -42,16 +42,26 @@ description: Пошаговое руководство по связываниюТеперь каждый контакт может быть связан с компанией, и каждая компания показывает свои контакты.-## Удаление связи+## Деактивация связи-1. Перейдите в **Настройки → Модель данных**-2. Найдите поле связи-3. Нажмите **⋮ → Деактивировать**+1. Перейдите в **Настройки → Модель данных → нужный объект**+2. Найдите поле связи и нажмите на него+3. Нажмите кнопку **Деактивировать**Связи сохраняются, но скрыты. Повторно активируйте, чтобы восстановить.<Note>-**Удаление связи не удаляет записи.** Удаляется только связь между ними.+**Деактивация связи не удаляет записи.** Удаляется только связь между ними.+</Note>++## Удаление связи++1. Перейдите в **Настройки → Модель данных → нужный объект**+2. Найдите поле связи и нажмите на него+3. Нажмите кнопку **Удалить**++<Note>+Применяется только к пользовательским связям. Стандартные связи можно только деактивировать.</Note>## Связанные материалыdiff --git a/packages/twenty-docs/l/ru/user-guide/data-model/how-tos/data-model-faq.mdx b/packages/twenty-docs/l/ru/user-guide/data-model/how-tos/data-model-faq.mdxindex e8deacfea3d..f16a9b27d28 100644--- a/packages/twenty-docs/l/ru/user-guide/data-model/how-tos/data-model-faq.mdx+++ b/packages/twenty-docs/l/ru/user-guide/data-model/how-tos/data-model-faq.mdx@@ -42,7 +42,6 @@ description: Часто задаваемые вопросы о модели даНет, типы полей нельзя изменить после создания. Если вам нужен другой тип, создайте новое поле с правильным типом, перенесите данные, затем деактивируйте старое поле.</Accordion>-<Accordion title="Почему мне нужны разные формы для единственного и множественного числа?">Наш GraphQL API использует обе формы для различных операций:* `createPerson` (единственное число) для действий с одной записью@@ -73,15 +72,15 @@ description: Часто задаваемые вопросы о модели да</Accordion><Accordion title="Могу ли я создавать поля-формулы?">-Поля-формулы появятся в **Q1 2026**. До тех пор вы можете использовать рабочие процессы для автоматического вычисления и обновления значений полей.+Формула поля наступают в **H2 2026**. До тех пор вы можете использовать рабочие процессы для автоматического вычисления и обновления значений полей.</Accordion><Accordion title="Могу ли я использовать вложенные поля в моих объектах?">-Вложенные поля появятся в **Q1 2026**. На данный момент вы можете использовать рабочие процессы для извлечения значений полей из связанных объектов. Например, чтобы отображать отрасль компании на записи Персоны, создайте пользовательское поле в Людях и используйте рабочий процесс для синхронизации значения.+Вложенные поля появляются в **H2 2026**. На данный момент вы можете использовать рабочие процессы для извлечения значений полей из связанных объектов. Например, чтобы отображать отрасль компании на записи Персоны, создайте пользовательское поле в Людях и используйте рабочий процесс для синхронизации значения.</Accordion><Accordion title="Могу ли я переупорядочивать поля в объектах?">-Переупорядочивание полей будет доступно вместе с настраиваемыми макетами в **Q4 2025**. На данный момент поля отображаются в алфавитном порядке.+Да, перейдите в Настройки → Модель данных → Объект по вашему выбору → Макет и нажмите **Настроить страницу записи**. Если эта кнопка отключена, вы должны создать запись.</Accordion></AccordionGroup>@@ -93,7 +92,7 @@ description: Часто задаваемые вопросы о модели да</Accordion><Accordion title="Могу ли я создавать отношения многие-ко-многим?">-Отношения многие-ко-многим появятся в **H1 2026**. На данный момент создайте промежуточный объект с двумя отношениями один-ко-многим в качестве временного решения.+В **H2 2026** появятся отношения с многими. На данный момент создайте промежуточный объект с двумя отношениями один-ко-многим в качестве временного решения.Например, чтобы связать Людей и Проекты (многие-ко-многим), создайте объект "Назначения по проектам" с:* Связь с Людьми (много назначений → один человек)@@ -147,6 +146,10 @@ description: Часто задаваемые вопросы о модели да<Accordion title="Могу ли я экспортировать конфигурацию модели данных?">На данный момент встроенного экспорта конфигурации модели данных нет. Свяжитесь со службой поддержки, если вам нужно перенести модель данных между рабочими пространствами.</Accordion>++<Accordion title="Сколько полей может иметь один объект?">+Максимальное количество полей, которое может иметь один объект, - 1600 полей в пределах одного объекта, включая как существующие, так и удаленные поля. Имейте в виду, что двадцать полей не будут исправлены в вашем проекте, если достигнут лимит в 1600 полей в соответствии с нашей политикой использования на ярмарке.+</Accordion></AccordionGroup>## Нужна дополнительная помощь?diff --git a/packages/twenty-docs/l/ru/user-guide/data-model/overview.mdx b/packages/twenty-docs/l/ru/user-guide/data-model/overview.mdxindex 70c270a6672..4d60cc8c402 100644--- a/packages/twenty-docs/l/ru/user-guide/data-model/overview.mdx+++ b/packages/twenty-docs/l/ru/user-guide/data-model/overview.mdx@@ -18,7 +18,7 @@ description: Узнайте, что такое модель данных и ка* **People** — физические лица (контакты, лиды, партнёры)* **Companies** — организации* **Opportunities** — сделки или продажи-* **Notes** — прикреплённые к записям заметки+* **Примечания** — заметки, прикрепленные к записям* **Tasks** — задачи, связанные с записямиВы также можете создать **пользовательские объекты** для всего, что специфично для вашего бизнеса (например, Projects, Subscriptions, Events).@@ -172,4 +172,6 @@ Twenty предоставляет полную гибкость:## Нужна Помощь?-Наша команда может помочь вам в разработке и создании необходимой модели данных. Узнайте о наших [услугах по внедрению](/l/ru/user-guide/getting-started/capabilities/implementation-services).+<Tip>+ Нужна помощь в проектировании вашей модели данных? [Найти сертифицированного партнера](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-data-model) для проектирования и построения ваших объектов, полей и отношений.+</Tip>diff --git a/packages/twenty-docs/l/ru/user-guide/getting-started/capabilities/glossary.mdx b/packages/twenty-docs/l/ru/user-guide/getting-started/capabilities/glossary.mdxindex 27437abc01b..a398129ef9e 100644--- a/packages/twenty-docs/l/ru/user-guide/getting-started/capabilities/glossary.mdx+++ b/packages/twenty-docs/l/ru/user-guide/getting-started/capabilities/glossary.mdx@@ -60,7 +60,7 @@ CRM имеет два основных типа записей:## Запись-Запись указывает на экземпляр объекта, например, определенный аккаунт или контакт.+Запись - это экземпляр объекта, как конкретная учетная запись или контакт.## Поля связиdiff --git a/packages/twenty-docs/l/ru/user-guide/getting-started/capabilities/implementation-services.mdx b/packages/twenty-docs/l/ru/user-guide/getting-started/capabilities/implementation-services.mdxindex 0a500d026fc..0d7879d8a6a 100644--- a/packages/twenty-docs/l/ru/user-guide/getting-started/capabilities/implementation-services.mdx+++ b/packages/twenty-docs/l/ru/user-guide/getting-started/capabilities/implementation-services.mdx@@ -3,14 +3,15 @@ title: Услуги по внедрениюdescription: Нужна ли вам помощь в начале работы или в создании сложных настроек, у нас есть решение.----## Пакеты внедрения--Получите помощь от нашей основной команды, чтобы настроить ваше рабочее пространство Twenty с нашими 4-часовыми пакетами внедрения:--* **Проектирование модели данных**: Разрабатывайте и создавайте свою собственную модель данных с объектами, полями и отношениями-* **Миграция данных**: Переносите существующие данные из вашей текущей CRM в Twenty-* **Создание рабочих процессов**: Создавайте пользовательские рабочие процессы для поддержки ваших бизнес-процессов-## Партнеры по внедрению-Работайте с сертифицированными партнерами Twenty для более сложных настроек и интеграций. Свяжитесь с нашей командой по адресу [[email protected]](mailto:[email protected]), чтобы мы подобрали для вас партнеров.+Работайте с сертифицированными партнерами Twenty для расширенных настроек, интеграций и выделенной поддержки внедрения.++<CardGroup cols={2}>+ <Card title="Просмотреть сертифицированных партнеров" icon="magnifying-glass" href="https://twenty.com/partners/list?ref=docs-implementation-services">+ Найдите партнера и свяжитесь с ним напрямую — отфильтруйте по региону, языку и области экспертизы.+ </Card>+ <Card title="Получить рекомендации от Twenty" icon="envelope" href="mailto:[email protected]">+ Расскажите нам, что вам нужно, и мы свяжем вас с подходящим партнером.+ </Card>+</CardGroup>diff --git a/packages/twenty-docs/l/ru/user-guide/getting-started/how-tos/configure-your-workspace.mdx b/packages/twenty-docs/l/ru/user-guide/getting-started/how-tos/configure-your-workspace.mdxindex 82101295317..48f75e46735 100644--- a/packages/twenty-docs/l/ru/user-guide/getting-started/how-tos/configure-your-workspace.mdx+++ b/packages/twenty-docs/l/ru/user-guide/getting-started/how-tos/configure-your-workspace.mdx@@ -11,9 +11,9 @@ Twenty предлагает гибкость, необходимую для соСоздавайте объекты и поля любого типа, включая отношения между различными объектами. Вы можете сделать это в разделе Настройки → Модель данных.Вот несколько советов:-* **Вы не ограничены в количестве пользовательских полей и объектов.** Добавление пользовательских объектов и полей не приведет к повышению вашего тарифа. Добавление пользовательских объектов и полей не приведет к повышению вашего тарифа.+* **Количество пользовательских полей или пользовательских объектов не ограничено**. Добавление пользовательских объектов и полей не приведет к повышению вашего тарифа.* **Люди, Компании и Возможности — это три объекта, через которые вы можете получить доступ к электронным письмам и встречам, синхронизированным с вашей почтой и календарём**. Мы рекомендуем использовать их как можно чаще, добавляя поля для категоризации ваших записей, если это необходимо. Вот пример:- * Лучше всего использовать объект Люди для своих клиентов и партнеров, создавая поле в объекте Люди с именем `Тип Персоны`, а не создавать пользовательский объект Партнёр. Потому что вы не сможете получить доступ к электронной почте, обмененной с этим человеком из записей партнёра.+ * Лучше всего использовать объект Люди для ваших перспектив и партнеров, создав поле на объекте Люди под названием \`\`\`Person Type\`\`, вместо того чтобы создавать пользовательский объект партнера, потому что вы не сможете получить доступ к электронной почте обменяться с этим человеком из записей партнера.* Создайте разные представления в разделе Люди, одно для отображения партнёров и одно для отображения клиентов.* Два человека не могут иметь один и тот же адрес электронной почты. Две компании не могут использовать один и тот же домен.* Вы можете деактивировать стандартные поля и объекты, которые не хотите использовать.@@ -36,7 +36,7 @@ Twenty предлагает гибкость, необходимую для со**Используете другого провайдера?**Вы можете добавить другую почту через SMTP или другой календарь через CalDAV. Перейдите в **Настройки → Учетные записи**, чтобы настроить.-### Импортировать данные через csv+### Импорт данных через CSVИспользуйте меню команд (`Cmd + K` или `Ctrl + K`), чтобы импортировать Людей, Компании, Возможности или любые пользовательские объекты с помощью CSV.@@ -51,14 +51,14 @@ Twenty предлагает гибкость, необходимую для со## 3. Создайте своё первое представление-Создание различных представлений является ключевым для того, чтобы сделать данные доступными для вашей команды.+Создание различных представлений - это ключ к действию данных для вашей команды.Вот как действовать:-* **Добавьте или спрячьте столбцы**- Управляйте видимыми полями в данном представлении, щелкнув на Опции → Поля (справа вверху). Вы можете показать/скрыть поля оттуда.+* **Добавить или скрыть столбцы**+ Управляйте полями, видимыми в данном представлении, нажав на Опции → Поля (сверху справа). Вы можете показать/скрыть поля оттуда.-* **Измените порядок полей**- Измените порядок полей в данном представлении, щелкнув на Опции → Поля (справа вверху). Перетаскивайте поля, чтобы изменить их порядок.+* **Переупорядочить поля**+ Изменить порядок полей в данном представлении, нажав на Опции → Поля (сверху справа). Перетаскивайте поля, чтобы изменить их порядок.* **Отфильтруйте своё представление**Сузьте круг отображаемых записей, используя фильтры справа вверху.diff --git a/packages/twenty-docs/l/ru/user-guide/getting-started/how-tos/create-workspace.mdx b/packages/twenty-docs/l/ru/user-guide/getting-started/how-tos/create-workspace.mdxindex fd4d97b4433..1500a229897 100644--- a/packages/twenty-docs/l/ru/user-guide/getting-started/how-tos/create-workspace.mdx+++ b/packages/twenty-docs/l/ru/user-guide/getting-started/how-tos/create-workspace.mdx@@ -11,7 +11,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';2. Выберите предпочтительный способ регистрации:* **Продолжить с Google** для регистрации с учетной записью Google.* **Продолжить с Microsoft** для регистрации с учетной записью Microsoft.- * Или, **Продолжить с электронной почтой** для регистрации по электронной почте.+ * Или **Продолжить с Email** для регистрации по электронной почте.<VimeoEmbed videoId="927066829" title="Видеодемонстрация" />@@ -41,7 +41,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';## Шаг 3: Подтверждение платежа и настройка учетной записи-После подтверждения оплаты через Stripe, вы перейдете к созданию рабочего пространства и профиля пользователя. Помните, что вы можете отменить подписку в любое время.+После подтверждения оплаты через Stripe, вы будете перенаправлены на создание вашего проекта и профиля пользователя. Помните, что вы можете отменить подписку в любое время.## Поддержкаdiff --git a/packages/twenty-docs/l/ru/user-guide/getting-started/how-tos/navigate-around-twenty.mdx b/packages/twenty-docs/l/ru/user-guide/getting-started/how-tos/navigate-around-twenty.mdxindex 40804535553..2ad94f3a630 100644--- a/packages/twenty-docs/l/ru/user-guide/getting-started/how-tos/navigate-around-twenty.mdx+++ b/packages/twenty-docs/l/ru/user-guide/getting-started/how-tos/navigate-around-twenty.mdx@@ -6,7 +6,7 @@ description: Быстрый обзор навигации по платформ## Основная компоновкаЦентр экрана — это **место, где живут ваши записи**: люди, компании, сделки, задачи, заметки, дашборды, рабочие процессы и любые другие созданные вами объекты. Здесь происходит повседневная работа.-Вы можете **просматривать, изменять, удалять записи** оттуда, а также **создавать новые представления**.+Вы можете **просматривать, изменять или удалять записи** оттуда, а также **создавать новые представления**.<img src="/images/user-guide/home/main-layout.png" style={{width:'100%'}} />@@ -40,7 +40,7 @@ description: Быстрый обзор навигации по платформ## Строка поиска-\+К строке поиска можно получить доступ через Меню команд в верхней части панели навигации или нажав `/`, чтобы сразу перейти к ней. Поиск работает по всем объектам.+К строке поиска можно получить доступ через Меню команд в верхней части панели навигации или нажав `/`, чтобы сразу перейти к ней. Поиск работает по всем объектам.<img src="/images/user-guide/home/search-bar.png" style={{width:'100%'}} />diff --git a/packages/twenty-docs/l/ru/user-guide/layout/capabilities/navigation.mdx b/packages/twenty-docs/l/ru/user-guide/layout/capabilities/navigation.mdxindex 18bc053cdf8..c806b955858 100644--- a/packages/twenty-docs/l/ru/user-guide/layout/capabilities/navigation.mdx+++ b/packages/twenty-docs/l/ru/user-guide/layout/capabilities/navigation.mdx@@ -17,7 +17,7 @@ description: Настройте левую боковую панель под т## Скрытие объектов-Объекты, которые вы не используете, можно скрыть из боковой панели. Они не удаляются — просто скрыты из виду. Вы можете снова показать их в любое время в разделе Настройки > Модель данных.+Объекты, которые вы не используете, можно скрыть из боковой панели. Они не удаляются — просто скрыты из виду. Вы можете снова показать их в любое время из Настройки → Модель данных.## Избранноеdiff --git a/packages/twenty-docs/l/ru/user-guide/layout/capabilities/record-pages.mdx b/packages/twenty-docs/l/ru/user-guide/layout/capabilities/record-pages.mdxindex 5b60295509b..84217956f74 100644--- a/packages/twenty-docs/l/ru/user-guide/layout/capabilities/record-pages.mdx+++ b/packages/twenty-docs/l/ru/user-guide/layout/capabilities/record-pages.mdx@@ -43,7 +43,7 @@ description: Настройте макет отдельных страниц сили-1. Перейдите в Настройки > Модель данных > объект по вашему выбору > Макет+1. Перейдите в Настройки → Модель данных → объект по вашему выбору → Макет2. Нажмите кнопку "Настроить страницу записи" для этого объектаdiff --git a/packages/twenty-docs/l/ru/user-guide/legal/how-tos/legal-faq.mdx b/packages/twenty-docs/l/ru/user-guide/legal/how-tos/legal-faq.mdxnew file mode 100644index 00000000000..7752066886e--- /dev/null+++ b/packages/twenty-docs/l/ru/user-guide/legal/how-tos/legal-faq.mdx@@ -0,0 +1,125 @@+---+title: ЧаВо по правовым вопросам+description: Часто задаваемые правовые вопросы.+---++## Данные и международные переводы++<AccordionGroup>+<Accordion title="В какой стране и регионе будут храниться наши данные рабочей области, вложения, журналы и резервные копии?">+Двадцать облачных работает на серверах AWS, расположенных во Франкфурте, Германия.+</Accordion>+<Accordion title="Можно ли в договорном порядке исправить регион хостинга для нашей рабочей области?">+Выбор региона размещения будет доступен начиная с 2027 года, изначально для новых рабочих пространств. Пользователи смогут запросить смену региона для существующего рабочего пространства позднее. В качестве альтернативы вы можете обратиться к [нашим партнерам](https://twenty.com/partners/list?categories=HOSTING), чтобы они помогли вам настроить ваш инстанс.+</Accordion>+<Accordion title="Какие субпроцессоры могут обрабатывать или получать доступ к нашим данным CRM, и в каких странах они находятся?">+Список всех субпроцессоров доступен в [нашем Центре доверия](https://trust.twenty.com/?tab=subprocessors).+</Accordion>+<Accordion title="Какие гарантии применяются к международным передачам данных?">+Стандартные договорные положения ЕС, вместе с дополнением для Великобритании и поправками для Швейцарии, применяются к международной передаче данных за пределы ЕС, включая передачи всем субпроцессорам.+</Accordion>+</AccordionGroup>++## Соглашение о обработке данных и правовые роли++<AccordionGroup>+<Accordion title="Где можно найти текущий Договор об обработке данных (DPA)?">+Вы можете сгенерировать подписанный DPA по адресу https://{your-domain}/settings/legal/dpa (например, https://getting-started.twenty.com/settings/legal/dpa).+</Accordion>+<Accordion title="Имеет ли двадцать функций обработчика данных для продавца и хранения контактной информации в CRM, в то время как наша компания остается контролером данных?">+В соответствии с нашей [Политикой конфиденциальности](https://twenty.com/privacy-policy) двадцать выполняет функции обработчика данных для продавца и контактной информации, хранящейся в CRM, пока ваша компания остается контроллером данных.+</Accordion>+<Accordion title="Является ли содержание CRM когда-либо использоваться для обучения двадцать или третьих сторонних AI моделей?">+Контент CRM может использоваться для обучения моделей ИИ в зависимости от Условий и положений субпроцессоров. У Twenty нет собственной модели ИИ — все модели ИИ, доступные в Twenty Cloud, предоставляются нашими субпроцессорами.+</Accordion>+<Accordion title="Если необязательная обработка AI существует, может быть полностью отключена для нашей рабочей области?">+ИИ можно полностью отключить, выключив все модели ИИ в Настройках → AI → Models. Кроме того, данные не отправляются в ИИ, если вы не взаимодействуете с чатом ИИ или узлом ИИ в рабочем процессе.+</Accordion>+</AccordionGroup>++## Контроль безопасности и доступа++<AccordionGroup>+<Accordion title="Используется ли шифрование при передаче и в состоянии покоя, каковы ваши практики управления ключами и как изолируются данные арендаторов?">+Все данные шифруются при передаче и в состоянии покоя. Данные арендаторов изолируются с помощью схемы "отдельная схема на арендатора", а ключи шифрования периодически ротируются.+</Accordion>+<Accordion title="Какие двадцать сотрудников или субпроцессорных работников могут получить доступ к рабочим местам клиента, для каких целей и как получить одобренный и зарегистрированный доступ?">+Команды инженеров и поддержки Twenty могут получать доступ к рабочим пространствам клиентов для расследования и устранения проблем. Владельцы рабочих пространств управляют этим: доступ службы поддержки можно отключить в любое время в разделе Settings → General → Security, и он останется отключённым, пока вы снова его не включите.+</Accordion>+<Accordion title="Какой процесс оповещения о происшествиях и временные рамки уведомлений после подтвержденного инцидента в области безопасности, затрагивающего наши данные?">+В случае подтверждения нарушения личных данных, затрагивающих ваши данные, мы уведомим Вас без неоправданной задержки и в любом случае в течение 48 часов после того, как узнаем об этом. Наше уведомление будет включать в себя, насколько известно в то время, когда речь идет о характере нарушения, категории и примерный объем данных и затронутых лиц, вероятных последствий, а также принятые или запланированные меры по восстановлению и смягчению последствий. По мере прохождения расследования мы сообщим обновленную информацию.+</Accordion>+</AccordionGroup>++## Сохранение и удаление данных++<AccordionGroup>+<Accordion title="Когда удалена отдельная CRM запись, когда она удаляется из активных систем?">+Когда запись удаляется, она сначала помечается как мягко удаленная (soft-delete) и все еще может быть восстановлена. Она безвозвратно удаляется и исключается из активных систем, как только истекает срок хранения или пользователь вручную уничтожает её.+</Accordion>+<Accordion title="Как долго мягко удаленные записи хранятся в системе?">+По умолчанию мягко удаленные записи хранятся в течение 14 дней, после чего они безвозвратно удаляются из системы. Период хранения мягко удалённых записей можно изменить в Настройках → General → Security.+</Accordion>+<Accordion title="Как долго эта запись может оставаться в резервных копиях или технических журналах?">+Удаленная запись остается в резервных копиях в течение 30 дней, после чего она безвозвратно удаляется.+</Accordion>+<Accordion title="Когда проектное пространство запрашивается или полностью удаляется, какой точный график применяется к производственным данным, вложениям, журналам и резервным копиям?">+Когда рабочее пространство удаляется, его данные удаляются из рабочих систем в течение примерно 90 дней после прекращения оказания услуг, а обычно и гораздо раньше. Резервные и архивные копии затем перезаписываются или очищаются в течение следующих 90 дней, после чего все данные безвозвратно удаляются. В течение обоих этих периодов данные изолированы от какого-либо использования в рабочих системах. По запросу мы можем предоставить письменное подтверждение после завершения очистки. Полные условия см. в пункте 4.9 вашего Соглашения об обработке данных (Data Processing Agreement).+</Accordion>+<Accordion title="В течение любого периода резервного копирования удаляются данные, изолированные от оперативного доступа и использования?">+Да, в любой период резервного копирования удалённые данные изолированы от операционного использования.+</Accordion>+<Accordion title="Остаются ли какие-либо категории данных дольше для целей законного, выставления счетов, предотвращения мошенничества, обеспечения безопасности или аудита? Если да, какая категория и на сколько долгой?">+Для получения дополнительной информации о сохранении данных вы можете запросить нашу политику управления данными и их удержания в [нашем Центре доверия](https://trust.twenty.com/?tab=documents).+</Accordion>+<Accordion title="Можно ли представить 20 письменных подтверждений после завершения полного запроса на удаление?">+Мы подтверждаем стирание запросов и предоставляем письменное подтверждение после завершения удаления.+</Accordion>+</AccordionGroup>++## Резервные копии и устойчивость++<AccordionGroup>+<Accordion title="Какой срок резервного копирования и хранения данных?">+Резервные копии создаются непрерывно с ежедневными снапшотами, а период хранения составляет 30 дней.+</Accordion>+<Accordion title="Какова цель в отношении двадцати облаков и сроки восстановления?">+RTO и RPO - это и 6 часов (по нашей DPA).+</Accordion>+<Accordion title="Каков процесс запроса или выполнения восстановления?">+Чтобы запросить восстановление, обратитесь к нашей команде через чат поддержки или по электронной почте на адрес [[email protected]](mailto:[email protected]).+</Accordion>+<Accordion title="Зашифрованы ли резервные копии и хранятся в том же регионе, что и основные данные рабочей области?">+Все резервные копии зашифрованы и хранятся в географически отдельных местах в пределах одной и той же юрисдикции (например, в рамках ЕС для данных ЕС).+</Accordion>+</AccordionGroup>++## Соблюдение++<AccordionGroup>+<Accordion title="Двадцать GDPR совместимы?">+Да, двадцать это [GDPR совместимое] (https://trust.twenty.com/?tab=securityControls&frameworks=gdpr_v1).+</Accordion>+<Accordion title="Соответствует ли двадцать SOC 2?">+Да, двадцать - [SOC 2 compliant](https://trust.twenty.com/?tab=securityControls\&frameworks=soc2_v1).+</Accordion>+<Accordion title="Двадцать ли HIPAA соблюдаются?">+Нет, двадцать лет находится в процессе обеспечения соблюдения требований в отношении HIPAA.+</Accordion>+</AccordionGroup>++## Лицензирование++<AccordionGroup>+<Accordion title="Если я изменю код, чтобы добавить функции только для внутреннего использования моей командой, должен ли я публиковать эти изменения?">+Нет. Запуск модифицированной версии только для вашей собственной команды не является распространением, поэтому не возникает обязанности по публикации. Сетевое положение AGPL применяется, когда люди вне вашей организации взаимодействуют с вашим модифицированным экземпляром по сети.+</Accordion>+<Accordion title="Если я создам отдельный фронтенд и буду использовать Twenty как бэкенд без изменений, должен ли я публиковать эти изменения?">+Нет. Ваш фронтенд является вашим собственным, отдельным произведением, и тот факт, что он взаимодействует с Twenty через его API, не меняет этого. Поскольку Twenty само по себе не модифицировано, публиковать нечего.+</Accordion>+<Accordion title="Если я изменю код, чтобы добавить функции и затем перепродавать его, должен ли я публиковать эти изменения?">+Да, поскольку вы модифицируете код, чтобы распространять его другим, вы обязаны публиковать эти изменения. Если вы не хотите публиковать свои изменения, вы можете получить лицензию Organization.+</Accordion>+</AccordionGroup>++Если у вас есть дополнительные вопросы, ознакомьтесь, пожалуйста, с нашими [Условиями и положениями](https://twenty.com/terms), [Политикой конфиденциальности](https://twenty.com/privacy-policy) и [Центром доверия](https://trust.twenty.com/). Если на ваши вопросы все еще нет ответа, отправьте их на [[email protected]](mailto:[email protected]) или через чат поддержки.diff --git a/packages/twenty-docs/l/ru/user-guide/legal/overview.mdx b/packages/twenty-docs/l/ru/user-guide/legal/overview.mdxnew file mode 100644index 00000000000..79012555239--- /dev/null+++ b/packages/twenty-docs/l/ru/user-guide/legal/overview.mdx@@ -0,0 +1,12 @@+---+title: Юридическая информация+description: Юридические вопросы+---++Ознакомьтесь с нашим [FAQ](/l/ru/user-guide/legal/how-tos/legal-faq).++## Полезные ссылки++* [Правила и условия](https://twenty.com/terms)+* [Политика конфиденциальности](https://twenty.com/privacy-policy)+* [Центр доверия](https://trust.twenty.com/)diff --git a/packages/twenty-docs/l/ru/user-guide/permissions-access/capabilities/permissions.mdx b/packages/twenty-docs/l/ru/user-guide/permissions-access/capabilities/permissions.mdxindex cf411eb3c0c..2fd34f96ef8 100644--- a/packages/twenty-docs/l/ru/user-guide/permissions-access/capabilities/permissions.mdx+++ b/packages/twenty-docs/l/ru/user-guide/permissions-access/capabilities/permissions.mdx@@ -29,7 +29,7 @@ description: Управляйте доступом к объектам, поля4. Нажмите **Подтвердить** в модальном окне<Note>-Если роль удалена, любой участник рабочего пространства, назначенный на неё, будет автоматически переназначен на роль по умолчанию. Все роли, кроме **Администратора**, могут быть удалены. Всегда должен быть назначен хотя бы один участник на роль **Администратора**.+Если роль удалена, любой участник рабочего пространства, назначенный на неё, будет автоматически переназначен на роль по умолчанию. Все роли кроме роли **Администратора** могут быть удалены. Всегда должен быть назначен хотя бы один участник на роль **Администратора**.</Note>## Назначение ролей участникам@@ -62,7 +62,7 @@ description: Управляйте доступом к объектам, поля## Настроить разрешения-Разрешения определяют, что каждая роль может получить доступ или изменить в вашем рабочем пространстве, включая объекты и записи рабочего пространства, настройки и действия.+Разрешения определяют, что каждая роль может получить доступ к вашей рабочей области или изменять ее, включая объекты, записи, настройки и действия.### Разрешения на уровне объекта@@ -171,7 +171,7 @@ description: Управляйте доступом к объектам, поля* Переключатель **Все доступ к приложениям** для предоставления полных разрешений* Или включите индивидуальные действия, такие как **Отправить email**, **Импортировать CSV** и **Экспортировать CSV**-## Назначение ролей ключам API и AI-агентам+## Назначить роли агентам API и APIПомимо участников рабочего пространства, роли также можно назначать **ключам API** и **AI-агентам**. Это особенно полезно для команд, которые хотят точно контролировать, «кто» что может делать в их рабочем пространстве — включая автоматизированные процессы и интеграции.diff --git a/packages/twenty-docs/l/ru/user-guide/permissions-access/capabilities/sso-configuration.mdx b/packages/twenty-docs/l/ru/user-guide/permissions-access/capabilities/sso-configuration.mdxindex f0b6d13bd83..2771d49e699 100644--- a/packages/twenty-docs/l/ru/user-guide/permissions-access/capabilities/sso-configuration.mdx+++ b/packages/twenty-docs/l/ru/user-guide/permissions-access/capabilities/sso-configuration.mdx@@ -17,7 +17,7 @@ Twenty поддерживает SSO с:* **SAML 2.0**: работает с большинством корпоративных провайдеров идентификации* **Google Workspace**: для организаций, использующих Google-* **Microsoft Entra ID**: (ранее Azure AD) для сред Microsoft+* **Microsoft Entra ID** (ранее Azure AD): Для среды Microsoft## Настройка SSO@@ -25,11 +25,7 @@ Twenty поддерживает SSO с:* План Organization (облачные и самостоятельно размещённые рабочие пространства)* Доступ администратора к вашему провайдеру идентификации-* Доступ администратора к рабочему пространству Twenty--<Note>-**Для пользователей с самостоятельным размещением, желающих настроить SSO**, свяжитесь по адресу [email protected]-</Note>+* Админ доступ к вашему двадцать проекту### Шаги настройки@@ -68,14 +64,14 @@ Twenty поддерживает SSO с:### Подготовка Just-in-Time (JIT)* Пользователи создаются автоматически при первом входе-* Им автоматически назначается роль по умолчанию+* Пользователям назначена роль по умолчанию автоматически* Ручное создание пользователей не требуется### Ручная подготовка* Пригласите пользователей до того, как они смогут войти* Предварительно назначьте конкретные роли-* Больше контроля над тем, кто имеет доступ+* Дополнительный контроль над тем, кто может получить доступ к проекту## Управление пользователями SSO@@ -112,8 +108,8 @@ Twenty поддерживает SSO с:### Распространённые проблемы-* **Ошибки сертификата**: убедитесь, что срок действия сертификата не истёк-* **Несоответствия URL**: убедитесь, что ACS URL совпадает в точности+* **Ошибки сертификата**: убедитесь, что сертификат не истек+* **Несоответствие URL**: Проверьте соответствие ACS URL* **Пользователь не найден**: проверьте настройки JIT-подготовки### Получение помощи@@ -123,3 +119,7 @@ Twenty поддерживает SSO с:* Полученные сообщения об ошибках* Используемый провайдер идентификации* Подробности конфигурации (без конфиденциальных данных)++<Tip>+Нужно настроить SSO для вашей организации? [Найдите сертифицированного партнёра Twenty](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-sso), который специализируется на настройке SSO и систем идентификации. *(Предпочитаете связаться с Twenty напрямую? [[email protected]](mailto:[email protected]))*+</Tip>diff --git a/packages/twenty-docs/l/ru/user-guide/permissions-access/how-tos/permissions-faq.mdx b/packages/twenty-docs/l/ru/user-guide/permissions-access/how-tos/permissions-faq.mdxindex 88ee4cd22b7..3fa6b58c479 100644--- a/packages/twenty-docs/l/ru/user-guide/permissions-access/how-tos/permissions-faq.mdx+++ b/packages/twenty-docs/l/ru/user-guide/permissions-access/how-tos/permissions-faq.mdx@@ -7,7 +7,7 @@ description: Часто задаваемые вопросы о ролях и р<AccordionGroup><Accordion title="Какие роли доступны в Twenty по умолчанию?">-В Twenty по умолчанию есть роли **Администратор** и **Участник**. Вы можете создавать дополнительные пользовательские роли в зависимости от потребностей вашей команды (например, торговый представитель, менеджер, пользователь только для чтения).+Двадцать поставляется с **Администраторами** и **Участником** по умолчанию. Вы можете создавать дополнительные пользовательские роли в зависимости от потребностей вашей команды (например, торговый представитель, менеджер, пользователь только для чтения).</Accordion><Accordion title="Могу ли я удалить роль Администратора?">diff --git a/packages/twenty-docs/l/ru/user-guide/settings/capabilities/community-settings.mdx b/packages/twenty-docs/l/ru/user-guide/settings/capabilities/community-settings.mdxnew file mode 100644index 00000000000..f69fc404272--- /dev/null+++ b/packages/twenty-docs/l/ru/user-guide/settings/capabilities/community-settings.mdx@@ -0,0 +1,36 @@+---+title: Настройки сообщества+description: Включите функции раннего доступа в Twenty.+---++## О настройках сообщества++Раздел «Сообщество» позволяет включать функции раннего доступа до того, как они станут общедоступными, а также искать партнёров Twenty.++## Функции раннего доступа++Функции раннего доступа — это возможности, которые всё ещё тестируются перед общим релизом.++**Сейчас в раннем доступе:**++* **Junction relations** — Связи «многие ко многим»++### Как включить функции раннего доступа++1. Перейдите в **Настройки → Сообщество**+2. Перейдите в раздел **Функции**+3. Найдите функцию, которую хотите включить+4. Включите переключатель+5. Функция станет доступна сразу++<Note>+Функции раннего доступа могут изменяться в зависимости от отзывов пользователей. Ваша обратная связь помогает улучшать Twenty!+</Note>++## Обратная связь по функциям++Ваша обратная связь помогает улучшать Twenty:++* Сообщайте о проблемах с функциями раннего доступа+* Расскажите, как вы используете новые функции+* Предлагайте улучшения через [сообщество в Discord](https://discord.gg/cx5n4Jzs57)diff --git a/packages/twenty-docs/l/ru/user-guide/settings/capabilities/domains-settings.mdx b/packages/twenty-docs/l/ru/user-guide/settings/capabilities/domains-settings.mdxindex ee541722368..feae32e714f 100644--- a/packages/twenty-docs/l/ru/user-guide/settings/capabilities/domains-settings.mdx+++ b/packages/twenty-docs/l/ru/user-guide/settings/capabilities/domains-settings.mdx@@ -1,21 +1,20 @@---title: Настройки доменов-description: Настройте домен рабочего пространства, утверждённые домены доступа и публичные домены.+description: Настройте домен рабочего пространства, утверждённые домены доступа и собственные домены приложения.---Настройки доменов находятся в трёх местах, в зависимости от того, что вы настраиваете.## Домен рабочей области-Настройте в **Настройки → Общие → Домен рабочего пространства**.+Настройте в разделе **Settings → General**.Измените имя своего субдомена или установите собственный домен для вашего рабочего пространства.### Настроить домен-1. Нажмите **Настроить домен**-2. Измените свой субдомен (например, `yourcompany.twenty.com`)-3. Или настройте собственный домен (например, `crm.yourcompany.com`)+1. Нажмите на **Subdomain** для редактирования поддомена (например, `yourcompany.twenty.com`)+2. Или нажмите на **Пользовательский домен** для настройки пользовательского домена (например, `crm.yourcompany.com`)Для собственных доменов вам потребуется настроить параметры DNS у вашего провайдера домена.@@ -23,7 +22,7 @@ description: Настройте домен рабочего пространстНастройте в **Настройки → Участники → Пригласить**.-Любой пользователь с адресом электронной почты в этих доменах может автоматически зарегистрироваться в этом рабочем пространстве.+Добавьте домен вашей компании, чтобы члены команды могли автоматически зарегистрироваться на этот проект.### Добавить утвержденный домен доступа@@ -37,18 +36,17 @@ description: Настройте домен рабочего пространстЭто удобно: вся ваша команда сможет самостоятельно зарегистрироваться, при этом рабочее пространство останется доступным только для вашей организации.</Note>-## Публичные домены+## Собственные домены приложения-Настройте в **Настройки → Приложения → Разработчик**.+Настройте в **Настройки → Приложения → ваше приложение → Настройки → App URL**.-Подготовьте полную и безопасную хостинг-среду на этих доменах. Публичный домен можно привязать к определённому приложению — при такой привязке только функции логики с HTTP-маршрутизацией этого приложения будут доступны на домене. Оставьте привязку пустой, чтобы открыть доступ ко всем HTTP-маршрутам рабочего пространства.+Приложения, предоставляющие маршруты в Интернете, обслуживаются по отдельному URL-адресу, указанному в разделе **App URL**. Вместо этого вы можете обслуживать приложение на принадлежащем вам домене.-### Добавить публичный домен+### Добавить собственный домен-1. Нажмите **Добавить публичный домен**-2. Введите домен, который вы хотите использовать-3. При желании привяжите его к приложению-4. Настройте параметры DNS согласно инструкциям-5. Подтвердите домен+1. Нажмите на **Пользовательский домен**+2. Введите домен, который вы хотите использовать (например, `app.yourcompany.com`)+3. Настройте параметры DNS согласно инструкциям+4. Подтвердите домен-SSL-сертификаты автоматически выпускаются для публичных доменов.+Только маршруты этого приложения будут доступны на этом домене. SSL-сертификаты выдаются автоматически.diff --git a/packages/twenty-docs/l/ru/user-guide/settings/capabilities/member-management.mdx b/packages/twenty-docs/l/ru/user-guide/settings/capabilities/member-management.mdxindex b481e094e9a..4a97473d202 100644--- a/packages/twenty-docs/l/ru/user-guide/settings/capabilities/member-management.mdx+++ b/packages/twenty-docs/l/ru/user-guide/settings/capabilities/member-management.mdx@@ -9,7 +9,7 @@ description: Пригласите членов команды и управля### Использование приглашения по электронной почте-1. Перейдите в **Настройки → Участники**+1. Перейдите в **Настройки → Участники → Пригласить**2. Нажмите **+ Пригласить**3. Введите адрес электронной почты получателя4. Выберите роль для нового участника@@ -19,7 +19,7 @@ description: Пригласите членов команды и управля### Использование ссылки-приглашения-1. Перейдите в **Настройки → Участники**+1. Перейдите в **Настройки → Участники → Пригласить**2. Скопируйте ссылку приглашения в рабочее пространство3. Поделитесь ссылкой с новыми участниками команды4. Они получат доступ после регистрации@@ -28,10 +28,9 @@ description: Пригласите членов команды и управля### Просмотр всех участников-Перейдите в **Настройки → Участники**, чтобы увидеть:+Перейдите в **Настройки → Члены → Команда**, чтобы увидеть всех активных участников-* Все активные участники-* Ожидающие приглашения+Перейдите в **Настройки → Участники → Приглашение** чтобы увидеть нерассмотренные приглашения### Редактирование профиля участника@@ -56,15 +55,15 @@ description: Пригласите членов команды и управля### Удаление участника1. Нажмите на участника, чтобы открыть его профиль-2. Нажмите **Удалить**, чтобы удалить участника из рабочего пространства+2. Нажмите на **Удалить учетную запись** для удаления их из проекта<Warning>Удалённые участники сразу теряют доступ. Их данные (записи, заметки, задачи) остаются в рабочем пространстве.</Warning>-<Warning>-**Синхронизация электронной почты также отключается.** Если удалённый пользователь был единственным, кто синхронизировал определённые письма, эти письма будут безвозвратно удалены из рабочего пространства.-</Warning>+<Note>+Письма и календарные события удаленного участника архивируются и доступны для других участников.+</Note>## Ожидающие приглашения@@ -84,4 +83,4 @@ description: Пригласите членов команды и управля## Связанные материалы* [Разрешения](/l/ru/user-guide/permissions-access/capabilities/permissions) — настройте, что может делать каждая роль-* [Настройки доменов](/l/ru/user-guide/settings/capabilities/domains-settings) — настройте список разрешённых доменов+* [Настройки домена](/l/ru/user-guide/settings/capabilities/domains-settings) — настройте одобренные доменыdiff --git a/packages/twenty-docs/l/ru/user-guide/settings/capabilities/profile-settings.mdx b/packages/twenty-docs/l/ru/user-guide/settings/capabilities/profile-settings.mdxindex f89ae77a353..ce549b9c00a 100644--- a/packages/twenty-docs/l/ru/user-guide/settings/capabilities/profile-settings.mdx+++ b/packages/twenty-docs/l/ru/user-guide/settings/capabilities/profile-settings.mdx@@ -17,8 +17,8 @@ description: Управляйте вашим личным профилем и нВключите 2FA, чтобы добавить дополнительный уровень безопасности к вашему аккаунту:-1. Перейдите в **Настройки → Настройки профиля**-2. Нажмите **Включить 2FA**+1. Перейдите в **Настройки → Профиль**+2. Нажмите **Приложение-аутентификатор**3. Сканируйте QR-код с помощью вашего приложения аутентификатора4. Введите код подтверждения, чтобы подтвердить@@ -32,12 +32,12 @@ description: Управляйте вашим личным профилем и н### Удаление аккаунта<Warning>-Удаление вашего аккаунта навсегда лишит вас доступа ко всем рабочим пространствам. Это действие нельзя отменить, вы потеряете доступ ко всем рабочим группам, где вы являетесь участником, и вам следует рассмотреть возможность покидания отдельных рабочих групп, если вы хотите выйти только из определенных команд.+Удаление вашего аккаунта навсегда лишит вас доступа ко всем рабочим пространствам. Это действие нельзя отменить. Вы потеряете доступ ко всем рабочим пространствам, в которых вы являетесь участником. Если вы хотите выйти только из определённых команд, рассмотрите возможность покинуть отдельные рабочие пространства вместо этого.</Warning>Чтобы удалить ваш аккаунт:-1. Перейдите в **Настройки → Настройки профиля**+1. Перейдите в **Настройки → Профиль**2. Прокрутите до **Опасной зоны**3. Нажмите **Удалить аккаунт**4. Подтвердите, введя свой адрес электронной почтыdiff --git a/packages/twenty-docs/l/ru/user-guide/settings/capabilities/workspace-settings.mdx b/packages/twenty-docs/l/ru/user-guide/settings/capabilities/workspace-settings.mdxindex 66f4d37d571..6403543f021 100644--- a/packages/twenty-docs/l/ru/user-guide/settings/capabilities/workspace-settings.mdx+++ b/packages/twenty-docs/l/ru/user-guide/settings/capabilities/workspace-settings.mdx@@ -3,7 +3,7 @@ title: Настройки рабочей областиdescription: Настройте название и брендинг вашей рабочей области.----Они доступны в разделе **Настройки → Общие**.+Ваши настройки изображения, имени и удаления рабочей области доступны в разделе **Настройки → Общие**.## Изображение рабочей области@@ -19,12 +19,12 @@ description: Настройте название и брендинг вашей## Опасная зона<Warning>-Удаление вашей рабочей области навсегда удалит все данные и не может быть отменено. Все данные рабочей области будут потеряны навсегда, все участники мгновенно потеряют доступ, и это действие не может быть отменено.+Удаление вашего проекта навсегда удаляет все данные и немедленно отменяет доступ для всех участников — это действие не может быть отменено.</Warning>Чтобы удалить вашу рабочую область:-1. Нажмите кнопку **Удалить рабочую область**+1. Нажмите на кнопку **Удалить проект**2. Подтвердите удаление, когда будет предложено**Примечание**: Только администраторы рабочей области могут ее удалять.diff --git a/packages/twenty-docs/l/ru/user-guide/settings/how-tos/settings-faq.mdx b/packages/twenty-docs/l/ru/user-guide/settings/how-tos/settings-faq.mdxindex b101e3dc06d..58b2b0f0b34 100644--- a/packages/twenty-docs/l/ru/user-guide/settings/how-tos/settings-faq.mdx+++ b/packages/twenty-docs/l/ru/user-guide/settings/how-tos/settings-faq.mdx@@ -154,17 +154,18 @@ description: Часто задаваемые вопросы о настройк<AccordionGroup><Accordion title="Что такое функции раннего доступа?">-Функции раннего доступа — это возможности, которые тестируются перед общим релизом. В настоящее время в раннем доступе только **Панели**. Они могут изменяться в зависимости от отзывов пользователей.+Функции раннего доступа — это возможности, которые тестируются перед общим релизом.</Accordion><Accordion title="Безопасно ли использовать функции раннего доступа?">-Функции раннего доступа работают, но могут изменяться в зависимости от отзывов пользователей. Ими безопасно пользоваться, но до общей доступности они могут измениться.+Функции раннего доступа являются функциональными и безопасными для использования, но могут измениться в зависимости от обратной связи пользователя до общей доступности.</Accordion><Accordion title="Как включить функции раннего доступа?">-1. Перейдите в **Настройки → Обновления → Ранний доступ**-2. Найдите нужную функцию-3. Включите переключатель-4. Функция станет доступна сразу+1. Перейдите в **Настройки → Сообщество**+2. Прокрутите вниз до секции **Особенности**+3. Найдите нужную функцию+4. Включите переключатель+5. Функция станет доступна сразу</Accordion></AccordionGroup>diff --git a/packages/twenty-docs/l/ru/user-guide/views-pipelines/capabilities/calendar-view.mdx b/packages/twenty-docs/l/ru/user-guide/views-pipelines/capabilities/calendar-view.mdxindex 6dfbfe1ca69..dcc056f1dcf 100644--- a/packages/twenty-docs/l/ru/user-guide/views-pipelines/capabilities/calendar-view.mdx+++ b/packages/twenty-docs/l/ru/user-guide/views-pipelines/capabilities/calendar-view.mdx@@ -13,7 +13,7 @@ description: Отображайте записи с полями даты в к1. Перейдите к объекту с полями даты2. Откройте выпадающее меню представления → **+ Добавить представление**-3. Назовите представление и нажмите **Создать**+3. Назовите представление и нажмите **Создать**4. Откройте **Параметры** справа5. Выберите **Календарь** в качестве макета6. Выберите **поле даты**, которое будет использоваться для размещения записейdiff --git a/packages/twenty-docs/l/ru/user-guide/views-pipelines/capabilities/fields-and-columns.mdx b/packages/twenty-docs/l/ru/user-guide/views-pipelines/capabilities/fields-and-columns.mdxindex 8a9c7415d06..461fe3211c9 100644--- a/packages/twenty-docs/l/ru/user-guide/views-pipelines/capabilities/fields-and-columns.mdx+++ b/packages/twenty-docs/l/ru/user-guide/views-pipelines/capabilities/fields-and-columns.mdx@@ -41,7 +41,7 @@ description: Выберите, какие поля отображать, и ка## Лучшие практики-* **Показывайте только нужное** — слишком много полей перегружает представление+* **Показать только что нужно** — слишком много полей, не позволяющих увидеть* **Размещайте важные поля первыми** — самые часто используемые столбцы слева* **Создавайте несколько представлений** — разные наборы полей для разных задач* **Используйте видимость полей для каждого представления** — один и тот же объект, разные акцентыdiff --git a/packages/twenty-docs/l/ru/user-guide/views-pipelines/capabilities/kanban-views.mdx b/packages/twenty-docs/l/ru/user-guide/views-pipelines/capabilities/kanban-views.mdxindex f59254e4ae8..1bac7a394ba 100644--- a/packages/twenty-docs/l/ru/user-guide/views-pipelines/capabilities/kanban-views.mdx+++ b/packages/twenty-docs/l/ru/user-guide/views-pipelines/capabilities/kanban-views.mdx@@ -11,13 +11,13 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';## Перемещайте карточки между этапами-Каждая карта может перемещаться по мере прохождения рабочего процесса путем перетаскивания. Для продолжения удерживайте нажатие на карточке и переместите её в следующую стадию.+Вы можете перемещать каждую карточку между этапами по мере прохождения рабочего процесса, нажав и удерживая карточку, а затем перетащив её на следующий этап.<VimeoEmbed videoId="927888627" title="Видеодемонстрация" />## Добавление и удаление этапов-Вы можете настроить ваш рабочий процесс в соответствии с вашими нуждами, используя стадии, которые представляют значение в поле выбора:+Вы можете настроить ваш рабочий процесс в соответствии с вашими нуждами, используя этапы, каждый из которых представляет значение в поле выбора:### Добавить стадии@@ -31,13 +31,13 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';## Отображаемые поля-Вы можете настроить доску Канбан для отображения некоторых полей и скрытия других. Чтобы скрыть поле, нажмите **Параметры** в правом верхнем углу, затем нажмите **Поля**, чтобы открыть список параметров. Найдите нужное поле в разделе Скрытые поля и нажмите на значок в виде глаза, чтобы отобразить поле.+Вы можете настроить доску Канбан для отображения некоторых полей и скрытия других. Чтобы показать или скрыть поле, нажмите **Параметры** в правом верхнем углу, затем **Поля**, чтобы открыть список параметров, и нажмите на значок глаза рядом с полем, чтобы показать или скрыть его.Вы также можете изменить порядок полей, удерживая имя поля и перетаскивая его туда, где хотите видеть.<img src="/images/user-guide/kanban-views/filter.png" style={{width:'100%'}} />-## Компактный Вид+## Компактный видВы можете скрыть все поля и получить обзор всех записей одним взглядом. Чтобы включить:diff --git a/packages/twenty-docs/l/ru/user-guide/views-pipelines/how-tos/create-a-kanban-view-for-projects.mdx b/packages/twenty-docs/l/ru/user-guide/views-pipelines/how-tos/create-a-kanban-view-for-projects.mdxindex a9942320283..5898ec5004a 100644--- a/packages/twenty-docs/l/ru/user-guide/views-pipelines/how-tos/create-a-kanban-view-for-projects.mdx+++ b/packages/twenty-docs/l/ru/user-guide/views-pipelines/how-tos/create-a-kanban-view-for-projects.mdx@@ -40,7 +40,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';<img src="/images/user-guide/kanban-views/filter.png" style={{width:'100%'}} />-### Включение компактного вида+### Включить компактный видДля общего обзора:diff --git a/packages/twenty-docs/l/ru/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline.mdx b/packages/twenty-docs/l/ru/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline.mdxindex dbc2b847aa9..ca2cf6a5cd5 100644--- a/packages/twenty-docs/l/ru/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline.mdx+++ b/packages/twenty-docs/l/ru/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline.mdx@@ -31,7 +31,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';| **Закрыта — проиграно** | Сделка неуспешна |<Note>-**Оптимально 5–7 стадий.** Слишком много стадий усложняет просмотр воронки; слишком мало — снижает прозрачность прогресса по сделкам.+**5-7 этапов оптимальны.** Слишком много этапов затрудняют сканирование трубопровода. Слишком мало кто теряет видимость в прогрессе.</Note>## Шаг 2: Создайте представление воронки@@ -60,9 +60,9 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';2. Выберите тип агрегации (Count, Sum, Average и т. д.)3. Выберите поле для агрегации (например, Amount)-**Пример:** Показать общую стоимость сделок по стадиям, агрегируя Amount с помощью Sum.+**Пример:** Показать общую стоимость сделок по этапам, агрегируя поле Amount с помощью Sum.-### Используйте компактный вид (необязательно)+### Компактный вид (необязательно)Для обзорного вида с минимальным содержимым карточек:diff --git a/packages/twenty-docs/l/ru/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx b/packages/twenty-docs/l/ru/user-guide/views-pipelines/how-tos/track-time-in-stage.mdxindex 598e723d936..a09622c5c1e 100644--- a/packages/twenty-docs/l/ru/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx+++ b/packages/twenty-docs/l/ru/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx@@ -95,7 +95,7 @@ description: Отслеживайте скорость сделок, фикси**Ветвь 1: Этап = Новый (первый этап)**-Поскольку это первый этап, мы записываем только метку входа — предыдущего этапа для расчёта нет.+Поскольку это первый этап, фиксируется только время входа — предыдущего этапа, от которого можно было бы производить вычисления, не существует.1. Добавьте узел **Filter**: Этап = Новый2. Добавьте действие **Code**:diff --git a/packages/twenty-docs/l/ru/user-guide/views-pipelines/overview.mdx b/packages/twenty-docs/l/ru/user-guide/views-pipelines/overview.mdxindex 3ac79a1b852..46e1a60a6fe 100644--- a/packages/twenty-docs/l/ru/user-guide/views-pipelines/overview.mdx+++ b/packages/twenty-docs/l/ru/user-guide/views-pipelines/overview.mdx@@ -30,7 +30,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';### Просмотр Календаря-Отображайте записи с полями даты в календаре. Отлично подходит для:+Календарное представление, отображающее записи с полями даты. Отлично подходит для:* Встречи и мероприятия* Крайние сроки и даты выполнения@@ -56,7 +56,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';### Начните с редактирования существующего представления1. Перейдите к любому объекту (Люди, Компании и т. д.)-2. Выберите макет (Таблица, Канбан или Календарь) в разделе **Параметры** или при необходимости добавьте фильтры и сортировку+2. Выберите макет (Таблица, Канбан или Календарь) в разделе **Параметры** и при необходимости добавьте фильтры и сортировку3. Нажмите **Сохранить как новое представление**4. Назовите представление и нажмите **Создать**5. Продолжайте редактировать новое представлениеdiff --git a/packages/twenty-docs/l/ru/user-guide/workflows/capabilities/use-branches-in-workflows.mdx b/packages/twenty-docs/l/ru/user-guide/workflows/capabilities/use-branches-in-workflows.mdxindex 7a75573d5e4..62f9989bd69 100644--- a/packages/twenty-docs/l/ru/user-guide/workflows/capabilities/use-branches-in-workflows.mdx+++ b/packages/twenty-docs/l/ru/user-guide/workflows/capabilities/use-branches-in-workflows.mdx@@ -20,8 +20,6 @@ description: Разберитесь, как работают ветки и ка3. Задайте условия на каждом узле Filter, чтобы определить, когда эта ветка должна продолжить выполнение4. Продолжат выполнение только те ветки, для которых выполнены условия узла Filter-<img src="/images/user-guide/workflows/branches-with-filters.png" style={{width:'100%'}} />-### Как работают фильтры* Если условие Filter выполнено: ветка продолжает выполнение@@ -74,7 +72,7 @@ TriggerMerged Step: Send Confirmation Email```-Подтверждающее письмо отправится только после завершения обновления клиента и создания заявки.+Письмо с подтверждением отправляется только после завершения обновления и создания заявки.## Лучшие практикиdiff --git a/packages/twenty-docs/l/ru/user-guide/workflows/capabilities/workflow-actions.mdx b/packages/twenty-docs/l/ru/user-guide/workflows/capabilities/workflow-actions.mdxindex 5f970051862..52769c10dde 100644--- a/packages/twenty-docs/l/ru/user-guide/workflows/capabilities/workflow-actions.mdx+++ b/packages/twenty-docs/l/ru/user-guide/workflows/capabilities/workflow-actions.mdx@@ -112,12 +112,12 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';**Настройка**:-* Выберите массив записей с предыдущего шага (например, результаты из Search Records, из Manual trigger with Bulk availability, из code node). Когда шаг Code или «Логическая функция» возвращает массив верхнего уровня, выберите параметр **Whole list**, чтобы выполнить цикл по всему результату.+* Выберите массив записей из предыдущего шага (например, результаты поиска записей, из ручного триггера с массовым доступом, из узла кода). Когда шаг Code или «Логическая функция» возвращает массив верхнего уровня, выберите параметр **Whole list**, чтобы выполнить цикл по всему результату.* Определите действия, которые нужно выполнить для каждой записи в цикле.<Note>-- Внутри итератора можно добавить несколько действий.-- При использовании ветвлений внутри итератора убедитесь, что последний шаг каждой ветки возвращается к итератору, чтобы замкнуть цикл.+- Вы можете добавить несколько действий в Итератор.+- При использовании ветвей внутри Итератора убедитесь, что последний шаг каждой ветви соединяется с Итератором для закрытия цикла.</Note>* Доступ к полям `Current Item`: чтобы использовать поля записи, которая обрабатывается в данный момент, нажмите на шаг **Iterator**, затем выберите **Current item**. Будет отображен список доступных полей этой записи, и их можно выбрать для использования в последующих действиях. Вы также можете выбрать **Use the whole item**, чтобы передать весь текущий элемент на следующий шаг.@@ -181,7 +181,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';### Отправить письмоОтправляет email из вашего рабочего процесса. Подходит для шаблонных групповых писем. Письма будут выглядеть так же, как те, что вы отправляете из своего почтового ящика.-Не подходит для рассылок (им требуется более богатое форматирование) или автоматических цепочек писем.+Это не подходит для рассылок (которые требуют более насыщенного форматирования) или автоматических последовательностей писем.**Предварительные условия**: добавьте учетную запись электронной почты в Настройки → Учетные записи@@ -202,7 +202,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';</Note>* Установите строку темы.-* Составьте текст сообщения. Можно форматировать ссылки, создавать нумерованные и маркированные списки, добавлять вложения.+* Составьте текст сообщения. Вы можете форматировать ссылки, создавать нумерованные списки, списки точек и добавлять вложения.<Note>Добавление HTML-подписей пока невозможно.@@ -213,24 +213,24 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';Выводит форму во время выполнения рабочего процесса для сбора информации от пользователя. Ответы затем можно использовать на последующих шагах для создания записей, отправки писем или выполнения любых других действий на основе введенных данных.<Warning>-**Формы предназначены только для ручных триггеров**. Для рабочих процессов с другими триггерами (запись создана, обновлена и т. д.) формы доступны только через интерфейс запуска рабочего процесса, и это не ожидаемый пользователем опыт. Центр уведомлений будет выпущен в 2026 году для полноценной поддержки форм в автоматизированных рабочих процессах.+**Формы предназначены только для ручных триггеров**. Для рабочих процессов с другими триггерами (запись создана, обновлена и т. д.) формы доступны только через интерфейс запуска рабочего процесса, и это не ожидаемый пользователем опыт. В 2026 году будет открыт центр уведомлений, который будет надлежащим образом поддерживать формы в автоматизированных рабочих процессах.</Warning>**Настройка**:* Настройте поля, которые пользователям предложат заполнить. Для каждого поля выберите- * тип: текст, число, дата, заданная запись, поле выбора. Поля выбора доступны для всех объектов.+ * тип: текст, число, дата, заданная запись, поле выбора. Поля из всех объектов доступны для выбора.* метку* значение по умолчанию в `Placeholder` (необязательно)* Отредактируйте заголовок формы**Вывод**: ответы формы доступны для использования в последующих шагах.-**Пример**: Рабочий процесс "Quick Lead" доступен по умолчанию во всех рабочих пространствах, доступен в любом месте через Command Menu `Cmd + K`.+**Пример**: Рабочий процесс «Quick Lead» доступен по умолчанию во всех рабочих областях, доступных в любом месте в меню командного меню «Cmd+K».**Как заполнить форму**:-* Запустите свой ручной рабочий процесс из командного меню `Cmd K`+* Запустите ручной рабочий процесс из командного меню `Cmd+K`* Заполните форму, отображаемую в боковой панели, и нажмите `Submit`.<Note>@@ -249,7 +249,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';**Настройка**:-* Получайте доступ к переменным из предыдущих шагов. Вы можете динамически изменять имена переменных.+* Получайте доступ к переменным из предыдущих шагов. Вы можете динамически редактировать имена переменных.<VimeoEmbed videoId="1147281795" title="Видеодемонстрация" />diff --git a/packages/twenty-docs/l/ru/user-guide/workflows/capabilities/workflow-credits.mdx b/packages/twenty-docs/l/ru/user-guide/workflows/capabilities/workflow-credits.mdxindex 60b3cb340bf..e0ba7456254 100644--- a/packages/twenty-docs/l/ru/user-guide/workflows/capabilities/workflow-credits.mdx+++ b/packages/twenty-docs/l/ru/user-guide/workflows/capabilities/workflow-credits.mdx@@ -70,7 +70,6 @@ description: Разберитесь с потреблением и управл## Лучшие практики-* **Пакетная обработка**: Используйте массовые операции и действия с Итератором эффективно+* **Пакетная обработка**: Используйте массовые операции и действия с Итератором эффективно, чтобы сократить количество отдельных вызовов действий* **Оптимизация ручного запуска**: Для ручных триггеров выберите вариант `Bulk`, чтобы обработать несколько записей за один запуск рабочего процесса* Оптимизируйте действия с кодом для повышения эффективности-* Пакетные операции для снижения числа отдельных вызовов действийdiff --git a/packages/twenty-docs/l/ru/user-guide/workflows/capabilities/workflow-runs.mdx b/packages/twenty-docs/l/ru/user-guide/workflows/capabilities/workflow-runs.mdxindex e1fef511671..9dfa5f39096 100644--- a/packages/twenty-docs/l/ru/user-guide/workflows/capabilities/workflow-runs.mdx+++ b/packages/twenty-docs/l/ru/user-guide/workflows/capabilities/workflow-runs.mdx@@ -57,11 +57,13 @@ description: Отслеживайте и управляйте запусками1. Откройте запуск со сбоем2. Найдите шаг, вызвавший сбой3. Посмотрите подробности в сообщении об ошибке-4. Распространённые проблемы:- * Отсутствуют обязательные поля- * Недопустимый формат данных- * Ошибки внешнего API- * Проблемы с правами доступа++Распространённые проблемы:++* Отсутствуют обязательные поля+* Недопустимый формат данных+* Ошибки внешнего API+* Проблемы с правами доступа## Повторный запуск рабочих процессовdiff --git a/packages/twenty-docs/l/ru/user-guide/workflows/capabilities/workflow-triggers.mdx b/packages/twenty-docs/l/ru/user-guide/workflows/capabilities/workflow-triggers.mdxindex c99b800b556..a3597d9b4c3 100644--- a/packages/twenty-docs/l/ru/user-guide/workflows/capabilities/workflow-triggers.mdx+++ b/packages/twenty-docs/l/ru/user-guide/workflows/capabilities/workflow-triggers.mdx@@ -26,8 +26,8 @@ description: Узнайте о различных триггерах, котор**Настройка**: Выберите тип объекта для отслеживания новых записей.<Note>-* Этот триггер отлично подходит для записей, созданных через CSV, синхронизацию почтового ящика и календаря, а также через API.-* **Не рекомендуется для записей, создаваемых вручную**: с этим триггером рабочие процессы запускаются сразу после создания записи. Поскольку интерфейс Twenty предлагает автосохранение на лету (нет режима редактирования и последующего подтверждения для сохранения записей), рабочий процесс будет запущен до того, как пользователь введет все поля.+* Этот триггер отлично подходит для записей, созданных CSV, почтового ящика и синхронизации календаря или API.+* **Не рекомендуется для записей, создаваемых вручную**: с этим триггером рабочие процессы запускаются сразу после создания записи. Поскольку двадцать пользовательский интерфейс предлагает автосохранение на лету (нет режима редактирования, а затем проверка для сохранения записей), рабочий процесс будет срабатывать перед вводом пользователем всех полей.Чтобы запускать этот рабочий процесс для записей, создаваемых вручную, рекомендуется вместо этого использовать триггер `Record is created or updated`.</Note>@@ -69,15 +69,17 @@ description: Узнайте о различных триггерах, котор**Настройка доступности**: Выберите, как рабочий процесс должен обрабатывать выбор записи:-* **Глобально**: Для запуска этого рабочего процесса запись не требуется. Рабочий процесс запускается из командного меню `Cmd + K` в любом месте (с любого объекта) и не использует записи в качестве входных данных.+* **Глобально**: Для запуска этого рабочего процесса запись не требуется. Рабочий процесс запускается из командного меню «Cmd+K» где угодно (из любого объекта) и не использует запись(и) в качестве входа.-* **Одиночная**: Выбранные записи будут переданы в ваш рабочий процесс. Это настроено для заданного объекта. Несколько записей могут быть выбраны до запуска рабочего процесса. Рабочий процесс будет выполняться от начала до конца столько раз, сколько выбрано записей.+Для доступности **сингл** и **Bulk**, выбранная запись (ы) будет передана вашему рабочему процессу. Это настроено для данного объекта, и можно выбрать несколько записей перед запуском рабочего процесса.++* **Сингл**: Рабочий процесс будет работать от начала до конца столько раз, сколько будут выбраны записи.<Note>**Мягкий лимит: 100 запусков в минуту**. При превышении этого значения рабочие процессы остаются в статусе "Not Started" и обрабатываются постепенно — либо фоновой задачей, либо когда другой рабочий процесс попадает в очередь. Это означает, что вы можете выбрать более 100 записей с помощью одного триггера; выполнение просто будет медленнее.</Note>-* **Групповая обработка**: Выбранные записи будут переданы в ваш рабочий процесс. Это настроено для заданного объекта. Несколько записей могут быть выбраны до запуска рабочего процесса. Рабочий процесс будет выполнен один раз, предоставляя весь список записей в качестве входных данных. Это означает, что рабочий процесс должен содержать [действие Iterator](/l/ru/user-guide/workflows/capabilities/workflow-actions#iterator).+* **Bulk**: Рабочий процесс будет работать один раз, представляя весь список записей в качестве входных данных. Это означает, что рабочий процесс должен содержать [действие Iterator](/l/ru/user-guide/workflows/capabilities/workflow-actions#iterator).<Note>Это более продвинутый вариант и лучше всего подходит для тех, кто хочет оптимизировать количество запусков рабочего процесса.diff --git a/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty.mdx b/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty.mdxindex 49f9235156e..884d790ae87 100644--- a/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty.mdx+++ b/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty.mdx@@ -17,7 +17,7 @@ description: Создайте рабочий процесс для созданПрежде чем настраивать рабочий процесс:-1. **Создайте ключ API**: перейдите в **Настройки → APIs** и создайте новый ключ API. Этот токен понадобится для логической функции.+1. **Создайте ключ API**: перейдите в **Настройки → APIs** и создайте новый ключ API. Вам понадобится этот токен для логической функции.2. **Настройте сервис генерации PDF** (необязательно): если вы хотите динамически генерировать PDF (например, коммерческие предложения), используйте такие сервисы, как Carbone, PDFMonkey или DocuSeal, чтобы создать PDF и получить URL для скачивания.## Пошаговая настройка@@ -29,12 +29,12 @@ description: Создайте рабочий процесс для создан3. Выберите объект, к которому нужно прикреплять PDF (например, **Company** или **Opportunity**)<Tip>-С помощью ручного триггера пользователи могут запускать этот рабочий процесс с кнопки, которая появляется в правом верхнем углу после выбора записи, чтобы сгенерировать и прикрепить PDF.+С ручным триггером, пользователи могут запускать этот рабочий процесс, используя кнопку, которая появляется в правом верхнем углу после выбора записи, которая запускает рабочий процесс для создания и прикрепления PDF.</Tip>### Шаг 2: Добавьте логическую функцию-1. Добавьте действие **Code** (логическая функция)+1. Добавить действие **код** (логическая функция)2. Создайте новую функцию с кодом ниже3. Настройте входные параметры@@ -237,7 +237,7 @@ export const main = async (| 1 | Ручной триггер (Company) | Пользователь запускает на записи || 2 | Поиск записи | Получить сведения о сделке или позициях || 3 | HTTP-запрос | Вызвать API генерации PDF с данными записи |-| 4 | Бессерверная функция | Скачать и прикрепить сгенерированный PDF |+| 4 | Логическая функция | Скачать и прикрепить сгенерированный PDF |### Популярные сервисы генерации PDF@@ -246,7 +246,7 @@ export const main = async (* **DocuSeal** — платформа автоматизации документооборота* **Documint** — генерация документов, ориентированная на API-Каждый сервис предоставляет API, который возвращает URL PDF; затем его можно передать в логическую функцию.+Каждый сервис предоставляет API, который возвращает URL-адрес PDF, который затем можно передать в логическую функцию.## Устранение неполадокdiff --git a/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/crm-automations/auto-reply-to-inbound-emails.mdx b/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/crm-automations/auto-reply-to-inbound-emails.mdxindex eeacc765ab7..ac4a4033994 100644--- a/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/crm-automations/auto-reply-to-inbound-emails.mdx+++ b/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/crm-automations/auto-reply-to-inbound-emails.mdx@@ -3,7 +3,7 @@ title: Автоответ на входящие письмаdescription: Создайте рабочий процесс, который использует ИИ для сортировки входящих писем и автоматически отправляет ответы в рамках цепочки.----Отвечайте на входящие письма за секунды — а не за часы. Этот рабочий процесс использует ИИ-агента, чтобы отфильтровать шум (рассылки, спам, автоответы) и подготовить персонализированный ответ на реальные сообщения, а затем отправляет его как ответ в цепочке внутри исходной переписки.+Отвечайте на входящие письма за секунды — а не за часы. Этот рабочий процесс использует ИИ-агента, чтобы отфильтровать шум (рассылки, спам, автоответы) и подготовить персонализированный ответ на реальные сообщения. Затем ИИ отправляет его как ответ в цепочке внутри исходной переписки.## Как работают цепочки писем@@ -42,7 +42,7 @@ description: Создайте рабочий процесс, который ис<img src="/images/user-guide/workflows/auto-reply/find-sender.png" style={{width:'100%'}} />-### Шаг 4: Классификация ИИ и черновик ответа+### Шаг 4: Классификация и черновик ответа с помощью ИИДобавьте действие **AI Agent**. Этот шаг делает две вещи: решает, заслуживает ли письмо ответа, и, если да, составляет ответ.diff --git a/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/crm-automations/closed-won-automations.mdx b/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/crm-automations/closed-won-automations.mdxindex 3a6c99072dc..b9a04f0fde1 100644--- a/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/crm-automations/closed-won-automations.mdx+++ b/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/crm-automations/closed-won-automations.mdx@@ -165,7 +165,7 @@ export const main = async (params) => {* Разные исполнители в зависимости от региона* Пропускать уведомления для небольших сделок-### Включите детали сделки+### Включить информацию о сделкеИспользуйте действие **Code** для форматирования:diff --git a/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/crm-automations/display-number-of-emails-received.mdx b/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/crm-automations/display-number-of-emails-received.mdxindex 91ada39d849..1e322af6a78 100644--- a/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/crm-automations/display-number-of-emails-received.mdx+++ b/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/crm-automations/display-number-of-emails-received.mdx@@ -56,11 +56,6 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';### Шаг 4: Обновите запись контакта с помощью действия Create or Update Record1. Добавьте действие **Create or Update Record**--<Warning>-Используйте **Upsert Record** вместо **Update Record** здесь. Это позволит идентифицировать контакт по его адресу электронной почты (поле `handle`), а не требовать ID записи из предыдущего шага.-</Warning>-2. Выберите **Контакты** в качестве объекта3. Найдите контакт, сопоставив его адрес электронной почты со значением `handle` из участника сообщения4. Установите значение вашего пользовательского поля "Количество полученных писем" равным `{{searchRecords.totalCount}}`diff --git a/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/crm-automations/formula-fields.mdx b/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/crm-automations/formula-fields.mdxindex 5c2caacff33..997cabb25a6 100644--- a/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/crm-automations/formula-fields.mdx+++ b/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/crm-automations/formula-fields.mdx@@ -55,7 +55,7 @@ export const main = async (params) => {Полный рабочий процесс см. в разделе [Как показать ожидаемую сумму в воронке](/l/ru/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline).-### Быстрая настройка+### Настройка1. **Триггер**: запись обновлена (Возможности, поле Сумма ИЛИ Вероятность)diff --git a/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/crm-automations/notify-teammates-of-note-to-review.mdx b/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/crm-automations/notify-teammates-of-note-to-review.mdxindex 938aa38b527..aec933f1be6 100644--- a/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/crm-automations/notify-teammates-of-note-to-review.mdx+++ b/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/crm-automations/notify-teammates-of-note-to-review.mdx@@ -19,7 +19,7 @@ import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';1. Создайте поле связи **Reviewer** в объекте «Заметки»2. Назначайте проверяющего при создании или редактировании заметки-3. Рабочий процесс автоматически отправляет проверяющему письмо с ссылкой на заметку+3. Привлечь рабочий процесс автоматически отправить письмо рецензенту со ссылкой на заметку<Warning>**Ограничение**: этот подход позволяет назначать по одному проверяющему на поле. Если нужно уведомить нескольких людей, создайте дополнительные поля связи (например, Reviewer 1, Reviewer 2). Это плохо масштабируется, если нужно упомянуть сразу многих участников.diff --git a/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/need-more-help/professional-services.mdx b/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/need-more-help/professional-services.mdxindex 81d5007350f..0ef1c77c55f 100644--- a/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/need-more-help/professional-services.mdx+++ b/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/need-more-help/professional-services.mdx@@ -16,14 +16,6 @@ description: Получите профессиональную помощь в## Варианты услуг-### Пакеты внедрения--Получите помощь от нашей основной команды с нашими 4-часовыми [Пакетами внедрения](https://twenty.com/onboarding-packages):--* **Создание рабочих процессов**: Создавайте пользовательские рабочие процессы для ваших бизнес-процессов-* **Проектирование модели данных**: Оптимизируйте структуру данных для автоматизации рабочих процессов-* **Миграция данных**: Импортируйте существующие данные с правильной интеграцией рабочих процессов-### Партнеры по внедрению-Работайте с сертифицированными партнерами для расширенных настроек. Свяжитесь с нами по адресу [email protected], чтобы соединиться с нашими [партнерами по внедрению](https://twenty.com/partners).+Работайте с сертифицированными партнерами для расширенных настроек. Свяжитесь с нами по адресу [[email protected]](mailto:[email protected]), чтобы связаться с нашими [партнерами по внедрению](https://twenty.com/partners).diff --git a/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx b/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdxindex 52c62f7eacb..ece1063c5b2 100644--- a/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx+++ b/packages/twenty-docs/l/ru/user-guide/workflows/how-tos/need-more-help/workflows-faq.mdx@@ -155,11 +155,9 @@ description: Часто задаваемые вопросы о рабочих п</Accordion><Accordion title="Почему я не вижу свои запуски рабочего процесса?">- Запуски рабочего процесса могут сразу завершаться с ошибкой из-за ограничений скорости.+ Запуски рабочего процесса могут сразу завершаться с ошибкой из-за ограничений скорости. Twenty устанавливает жесткий лимит в 5 000 запусков в час на рабочее пространство.- **Жесткий лимит: 5 000 запусков в час на рабочее пространство.**-- Если вы превышаете этот лимит, рабочие процессы сразу помечаются как завершившиеся с ошибкой и не появляются в списке запусков, как можно было бы ожидать.+ Если вы превышаете этот лимит, рабочие процессы сразу помечаются как завершившиеся с ошибкой и не появляются в вашем списке запусков.**Распространенные сценарии, при которых достигается этот лимит**:* Выбор более 5 000 записей с ручным триггером Singlediff --git a/packages/twenty-docs/l/ru/user-guide/workflows/overview.mdx b/packages/twenty-docs/l/ru/user-guide/workflows/overview.mdxindex 9bebacf74cf..da61b2e552e 100644--- a/packages/twenty-docs/l/ru/user-guide/workflows/overview.mdx+++ b/packages/twenty-docs/l/ru/user-guide/workflows/overview.mdx@@ -73,3 +73,9 @@ Workflows - это встроенная функция Twenty для созда* [Триггеры рабочего процесса](/l/ru/user-guide/workflows/capabilities/workflow-triggers)* [Действия рабочего процесса](/l/ru/user-guide/workflows/capabilities/workflow-actions)* [Автоматизации CRM](/l/ru/user-guide/workflows/how-tos/crm-automations/closed-won-automations)++## Нужна помощь?++<Tip>+ Нужна помощь с автоматизацией ваших рабочих процессов? [Найти сертифицированного партнера](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-workflows) для разработки и создания автоматизации сквозного конца.+</Tip>diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/layout/front-components.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/layout/front-components.mdxindex a8b338cb12b..898740b9f50 100644--- a/packages/twenty-docs/l/tr/developers/extend/apps/layout/front-components.mdx+++ b/packages/twenty-docs/l/tr/developers/extend/apps/layout/front-components.mdx@@ -806,22 +806,22 @@ Bir `ref` size bir `HTMLElement` değil, bir sandbox öğesi verir.| `element.classList.add(...)` | Fırlatır (`classList` `undefined` durumundadır) | `className` dizgisini kendiniz oluşturun || `document.getElementById()`, `getElementsByClassName()`, `createTreeWalker()` | Fırlatır | Çalışan `querySelector()` / `querySelectorAll()` || `document.activeElement` | Her zaman `undefined` | Odağı `onFocus` / `onBlur` ile takip edin |-| `\<canvas>` | Hiçbir şey render etmez, hata yoktur | SVG kullanın veya ekranda olmayan bir alana çizip bir `<img src={dataUrl}>` ile gösterin |+| `canvas` | Hiçbir şey render etmez, hata yoktur | SVG veya ekranda olmayan bir alanda çizim yapıp sonucu bir `img` öğesinde gösterin || `createPortal(node, document.body)` | `isConnected` başarı bildirmesine rağmen hiçbir şey render etmez | `position: absolute` ile satır içi yerleştirilmiş bindirmeler veya kitaplığa kendi konteyner öğenizi iletin |Portal boşluğu, Radix, Headless UI, MUI ve react-select popover’larının varsayılan olarak hiçbir şey render etmemesinin nedenidir. Çoğu bir container prop kabul eder; onu render ettiğiniz bir öğeye yönlendirin.### Etkinlikler-Mouse, pointer, touch, sürükleme, klavye, odak, `input`/`change`/`submit`, `scroll`/`wheel`/`contextmenu` ve `animationend`/`transitionend` ana bilgisayara iletilir, ayrıca birkaç tane de öğe başına vardır: `<img>` üzerinde `load`/`error`, `<input>`/`\<textarea>` üzerinde panoya ve bileşime ilişkin olaylar, `\<video>`/`\<audio>` üzerinde medya, `\<details>`/`\<dialog>` üzerinde `toggle`. Bunun dışındaki her şey (`onAuxClick`, `onSelect`, `onInvalid`, `onReset`, `onAnimationStart`, pointer capture, `<img>` üzerinde `onLoad`) uyarı verilmeden kaldırılır.+Mouse, pointer, touch, sürükleme, klavye, odak, `input`/`change`/`submit`, `scroll`/`wheel`/`contextmenu` ve `animationend`/`transitionend` host’a iletilir, ayrıca öğe başına birkaç tane daha vardır: `img` üzerinde `load`/`error`, `input`/`textarea` üzerinde pano ve bileşim olayları, `video`/`audio` üzerinde medya, `details`/`dialog` üzerinde `toggle`. Bunun dışındaki her şey (`onAuxClick`, `onSelect`, `onInvalid`, `onReset`, `onAnimationStart`, pointer capture, `img` üzerinde `onLoad`) uyarı verilmeden kaldırılır.`document.addEventListener()` ve `window.addEventListener()` hatasız olarak kaydolur ancak asla tetiklenmez; bu yüzden bir sürükleme, işaretçi başladığı öğeden ayrılır ayrılmaz durur. `event.preventDefault()` da geçmez; form gönderimi, `dragover`/`drop` ve bağlantı tıklamaları zaten sizin için korunmuştur.### Öznitelikler ve stillendirme-Her öğe, kendi özelliklerini host DOM’a iletir (`\<a>` üzerinde `href`, `<img>` üzerinde `src`/`alt`, `<input>` üzerinde `value`/`placeholder`/`disabled` vb.), ayrıca her öğede ortak bir küme vardır: `id`, `className`, `style`, `title`, `tabIndex`, `role`, `draggable` ve tireli olan tüm `aria-*` / `data-*` öznitelikleri (bu yüzden `ariaLabel` düşürülür). Bunun dışındaki her şey sessizce atılır, bu yüzden özel durumu `data-*` olarak ifade edin.+Her öğe, kendi özelliklerini host DOM’a iletir (`a` üzerinde `href`, `img` üzerinde `src`/`alt`, `input` üzerinde `value`/`placeholder`/`disabled` vb.), ayrıca her öğede ortak bir küme vardır: `id`, `className`, `style`, `title`, `tabIndex`, `role`, `draggable` ve tireli olan tüm `aria-*` / `data-*` öznitelikleri (bu yüzden `ariaLabel` düşürülür). Bunun dışındaki her şey sessizce atılır, bu yüzden özel durumu `data-*` olarak ifade edin.-Bileşen CSS’i, ister `import './styles.css'` ile, ister CSS-in-JS ile ya da bir `\<style>` öğesinden gelsin, host sayfanın `\<head>` kısmına **scope’suz** olarak enjekte edilir. Bu nedenle sınıf adları Twenty’nin kendi sınıf adlarıyla çakışır (onlara önek ekleyin ve asla çıplak `div { ... }` seçicileri yazmayın) ve `@media`, sizin bileşeniniz yerine tarayıcı penceresini hedefler (kendi `container-type` değerinizle `@container` kullanın). Satır içi `style` prop’ları etkilenmez.+Bileşen CSS’i, ister `import './styles.css'` ile, ister CSS-in-JS ile ya da bir `style` öğesinden gelsin, host sayfanın `head` kısmına **scope’suz** olarak enjekte edilir. Bu nedenle sınıf adları Twenty’nin kendi sınıf adlarıyla çakışır (onlara önek ekleyin ve asla çıplak `div { ... }` seçicileri yazmayın) ve `@media`, sizin bileşeniniz yerine tarayıcı penceresini hedefler (kendi `container-type` değerinizle `@container` kullanın). Satır içi `style` prop’ları etkilenmez.### Depolama ve ağ@@ -835,7 +835,7 @@ Bileşen CSS’i, ister `import './styles.css'` ile, ister CSS-in-JS ile ya da b### Diğer eksikler-* **Dosya içerikleri.** `<input type="file">` handler’ınıza yalnızca dosya meta verilerini verir, baytları vermez, bu yüzden `FileReader` ve yüklemeler henüz mümkün değildir.+* **Dosya içerikleri.** `file` türünde bir `input`, handler’ınıza yalnızca dosya meta verilerini verir, baytları vermez, bu yüzden `FileReader` ve yüklemeler henüz mümkün değildir.* **Sürükle-bırak yükleri.** Sürükleme olayları tetiklenir, ancak `event.dataTransfer` `undefined` durumundadır.* **Node yerleşikleri.** `fs`, `path` ve `node:crypto` build aşamasında başarısız olur; bu nedenle bu işi bir [mantık fonksiyonuna](/l/tr/developers/extend/apps/logic/logic-functions) taşıyın. Web Crypto, `fetch`, `TextEncoder` ve `URL` kullanılabilir durumdadır.-* **`\<iframe>`** her zaman `allow-same-origin` olmadan yeniden sandbox’a alınır, bu nedenle kendi oturumuna güvenen bir yerleştirme, oturum kapalı olarak işlenir. `onLoad`’u da yoktur.+* **`iframe`** her zaman `allow-same-origin` olmadan yeniden sandbox’a alınır, bu nedenle kendi oturumuna güvenen bir yerleştirme, oturum kapalı olarak işlenir. `onLoad`’u da yoktur.diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/translations/overview.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/translations/overview.mdxindex 93cc8ceefd8..9fa870a312a 100644--- a/packages/twenty-docs/l/tr/developers/extend/apps/translations/overview.mdx+++ b/packages/twenty-docs/l/tr/developers/extend/apps/translations/overview.mdx@@ -51,8 +51,7 @@ const Card = ({ count, name }: { count: number; name: string }) => {### Ne zaman hangisi kullanılmalı-* **`<Trans>…</Trans>`** — JSX içindeki statik metin. Değişkelerin (`<Trans message="Hi {name}" values={{ name }} />`) yerleştirilmesi için `message` ve `values`- prop'larını kullanın;+* **`Trans`** — JSX içindeki statik metin. Değişkelerin yerleştirilmesi için `message` ve `values` prop'larını kullanın (`Trans message="Hi {name}" values={{ name }}`);çocukların içine doğrudan yerleştirme statik olarak çıkarılamaz.* **`useTranslate().t`** — bir bileşen içindeki dinamik dizeler. Kullanıcı dili değiştirdiğindeyeniden render edilir. Render içinde bunu tercih edin.@@ -79,7 +78,7 @@ twenty dev:translations-extract # collect strings into locales/twenty dev:translations-extract --locale fr-FR # also scaffold a target locale```-Çıkarma işlemi, manifest etiketlerinizi ve ön bileşen kaynaklarınızdan gelen `t()`/`msg()`/`\<Trans>`+Çıkarma işlemi, manifest etiketlerinizi ve ön bileşen kaynaklarınızdan gelen `t()`/`msg()`/`Trans`dizelerini, kaynak dizeyi anahtar olarak kullanarak `locales/\<locale>.json` içine toplar. Çevirileri doldurun:```json@@ -99,7 +98,7 @@ dizelerini, kaynak dizeyi anahtar olarak kullanarak `locales/\<locale>.json` içmanifest etiketleri sunucu tarafında çözülür ve ön bileşenkatalogları her bileşen paketine gömülür. Çalışma zamanında bir bileşen, yereli yürütme bağlamından (ana makinenin geçerli dili) okurve her dizeyi kataloğuna göre çözer; bir çeviri eksik olduğunda-kaynak metne geri döner. Ana makinede dilin değiştirilmesi, `\<Trans>` ve+kaynak metne geri döner. Ana makinede dilin değiştirilmesi, `Trans` ve`useTranslate().t` dizelerini canlı olarak yeniden render eder.Kataloglar build zamanında derlendiği için, bir çeviriyi güncellemek@@ -110,4 +109,12 @@ Kataloglar build zamanında derlendiği için, bir çeviriyi güncellemek`twenty dev` izlemesi kaynak dizeleri gösterir, bu yüzden yerelleştirilmiş çıktıyı tek seferlik bir build ile test edin.</Note>-`<Trans>` metin alt öğeleri birden fazla satıra yayılabilir — boşluklar, JSX'in boşlukları daraltma biçimiyle aynı şekilde daraltılır; bu nedenle hem `<Trans>Welcome\n back</Trans>` hem de çıkarılan anahtar `Welcome back` olur.+`Trans` metin alt öğeleri birden fazla satıra yayılabilir — boşluklar, JSX'in boşlukları daraltma biçimiyle aynı şekilde daraltılır; bu nedenle her ikisi de `Welcome back` anahtarına dönüştürülür:++```tsx+<Trans>Welcome back</Trans>+<Trans>+ Welcome+ back+</Trans>+```diff --git a/packages/twenty-docs/l/zh/developers/contribute/capabilities/bug-and-requests.mdx b/packages/twenty-docs/l/zh/developers/contribute/capabilities/bug-and-requests.mdxindex eb1b88c1f70..254984b4edf 100644--- a/packages/twenty-docs/l/zh/developers/contribute/capabilities/bug-and-requests.mdx+++ b/packages/twenty-docs/l/zh/developers/contribute/capabilities/bug-and-requests.mdx@@ -22,7 +22,7 @@ info: 报告问题、提出功能请求并贡献代码1. 查看[现有的 issue](https://github.com/twentyhq/twenty/issues)以查找相关工作2. 对于新功能,请先打开一个 issue 进行讨论-3. 阅读我们的[行为准则](https://github.com/twentyhq/twenty/blob/main/CODE_OF_CONDUCT.md)+3. 阅读我们的[行为准则](https://github.com/twentyhq/twenty/blob/main/.github/CODE_OF_CONDUCT.md)### Fork 并克隆diff --git a/packages/twenty-docs/l/zh/developers/contribute/contribute.mdx b/packages/twenty-docs/l/zh/developers/contribute/contribute.mdxindex 9bd5e3ee054..61c5e397f54 100644--- a/packages/twenty-docs/l/zh/developers/contribute/contribute.mdx+++ b/packages/twenty-docs/l/zh/developers/contribute/contribute.mdx@@ -25,7 +25,7 @@ Twenty 是开源的,欢迎社区贡献。 无论您是在修复错误、添加<Card title="错误报告与功能请求" icon="bug" href="/l/zh/developers/contribute/capabilities/bug-and-requests">报告问题或请求功能</Card>- <Card title="前端开发" icon="browser" href="/l/zh/developers/contribute/capabilities/frontend-development">+ <Card title="前端开发" icon="browser" href="/l/zh/developers/contri/capabilities/frontend-development/folder-structure-front">为 UI 做出贡献</Card></CardGroup>diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/config/application.mdxindex 83a94ca2a5c..b3e9b4f6ddc 100644--- a/packages/twenty-docs/l/zh/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/apps/config/application.mdx@@ -37,6 +37,7 @@ export default defineApplication({* 在构建清单时会自动检测安装前、安装后和卸载函数——无需在 `defineApplication()` 中引用它们。* 显式传递 `defaultRoleUniversalIdentifier` 仍然受支持以保持向后兼容性,但已弃用,推荐改用 `defineApplicationRole()`。* `serverVariables` 是实例级的配置和机密信息(例如 API 密钥)。 与 `applicationVariables` 不同,它们不会在 manifest 中声明具体值——工作区运维人员会在应用设置中填写这些值,并且它们只有在被设置后才会被注入到逻辑函数中。+* 两种类型的变量都可以接受 `isDeprecated: true`。 使用它来停用变量而不是删除它:保留已声明的键可以保留存储的值(删除它会销毁操作员输入的值),并且变量仍然会被注入,所以你的代码仍然可以回退到它 — `process.env.NEW_API_KEY ?? process.env.API_KEY`。 一旦弃用变量没有任何值,它就会从应用的设置中消失,并且永远不会计入应用的配置检查中,因此 `isDeprecated` 的优先级高于 `isRequired`。* 要在应用的 **Settings** 选项卡中渲染自定义配置界面(替换默认的变量配置部分),请在其独立文件中使用 [`defineSettingsFrontComponent()`](/l/zh/developers/extend/apps/layout/front-components#custom-settings-component) 声明一个前端组件。 每个应用只允许有一个。 系统管理的部分(自动升级、App URL、连接)将始终保持可见。## 变量类型diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/config/roles.mdxindex d75ee990ecb..5189d5c0767 100644--- a/packages/twenty-docs/l/zh/developers/extend/apps/config/roles.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/apps/config/roles.mdx@@ -200,4 +200,4 @@ export default 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)。+* 查看一个工作示例:[[`exampes/hello-world/src/roles/default-role.ts`](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/examples/hello-world/src/roles/default-role.ts)diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/data/objects.mdxindex 5b14f05e64e..4ac11bedca0 100644--- a/packages/twenty-docs/l/zh/developers/extend/apps/data/objects.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/apps/data/objects.mdx@@ -79,6 +79,7 @@ export default defineObject({* `universalIdentifier` 必须在各次部署间保持唯一且稳定。* 每个字段都需要 `name`、`type`、`label` 以及其自身稳定的 `universalIdentifier`。* `fields` 数组是可选的——你可以定义没有自定义字段的对象。+* `openRecordIn` 设置在点击此对象的记录时,它们会在何处打开:`ObjectOpenRecordIn.USER_CHOICE`(默认,遵循每位工作区成员在 Settings → Experience 中的个人偏好)、`ObjectOpenRecordIn.SIDE_PANEL`,或 `ObjectOpenRecordIn.RECORD_PAGE`。 将其固定为 `RECORD_PAGE`,用于那些需要完整页面才能正常使用的记录(就像工作流和仪表盘那样),或者固定为 `SIDE_PANEL`,用于那些只适合作为快速面板显示的记录(就像日历事件那样)。* 此处定义的内联字段**不**需要 `objectUniversalIdentifier`——它会从父对象继承。 使用[`defineField()`](/l/zh/developers/extend/apps/data/extending-objects)为你不拥有的对象添加字段。* 你可以使用 `yarn twenty dev:add object` 脚手架创建新对象,它会引导你完成命名、字段和关系。 参见 [Architecture → Scaffolding entities](/l/zh/developers/extend/apps/getting-started/scaffolding)。@@ -138,4 +139,4 @@ export default defineObject({* **将此对象与其他对象关联**——关于双向关系模式,参见 [Relations](/l/zh/developers/extend/apps/data/relations)。* **为其他应用的对象添加字段**——关于 `defineField()`,参见 [Extending Objects](/l/zh/developers/extend/apps/data/extending-objects)。-* **在 UI 中展示此对象**——参见 [Views](/l/zh/developers/extend/apps/layout/views) 和 [Navigation Menu Items](/l/zh/developers/extend/apps/layout/navigation-menu-items),将其放入侧边栏。+* **在界面中显示此对象** — 请参阅 [导航菜单项](/l/zh/developers/extend/apps/layout/navigation-menu-items) 以添加侧边栏条目;请参阅 [视图](/l/zh/developers/extend/apps/layout/views) 以添加自定义列表配置。diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/data/system-fields.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/data/system-fields.mdxindex 2e21977e9ad..bfd77b20e2b 100644--- a/packages/twenty-docs/l/zh/developers/extend/apps/data/system-fields.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/apps/data/system-fields.mdx@@ -142,23 +142,26 @@ const attachmentTargetRocketFieldId =`getSystemViewUniversalIdentifier` 和 `getSystemViewFieldUniversalIdentifier` 可在 `twenty-sdk` 2.26 及更高版本中使用,并且需要 Twenty 服务器版本为 2.26 或更高。</Note>-服务器还会在每个对象上预配置一个**系统视图**:主列表视图(`All {objectLabelPlural}`,以 `ViewKey.INDEX` 作为键),其中每个可显示字段对应一列。 与系统关联字段类似,它们的标识符是以**与名称无关**的方式派生的,因此重命名对象或字段都不会改变这些标识符。+服务器还会在每个对象上预配置一个**系统视图**:主列表视图(`All {objectLabelPlural}`,以 `ViewKey.INDEX`(由 `SYSTEM_VIEW_KEYS.INDEX` 派生)作为键),其中每个可显示字段对应一列。 与系统关联字段类似,它们的标识符是以**与名称无关**的方式派生的,因此重命名对象或字段都不会改变这些标识符。使用 `getSystemViewUniversalIdentifier` 来解析该视图:```ts-import { getSystemViewUniversalIdentifier, ViewKey } from 'twenty-sdk/define';+import {+ getSystemViewUniversalIdentifier,+ SYSTEM_VIEW_KEYS,+} from 'twenty-sdk/define';const rocketIndexViewId = getSystemViewUniversalIdentifier({objectMetadataApplicationUniversalIdentifier: APPLICATION_UNIVERSAL_IDENTIFIER,objectUniversalIdentifier: ROCKET_OBJECT_UNIVERSAL_IDENTIFIER,- viewKey: ViewKey.INDEX,+ viewKey: SYSTEM_VIEW_KEYS.INDEX,});```* `objectMetadataApplicationUniversalIdentifier` 是拥有该**对象**的应用程序,也是视图命名空间所基于的应用。* `objectUniversalIdentifier` 是该视图所列出的对象。-* `viewKey` 是系统视图键,目前为 `ViewKey.INDEX`。+* `viewKey` 是系统视图的区分符:主列表视图使用 `SYSTEM_VIEW_KEYS.INDEX`,记录页面字段小部件视图使用 `SYSTEM_VIEW_KEYS.FIELDS_WIDGET`。 它作为派生的键;只有 `INDEX` 同时会存储在视图行中。解析得到的 id 可用于任何需要 `viewUniversalIdentifier` 的地方,例如侧边栏中的 [`NavigationMenuItemType.VIEW`](/l/zh/developers/extend/apps/layout/navigation-menu-items) 条目。 如果只是要打开某个对象的主列表,优先使用带有 `targetObjectUniversalIdentifier` 的 `NavigationMenuItemType.OBJECT`:它不需要派生。diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/getting-started/concepts.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/getting-started/concepts.mdxindex 67a890b0612..e219b50f81b 100644--- a/packages/twenty-docs/l/zh/developers/extend/apps/getting-started/concepts.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/apps/getting-started/concepts.mdx@@ -34,22 +34,23 @@ your-app/## 实体类型-| 实体 | 目的 | 文档 |-| --------- | --------------------- | ------------------------------------------------------------- |-| **应用程序** | 应用标识、默认角色、变量 | [应用配置](/l/zh/developers/extend/apps/config/application) |-| **角色** | 对象和字段的权限集 | [角色与权限](/l/zh/developers/extend/apps/config/roles) |-| **对象** | 带字段的自定义记录类型 | [对象](/l/zh/developers/extend/apps/data/objects) |-| **字段** | 从其他应用向对象添加字段 | [扩展对象](/l/zh/developers/extend/apps/data/extending-objects) |-| **关系** | 对象之间的双向链接 | [关系](/l/zh/developers/extend/apps/data/relations) |-| **逻辑函数** | 带触发器的服务端 TypeScript | [逻辑函数](/l/zh/developers/extend/apps/logic/logic-functions) |-| **技能** | 可复用的 AI 代理指令 | [技能与代理](/l/zh/developers/extend/apps/logic/skills-and-agents) |-| **代理** | 具有自定义提示词的 AI 助手 | [技能与代理](/l/zh/developers/extend/apps/logic/skills-and-agents) |-| **连接提供方** | 用于第三方 API 的 OAuth 凭证 | [连接](/l/zh/developers/extend/apps/logic/connections) |-| **视图** | 预配置的记录列表视图 | [视图](/l/zh/developers/extend/apps/layout/views) |-| **导航菜单项** | 自定义侧边栏条目 | [导航菜单项](/l/zh/developers/extend/apps/layout/navigation-menu-items) |-| **页面布局** | 记录详情页上的选项卡和小部件 | [页面布局](/l/zh/developers/extend/apps/layout/page-layouts) |-| **前端组件** | Twenty 内的沙盒化 React UI | [前端组件](/l/zh/developers/extend/apps/layout/front-components) |-| **命令菜单项** | 快速操作和 Cmd+K 条目 | [命令菜单项](/l/zh/developers/extend/apps/layout/command-menu-items) |+| 实体 | 目的 | 文档 |+| --------- | --------------------------------- | ----------------------------------------------------------------------------------------------------- |+| **应用程序** | 应用标识、默认角色、变量 | [应用配置](/l/zh/developers/extend/apps/config/application) |+| **角色** | 对象和字段的权限集 | [角色与权限](/l/zh/developers/extend/apps/config/roles) |+| **对象** | 带字段的自定义记录类型 | [对象](/l/zh/developers/extend/apps/data/objects) |+| **字段** | 从其他应用向对象添加字段 | [扩展对象](/l/zh/developers/extend/apps/data/extending-objects) |+| **关系** | 对象之间的双向链接 | [关系](/l/zh/developers/extend/apps/data/relations) |+| **逻辑函数** | 带触发器的服务端 TypeScript | [逻辑函数](/l/zh/developers/extend/apps/logic/logic-functions) |+| **技能** | 可复用的 AI 代理指令 | [技能与代理](/l/zh/developers/extend/apps/logic/skills-and-agents) |+| **代理** | 具有自定义提示词的 AI 助手 | [技能与代理](/l/zh/developers/extend/apps/logic/skills-and-agents) |+| **连接提供方** | 用于第三方 API 的 OAuth 凭证 | [连接](/l/zh/developers/extend/apps/logic/connections) |+| **视图** | 预配置的记录列表视图 | [视图](/l/zh/developers/extend/apps/layout/views) |+| **导航菜单项** | 自定义侧边栏条目 | [导航菜单项](/l/zh/developers/extend/apps/layout/navigation-menu-items) |+| **页面布局** | 记录详情页上的选项卡和小部件 | [页面布局](/l/zh/developers/extend/apps/layout/page-layouts) |+| **前端组件** | Twenty 内的沙盒化 React UI | [前端组件](/l/zh/developers/extend/apps/layout/front-components) |+| **共享依赖项** | 由应用的前端组件共享的依赖项,在 package.json 中声明 | [共享依赖项](/l/zh/developers/extend/apps/layout/front-components#sharing-dependencies-across-front-components) |+| **命令菜单项** | 快速操作和 Cmd+K 条目 | [命令菜单项](/l/zh/developers/extend/apps/layout/command-menu-items) |## 沙盒化diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/getting-started/project-structure.mdxindex 3d3a0670605..7b718ab722b 100644--- a/packages/twenty-docs/l/zh/developers/extend/apps/getting-started/project-structure.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/apps/getting-started/project-structure.mdx@@ -76,4 +76,4 @@ my-twenty-app/把任意一个软件包放在 `dependencies` 下,都会把它拉入已安装应用的运行时 bundle 中,在那里只是累赘。 当任一软件包仍然列在 `dependencies` 下时,`twenty dev:build` 会发出警告。-像往常一样,把你的应用自身的运行时依赖项(逻辑函数在运行时实际导入的库)添加到 `dependencies` 下。+像往常一样,把你的应用自身的运行时依赖项(逻辑函数在运行时实际导入的库)添加到 `dependencies` 下。 保持依赖树精简:`dependencies` 会被安装到一个解压后上限为 250MB 的运行时层中,如果超过该依赖大小限制,同步或安装就会失败并报依赖大小错误——UI 库和开发工具应放在 `devDependencies` 中。diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/layout/front-components.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/layout/front-components.mdxindex 7ad24f61c10..ade303e202f 100644--- a/packages/twenty-docs/l/zh/developers/extend/apps/layout/front-components.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/apps/layout/front-components.mdx@@ -6,6 +6,10 @@ icon: window-maximize前端组件是直接在 Twenty 的 UI 内渲染的 React 组件。 它们在使用 Remote DOM 的**隔离 Web Worker**中运行——你的代码在沙盒化的、不透明来源的 iframe 中执行,但其 UI 仍然原生渲染在页面中,而不是被限制在该 iframe 内。+<Warning>+前台组件仍在开发中。 您的代码与部分DOM相反,而不是一个真正的浏览器页面,所以高级的使用可能失败,常常是静默。 请参阅[当前限制](#current-limitations)。+</Warning>+## 前端组件可用位置在 Twenty 中,前端组件可以在三个位置进行渲染:@@ -69,7 +73,7 @@ export default defineCommandMenuItem({| 字段 | 必填 | 描述 || --------------------- | -- | ---------------------------- |-| `universalIdentifier` | 是 | 该组件的稳定唯一 ID |+| `universalIdentifier` | 否 | 该组件的稳定唯一 ID || `component` | 是 | 一个 React 组件函数 || `name` | 否 | 显示名称 || `description` | 否 | 组件的功能描述 |@@ -516,6 +520,39 @@ export default defineFrontComponent({});```+### 存储++`localStorage` 和 `sessionStorage` 的工作方式与在普通页面中相同,使用标准的同步 API。 你的键会限定在你的应用安装和已登录用户范围内:其他应用无法读取它们,且当另一位用户在同一浏览器中登录时,将从一个空的存储开始。 写入 `localStorage` 的值在重新加载后仍会保留在设备上;`sessionStorage` 在整个浏览器会话期间有效。++```tsx src/front-components/note-draft.tsx+import { useState } from 'react';+import { defineFrontComponent } from 'twenty-sdk/define';++const NoteDraft = () => {+ const [draft, setDraft] = useState(() => localStorage.getItem('draft') ?? '');++ const handleChange = (nextDraft: string) => {+ setDraft(nextDraft);+ localStorage.setItem('draft', nextDraft);+ };++ return (+ <textarea value={draft} onChange={(event) => handleChange(event.target.value)} />+ );+};++export default defineFrontComponent({+ universalIdentifier: 'd0e1f2a3-b4c5-6789-def0-890123456789',+ name: 'note-draft',+ description: 'Keeps an unsaved note on this device',+ component: NoteDraft,+});+```++Twenty 会代表你的应用存储这些值,因此写入会立即在本地生效,并在后台保存。 读取操作永不在主机上等待。 不会进行任何同步:这些值不会随着用户切换到其他浏览器或设备而迁移,因此对于任何必须在设备更换后仍然保留的数据,请使用逻辑函数的[key-value store](/l/zh/developers/extend/apps/logic/key-value-store)。++写入都有上限,并且所有限制都按字符而不是字节计算:键最多 512 个字符,单个值最多 262,144 个字符,每个存储区在每个应用和用户下最多 1,048,576 个字符。 违反任一限制的写入会抛出一个 `QuotaExceededError`,与浏览器 API 的行为相同。+### 处理多个记录使用 `useSelectedRecordIds()` 来处理多个已选记录。 这对于批量操作很有用:@@ -597,6 +634,43 @@ export default defineFrontComponent({详情请参见[公共资源部分](/l/zh/developers/extend/apps/config/public-assets)。+## 在前端组件之间共享依赖项++默认情况下,每个前端组件都会打包自己导入的库的副本,所以如果一个应用有五个组件,就会随应用一起打包五份 React。 在应用的 `package.json` 中声明共享依赖项,只构建这些库一次,让应用的每个组件都从单个缓存文件中加载它们:++```json package.json+{+ "frontComponentSharedDependencies": ["react", "react-dom/client", "twenty-ui/input"]+}+```++之后每个组件仍然与之前完全相同地导入其依赖项——你的组件代码无需做任何更改:++```tsx src/front-components/counter.tsx+import { useState } from 'react';+import { defineFrontComponent } from 'twenty-sdk/define';++const Counter = () => {+ const [count, setCount] = useState(0);++ return <button onClick={() => setCount(count + 1)}>{count}</button>;+};++export default defineFrontComponent({+ universalIdentifier: '...',+ name: 'counter',+ component: Counter,+});+```++有几点需要了解:++* **每个应用一个共享依赖项 bundle。** 该 bundle 由应用自身的依赖项构建而成,因此你可以完全掌控要发布的版本。+* **列出你导入的精确说明符(specifier)。** `twenty-ui/input` 和 `twenty-ui/display` 是两个条目;仅有包名并不能涵盖其子路径。 列出 `react` 会自动涵盖 `react/jsx-runtime`。+* **将 `react-dom/client` 与 `react` 一起共享。** 每个组件都通过 `createRoot` 进行渲染,因此如果将其省略,每个组件仍会各自打包 React DOM。+* **bundle 会被缓存。** 它通过带有内容哈希的 URL 提供,并使用长期有效且不可变的缓存策略,因此只会被下载一次,并在应用的所有组件之间复用,直到其中某个依赖发生变化。+* **未导入任何共享包的组件永远不会下载该 bundle。**+## 样式前端组件支持多种样式方案。 你可以使用:@@ -696,3 +770,72 @@ const Card = () => {由于 `useTheme()` 是一个 hook,你需要在组件主体内部读取令牌,因此这些值始终能反映实时的主题。 同一份令牌映射也作为常量 `themeCssVariables` 导出,但在前端组件中更推荐使用 `useTheme()`——在应用清单被抽取时,解引用 `themeCssVariables` 的模块级常量可能会是 undefined。如果需要显式地根据当前配色方案做分支判断,可从 `twenty-sdk/front-component` 中使用 `useColorScheme()` 读取,它会返回 `'light'` 或 `'dark'`。++## 目前的限制++正在开发前台组件。 渲染、样式和处理活动效果良好。 任何达到*过去* 渲染(测量元素,在ref上调用DOM方法) 在你的树外端传输端口,触摸浏览器存储设备)今天不存在或不完整。 并且大部分失败:没有例外,也没有错误的 TypeScript ,因为scaffold 是与完整的浏览器 DOM键入的。++如果其中任何一项阻碍了你,[打开一个 issue](https://github.com/twentyhq/twenty/issues/new/choose),以便它能被优先处理。++### 布局和测量++没有任何东西可以衡量自己。++| API | 发生了什么 |+| ------------------------------------------------------------- | ----------------------------------------------- |+| `getBoundingClientRect()`,`getClientRects()` | 投出 |+| `offsetWidth`, `clientWidth`, `scrollWidth`, `offsetTop`, ... | 静默`未定义`, 所以`宽度 ?? 0` 当量`0` 当量时,`宽度 > 600` 时总是假的 |+| `ResizeObserver`, `IntersectionObserver` | `ReferenceError` (`typeof`警卫干工作) |+| `window.matchMedia()`, `window.getComputedStyle()` | 投出 |+| `window.innerWidth`, `innerHight`, `devicePixelRatio` | 静默`未定义` |+| `新的 MutationObserver(fn)` | 构造,然后扔出 `.observe()` |++因此,调整导航“ResponsiveContainer”、浮动界面/弹出窗口、列表虚拟化和拖动到调整大小尚不可用。 在 CSS 中选择布局:您的样式表到达了真正的页面,所以弹性框、网格、`aspect-ratio`、`clamp()`和`@container`都是正常行为。++<Note>+`requestAnimationFramework`, `fetch`, `setTimeout` 和 `queueMicrotask` 在没有窗口前缀的情况下工作。 只有`window.requestAnimationFramework(...)`和朋友投掷.+</Note>++### DOM access++一个 `ref` 给予你一个沙盒元素,而不是一个 `HTMLEment` 。++| 您写的内容 | 发生了什么 | 改用 |+| ----------------------------------------------------------------------------------------------------------- | ----------------------------- | ---------------------------------------------- |+| `ref.current.focus()`, `.click()`, `.select()`, `.setSelectionRange()`, `.scrollIntoView()`, `video.play()` | 投出 | 受控组件;从 `event.target` 读取值 |+| `element.classList.add(...)` | 抛出(`classList` 是 `undefined`) | 构建您自己的 `className` 字符串 |+| `document.getElementById()`, `getElementsByClassName()`, `createTreeWalker()` | 投出 | `querySelector()` / `querySelectorAll()`,它起作用。 |+| `document.activeElement` | 总是`未定义` | 使用 `onFocus` / `onBlur` 跟踪重点 |+| `canvas` | 渲染无任何东西,没有错误 | SVG,或者在离屏位置绘制并在 `img` 元素中显示结果 |+| `createPortal(node, document.body)` | 渲染无处不在,而`isConnected`报告成功 | 覆盖“位置:绝对位置”,或传递您自己的容器元素 |++Portal间隙是为什么Radix、Headless UI、MUI和react-selected popover默认不会渲染任何内容。 大多数人接受一个容器prop;指向一个你渲染的元素。++### 事件++鼠标、指针、触摸、拖拽、键盘、焦点,`input`/`change`/`submit`,`scroll`/`wheel`/`contextmenu` 以及 `animationend`/`transitionend` 会传递到宿主元素,另外还有一些按元素区分的事件:`load`/`error` 在 `img` 上,剪贴板和输入法合成事件在 `input`/`textarea` 上,媒体事件在 `video`/`audio` 上,`toggle` 在 `details`/`dialog` 上。 其他任何事件(`onAuxClick`、`onSelect`、`onInvalid`、`onReset`、`onAnimationStart`、指针捕获、非 `img` 上的 `onLoad`)都会在没有任何警告的情况下被丢弃。++`document.addEventListener()` 和 `window ddEventListener()`注册时没有错误,永远不发生火灾,这就是为什么当指针离开开始的元素时拖动停止。 `event.preventDefault()`也没有跨过;表单提交、`draego`/`drop`和链接点击已经是你的守卫。++### 属性和样式++每个元素都会将其自身的属性转发到宿主 DOM(`a` 上的 `href`,`img` 上的 `src`/`alt`,`input` 上的 `value`/`placeholder`/`disabled` 等),并且在每个元素上都有一组通用属性:`id`、`className`、`style`、`title`、`tabIndex`、`role`、`draggable` 以及任何 `aria-*` / `data-*` 属性(使用连字符形式,因此会丢弃 `ariaLabel`)。 外面的任何东西都被静默丢弃了,因此表达了自定义为 `data *` 。++组件的 CSS(无论来自 `import './styles.css'`、CSS-in-JS 还是 `style` 元素)都会被注入到宿主页面的 `head` 中,且是**未作用域化的(unscoped)**。 所以类名称与 Twenty 自己碰撞(前缀它们,永远不会写上`div ● v.... }`选择器'和`@media`匹配浏览器窗口而不是你的小部件 (使用 `@container` 和你自己的 `container-type`)。 内联 `style` props 不受影响。++### 存储和网络++`localStorage` 和 `sessionStorage` 由 Twenty 提供,而不是由浏览器提供:组件在一个不透明来源的 worker 中运行,因此主机会代表你的应用存储这些值。 有关它们的作用域和限制,请参见[storage](#storage)。 IndexedDB、cookies、Cache API 和 `BroadcastChannel` 仍然不可用。 要在多设备之间持久化状态,请调用[logic function](/l/zh/developers/extend/apps/logic/logic-functions)并使用其[key-value store](/l/zh/developers/extend/apps/logic/key-value-store)。++`fetch` 工作, 附有警告:++* 调用20API和您的应用路由由主机代理,所以偏好[`RestApiClient`](#calling-the-twenty-rest-api)。 在代理来电时,`AbortSignal` 和另一个 `RequestInit` 选项被丢弃,只支持 `string` 和 `URLSearchParams`。+* 其它来源将沙盒留给`原始:null`,所以第三方API只有在发送`Access-Control-Allow-ource:*`时才能解答。 从逻辑函数调用它。+* `fetch('/rest/people)`永远不匹配20个API,因为沙盒没有页面URL解决相对路径。++### 其他差距++* **文件内容。** 类型为 `file` 的 `input` 只会向你的处理函数提供文件的元数据,而不是字节本身,因此目前还无法使用 `FileReader` 和上传功能。+* **拖放payloads.** 拖动事件触发,但`event.dataTransfer` 是未定义的。+* **Node 内置。** `fs`、`path` 和 `node:crypto` 失败,所以将其移动到一个[逻辑函数](/l/zh/developers/extend/apps/logic/logic-functions)。 Web Crypto, `fetch`, `TextEncoder` 和 `URL` 都是可用的。+* **`iframe`** 始终会在没有 `allow-same-origin` 的情况下重新沙箱化,因此依赖其自身会话的嵌入内容会呈现为未登录状态。 它也没有`onLoad`文件。diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/layout/navigation-menu-items.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/layout/navigation-menu-items.mdxindex 82bff27864c..398f4df4c79 100644--- a/packages/twenty-docs/l/zh/developers/extend/apps/layout/navigation-menu-items.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/apps/layout/navigation-menu-items.mdx@@ -42,5 +42,5 @@ export default defineNavigationMenuItem({* `folderUniversalIdentifier` 也可用于任意条目,将其嵌套到一个 `FOLDER` 类型的父级中。<Note>-**常见陷阱:** 创建一个没有关联视图和导航菜单项的对象会使该对象对用户不可见。 除非是技术性/内部对象,否则每个自定义对象都应具有默认视图,*并且* 侧边栏中要有一个指向它的条目。+**常见陷阱:** 创建一个没有关联导航菜单项的对象会使该对象无法从侧边栏访问。 除非是技术性/内部对象,否则每个自定义对象都应在侧边栏中有一个指向它的条目。</Note>diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/layout/overview.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/layout/overview.mdxindex 048593a04e4..ccc580c0f57 100644--- a/packages/twenty-docs/l/zh/developers/extend/apps/layout/overview.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/apps/layout/overview.mdx@@ -55,3 +55,5 @@ Twenty 应用的**布局层**是用户看到的一切:应用在侧边栏中的| **命令菜单(Cmd+K)** | 固定的快速操作或隐藏命令 | `defineCommandMenuItem` |前端组件在使用 Remote DOM 的隔离 Web Worker 内运行——它们在页面中*原生*渲染(而不是在 iframe 中),但无法直接访问宿主页面或 DOM。 与 Twenty 的通信通过消息传递的宿主 API 完成。++它们仍在积极开发中:沙盒仅实现了部分 DOM,因此高级用法可能会失败。 请参阅[当前限制](/l/zh/developers/extend/apps/layout/front-components#current-limitations)。diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/layout/page-layouts.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/layout/page-layouts.mdxindex c409f2fff34..defebe6cb3a 100644--- a/packages/twenty-docs/l/zh/developers/extend/apps/layout/page-layouts.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/apps/layout/page-layouts.mdx@@ -53,10 +53,33 @@ export default definePageLayout({* `type` 为 `'RECORD_INDEX'`、`'RECORD_PAGE'`、`'DASHBOARD'` 或 `'STANDALONE_PAGE'` 之一。 使用 `'RECORD_PAGE'` 来自定义特定对象的详情视图。* `objectUniversalIdentifier` 指定此布局适用于哪个对象。-* 每个 `tab` 使用 `title`、`position` 和 `layoutMode` 定义页面的一个部分(记录页面使用 `VERTICAL_LIST`,仪表板使用 `GRID`)。 包含单个小部件的选项卡会自动将其渲染为全宽显示;包含多个小部件时,它们会堆叠为卡片。+* 每个 `tab` 使用 `title`、`position` 和 `layoutMode` 定义页面的一个部分:记录页面和独立页面使用 `VERTICAL_LIST`,仪表板使用 `GRID`。 在 `VERTICAL_LIST` 选项卡中,单个小部件会以全宽方式渲染并占据整个选项卡;如果有多个小部件,它们会堆叠显示为卡片。 `GRID` 选项卡始终在 12 列网格上将其小部件布局为卡片,无论小部件数量多少都是如此,因此当你希望单个小部件填满页面时,请选择 `VERTICAL_LIST`。+* 请显式设置 `layoutMode`。 如果省略它,在 `STANDALONE_PAGE` 上会得到 `VERTICAL_LIST`,在其他地方会得到 `GRID`,而这在记录页面上通常不是你想要的效果。* 选项卡内的每个 `widget` 可以渲染一个[前端组件](/l/zh/developers/extend/apps/layout/front-components)、关系列表或其他内置小部件类型。* 选项卡上的 `position` 控制其顺序。 使用更高的值(例如 50)可将自定义选项卡放在内置选项卡之后。+### 字段小部件++`FIELD` 小部件会渲染记录中的一个字段。 对于关系字段,它还可以嵌入相关记录的列表:++```ts+{+ universalIdentifier: 'c1c2c3c4-c5c6-4000-8000-000000000003',+ title: 'People → Opportunities',+ type: 'FIELD',+ configuration: {+ configurationType: 'FIELD',+ fieldMetadataId: PEOPLE_FIELD_UNIVERSAL_IDENTIFIER,+ fieldDisplayMode: 'TABLE',+ nestedRelationFieldMetadataId: OPPORTUNITIES_FIELD_UNIVERSAL_IDENTIFIER,+ },+}+```++* `fieldMetadataId` 接收布局对象上某个字段的全局标识符。+* `fieldDisplayMode` 的取值之一为 `'FIELD'`、`'CARD'`、`'EDITOR'`、`'VIEW'` 或 `'TABLE'`。 `TABLE` 会嵌入一个视图,用于列出一对多关系字段中的记录。+* `nestedRelationFieldMetadataId` 是可选的,并接收关系目标对象上一个一对多关系字段的通用标识符,用于列出跨两个关系跳数的记录(例如,在 Company 页面中列出该公司人员的机会,或在 Person 页面中列出该人员所在公司的机会)。 第一跳可以是一对多或多对一的关系字段,第二跳必须是一对多(不支持连接关系),并且需要 `fieldDisplayMode: 'TABLE'` — 将其与任何其他显示模式组合都会导致验证错误,因为嵌套小部件始终呈现为嵌入视图。+## definePageLayoutTab当你只想在现有布局中**添加**一个选项卡时使用此方式——例如,在标准 Company 页面上添加一个分析选项卡,或者在你自己的对象布局上附加一个 AI 摘要选项卡。diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/layout/views.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/layout/views.mdxindex 91d13aff097..0d1085132d2 100644--- a/packages/twenty-docs/l/zh/developers/extend/apps/layout/views.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/apps/layout/views.mdx@@ -41,16 +41,16 @@ export default defineView({## 可选属性-| 属性 | 值 | 描述 |-| ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |-| `type` | `ViewType.TABLE`(默认),`ViewType.KANBAN`,`ViewType.CALENDAR` | 记录的排布方式。 (`FIELDS_WIDGET`、`TABLE_WIDGET`、`KANBAN_WIDGET` 和 `CALENDAR_WIDGET` 也存在,但由页面布局小部件在内部使用。) |-| `visibility` | `ViewVisibility.WORKSPACE`(默认),`ViewVisibility.UNLISTED` | 视图是对整个工作区可见,还是在选择器中隐藏。 |-| `openRecordIn` | `ViewOpenRecordIn.SIDE_PANEL`(默认),`ViewOpenRecordIn.RECORD_PAGE` | 点击记录时在何处打开该记录。 |-| `排序` | `{ fieldMetadataUniversalIdentifier, direction: ViewSortDirection.ASC \| DESC }[]` | 默认排序顺序。 |-| `isCompact` | `boolean` | 紧凑的行显示。 |-| `mainGroupByFieldMetadataUniversalIdentifier` + `shouldHideEmptyGroups` | — | 按字段对记录进行分组(例如看板列)。 |-| `kanbanAggregateOperation`, `kanbanAggregateOperationFieldMetadataUniversalIdentifier`, `kanbanColumnWidth` | `AggregateOperations.*` | 看板列聚合和列宽设置。 |-| `calendarLayout`, `calendarFieldMetadataUniversalIdentifier`, `calendarEndFieldMetadataUniversalIdentifier` | `ViewCalendarLayout.DAY` / `WEEK` / `MONTH` | 日历视图:布局、用于定位记录的日期字段,以及可选的结束日期字段。 |+| 属性 | 值 | 描述 |+| ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |+| `type` | `ViewType.TABLE`(默认),`ViewType.LIST`,`ViewType.KANBAN`,`ViewType.CALENDAR` | 记录的排布方式。 (`FIELDS_WIDGET`、`TABLE_WIDGET`、`KANBAN_WIDGET`、`LIST_WIDGET` 和 `CALENDAR_WIDGET` 也存在,但由页面布局小部件在内部使用。) |+| `visibility` | `ViewVisibility.WORKSPACE`(默认),`ViewVisibility.UNLISTED` | 视图是对整个工作区可见,还是在选择器中隐藏。 |+| `openRecordIn` | 已弃用 | 不再读取:记录的打开位置现在是[对象](/l/zh/developers/extend/apps/data/objects)的一个属性(`defineObject()` 上的 `openRecordIn`),如果未设置该属性,则回退到每个成员自己的偏好设置。 |+| `排序` | `{ fieldMetadataUniversalIdentifier, direction: ViewSortDirection.ASC \| DESC }[]` | 默认排序顺序。 |+| `isCompact` | `boolean` | 紧凑的行显示。 |+| `mainGroupByFieldMetadataUniversalIdentifier` + `shouldHideEmptyGroups` | — | 按字段对记录进行分组(例如看板列)。 |+| `kanbanAggregateOperation`, `kanbanAggregateOperationFieldMetadataUniversalIdentifier`, `kanbanColumnWidth` | `AggregateOperations.*` | 看板列聚合和列宽设置。 |+| `calendarLayout`, `calendarFieldMetadataUniversalIdentifier`, `calendarEndFieldMetadataUniversalIdentifier` | `ViewCalendarLayout.DAY` / `WEEK` / `MONTH` | 日历视图:布局、用于定位记录的日期字段,以及可选的结束日期字段。 |上述所有枚举都从 `twenty-sdk/define` 导出。@@ -110,4 +110,4 @@ filters: [## 视图在 UI 中如何显示-单独一个视图无法从侧边栏访问。 要让它显示在侧边栏中,请将其与类型为 `VIEW`、指向该视图 `universalIdentifier` 的[导航菜单项](/l/zh/developers/extend/apps/layout/navigation-menu-items)配对。 这是规范用法:每个自定义对象通常都会提供一个默认视图,以及一个在侧边栏中打开该视图的条目。+单独一个视图无法从侧边栏访问。 要让它显示在侧边栏中,请将其与类型为 `VIEW`、指向该视图 `universalIdentifier` 的[导航菜单项](/l/zh/developers/extend/apps/layout/navigation-menu-items)配对。 这是规范做法:每个自定义对象在创建时都会自动生成一个默认的列表视图,因此你只需提供用于打开它的侧边栏条目。diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/logic/background-jobs.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/logic/background-jobs.mdxnew file mode 100644index 00000000000..1565893eaca--- /dev/null+++ b/packages/twenty-docs/l/zh/developers/extend/apps/logic/background-jobs.mdx@@ -0,0 +1,165 @@+---+title: 后台作业+description: 通过将另一次逻辑函数运行入队,而不是在当前执行中完成所有工作,把耗时较长或受速率限制的工作交给 Twenty 工作进程处理。+icon: layer-group+---++一次逻辑函数运行会受到其 `timeoutSeconds`(最大 900 秒)的限制。 任何无法在该时间窗口内完成的工作——例如完整的重新同步、逐记录的扇出、对你进行速率限制的第三方 API——都必须拆分为更小的运行。++`enqueueJob` 正是用于此:它会请求 Twenty 工作进程稍后在其自己的进程中运行你应用中的某个逻辑函数,并使用其独立的超时预算。 调用方会立即返回。++```text+ ┌─────────────────┐ enqueueJob(...) ┌──────────────┐ ┌────────────────────┐+ │ Logic function │ ─────────────────▶ │ Job queue │──▶│ Logic function │+ │ (returns now) │ │ (workers) │ │ (fresh run/timeout)│+ └─────────────────┘ └──────────────┘ └────────────────────┘+```++## 将一次运行加入队列++从 `twenty-sdk/logic-function` 导入 `enqueueJob`,并将其指向你想要运行的逻辑函数的 `universalIdentifier`。++```ts src/logic-functions/sync-all-contacts.ts+import { enqueueJob } from 'twenty-sdk/logic-function';++await enqueueJob({+ logicFunctionUniversalIdentifier: '9f1c3d7e-51b8-4a29-8f0d-7c4e2a6b1d33',+ payload: { page: 1 },+});+```++目标函数会像其他任何触发器一样,将 `payload` 作为其处理程序参数接收。 它必须属于与调用方**相同的应用程序**——将其他应用的函数入队会被拒绝,并返回 `Logic function not found`。++<Note>+`enqueueJob` 在作业被接受后立即返回,而不是在它运行完成后返回。 它不会返回目标的结果——如果你需要再次读取结果,让目标将其输出写入[key-value store](/l/zh/developers/extend/apps/logic/key-value-store)或工作区记录。+</Note>++## 作业选项++| 选项 | 默认 | 范围 | 作用 |+| ------------ | --- | -------------------- | ------------------------------------- |+| `retryLimit` | `0` | `0`–`10` | 如果运行抛出异常,进行额外重试。 仅对可以安全运行两次的处理程序提高该值。 |+| `delayMs` | `0` | `0`–`604800000`(7 天) | 在运行符合条件之前等待这么长时间。 |++```ts+await enqueueJob({+ logicFunctionUniversalIdentifier: '9f1c3d7e-51b8-4a29-8f0d-7c4e2a6b1d33',+ payload: { page: 1 },+ retryLimit: 3,+ delayMs: 60_000,+});+```++<Note>+**优先级尚不可配置。** 入队的作业始终以最低优先级运行,因此平台工作永远不会被应用程序作业延迟。 对优先级的控制即将推出。+</Note>++排队的运行会继承将其入队的函数的当前用户,因此会以相同的权限执行。++## 用法:分页处理一次长时间同步++典型模式是函数使用下一个游标将*自身*入队。 每次运行都在自己的超时时间内完成一页工作,当没有剩余内容时链条就会停止。++```ts src/logic-functions/sync-contacts-page.ts+import { defineLogicFunction } from 'twenty-sdk/define';+import { enqueueJob } from 'twenty-sdk/logic-function';++const SYNC_CONTACTS_PAGE = '9f1c3d7e-51b8-4a29-8f0d-7c4e2a6b1d33';++const handler = async (params: { cursor?: string }) => {+ const { contacts, nextCursor } = await fetchContactsPage(params.cursor);++ await importContacts(contacts);++ if (nextCursor) {+ await enqueueJob({+ logicFunctionUniversalIdentifier: SYNC_CONTACTS_PAGE,+ payload: { cursor: nextCursor },+ delayMs: 2_000,+ });+ }++ return { imported: contacts.length, done: !nextCursor };+};++export default defineLogicFunction({+ universalIdentifier: SYNC_CONTACTS_PAGE,+ name: 'sync-contacts-page',+ timeoutSeconds: 120,+ handler,+});+```++## 按记录扇出(fan-out)++当工作天然按条目划分时,为每个条目入队一个作业,并让工作进程并行处理它们,而不是在内联循环中处理。++```ts+const companies = await listCompaniesToEnrich();++await Promise.all(+ companies.map((company) =>+ enqueueJob({+ logicFunctionUniversalIdentifier: ENRICH_COMPANY,+ payload: { companyId: company.id },+ retryLimit: 2,+ }),+ ),+);+```++## 长时间运行工作的最佳实践++两条规则涵盖几乎所有长作业:**用递归代替循环**,以及**每次运行处理一块有界的数据块(chunk)**。++试图一次完成所有事情的运行就是失败模式——它会触发超时,并在重试时从头开始重新执行整个过程。 相反,应调整单个数据块的大小,使其能够从容地在 `timeoutSeconds` 内完成,持久化当前位置,然后入队下一次运行。++```ts src/logic-functions/enrich-companies-batch.ts+import { defineLogicFunction } from 'twenty-sdk/define';+import { enqueueJob, kv } from 'twenty-sdk/logic-function';++const ENRICH_COMPANIES_BATCH = '3f9d1c02-8a44-4f0e-b1d7-9c2e5a7b4f10';+const CHUNK_SIZE = 50;++const handler = async (params: { offset?: number }) => {+ const offset = params.offset ?? 0;+ const companies = await listCompaniesToEnrich({+ offset,+ limit: CHUNK_SIZE,+ });++ for (const company of companies) {+ await enrichCompany(company);+ }++ await kv.set('enrich:progress', { offset: offset + companies.length });++ if (companies.length === CHUNK_SIZE) {+ await enqueueJob({+ logicFunctionUniversalIdentifier: ENRICH_COMPANIES_BATCH,+ payload: { offset: offset + CHUNK_SIZE },+ });+ }++ return { processed: companies.length, done: companies.length < CHUNK_SIZE };+};++export default defineLogicFunction({+ universalIdentifier: ENRICH_COMPANIES_BATCH,+ name: 'enrich-companies-batch',+ timeoutSeconds: 300,+ handler,+});+```++支撑这一模式的要点:++* **以最慢的条目而不是平均值来确定块大小。** `CHUNK_SIZE × worst-case item time` 必须在留有余量的情况下适配到 `timeoutSeconds` 中,否则在运行被切断时,一个数据块的尾部会丢失。+* **让终止条件显式化。** 仅在返回的是完整数据块时继续递归。 仅在“无结果”时停止的链,如果源在中途返回一个较短的分页,将会永远继续下去。+* **在入队下一次运行之前持久化进度,** 这样失败的链路会从上一个完成的数据块而不是从头开始重新启动。+* **保持每个数据块幂等。** 在重试后重新处理一个数据块时,不能产生重复写入——应基于你处理的记录或外部 id 进行关键写入。+* **在工作会访问受限频率的第三方服务时,优先使用分块链而不是一次巨大的 fan-out。** 使用 `delayMs` 的链会自我节奏控制,而一次性入队的数千个作业会立即全部变为可运行状态。++<Warning>+重试会重新运行整个处理程序。 在将 `retryLimit` 设为大于 `0` 之前,保持入队的处理程序幂等。+</Warning>diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/logic/connections.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/logic/connections.mdxindex 6460d787f24..5745b3ce24c 100644--- a/packages/twenty-docs/l/zh/developers/extend/apps/logic/connections.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/apps/logic/connections.mdx@@ -45,6 +45,9 @@ export default defineConnectionProvider({// Optional: a logic function in this app to run right after a connection is// established. See "Run a logic function on connect".// onConnectLogicFunction: { universalIdentifier: '3a2b1c0d-...-...' },+ // Optional: a logic function in this app to run right after a connection is+ // removed. See "Run a logic function on disconnect".+ // onDisconnectLogicFunction: { universalIdentifier: '4d5e6f70-...-...' },});```@@ -124,6 +127,42 @@ type OnConnectPayload = {</Accordion>+<Accordion title="在断开连接时运行逻辑函数" description="在移除连接时进行清理">++应用在连接时声明的任何内容,都必须在连接断开时被释放。 例如,一个在连接时声明了 `team_id` 的 Slack 集成,必须在连接结束时释放该声明,以便其他工作区可以连接同一个 Slack 团队。 将 `onDisconnectLogicFunction` 设置为引用同一应用中的某个逻辑函数,该函数会在删除 `ConnectedAccount` 之后立即运行。++```ts src/connection-providers/slack-connection.ts+export default defineConnectionProvider({+ universalIdentifier: '...',+ name: 'slack',+ displayName: 'Slack',+ type: 'oauth',+ oauth: {+ /* ... */+ },+ // Runs releaseSlackTeam after every Slack disconnection.+ onDisconnectLogicFunction: {+ universalIdentifier: '4470aba8-5ff5-4800-88db-2a427cd8677c',+ },+});+```++与 on-connect 钩子类似,它在**正在断开连接的工作区中以异步方式运行**,并且不会阻塞断开过程。 处理程序接收的负载结构相同:++```ts+type OnDisconnectPayload = {+ connectionProviderId: string;+ connectionProviderName: string; // e.g. 'slack'+ connectedAccountId: string;+};+```++当钩子运行时,`ConnectedAccount` 已经不存在了,因此 `getConnection(connectedAccountId)` 将不再返回结果。 清理所需的任何内容(例如 `team_id`、外部订阅 ID)必须在连接时写入到按 `connectedAccountId` 作为键的[key-value store](/l/zh/developers/extend/apps/logic/key-value-store) 中。++当连接自身被移除时,该钩子会被触发。 卸载应用会通过数据库级联来删除其连接,因此该钩子在这种情况下不会运行。 在 `defineApplication` 上声明一个 `uninstallLogicFunction` 用于该路径:它在应用的元数据被删除之前运行,因此仍然可以调用 `listConnections` 并清理剩余的内容。++</Accordion>+<Accordion title="listConnections / getConnection" description="在逻辑函数中使用连接">在逻辑函数处理器内,`listConnections({ providerName })` 会返回此应用针对给定提供方的 `ConnectedAccount` 行,并附带已刷新的访问令牌。diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/logic/logic-functions.mdxindex f66244bee91..bad5308b2ad 100644--- a/packages/twenty-docs/l/zh/developers/extend/apps/logic/logic-functions.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/apps/logic/logic-functions.mdx@@ -172,6 +172,10 @@ const handler = async (event: RoutePayload) => {状态码必须是有效的 HTTP 状态码(介于 100 和 599 之间)。 响应头名称的匹配不区分大小写。</Note>+#### 平台错误响应++除了处理程序自身的响应之外,在某些情况下,平台会直接对路由调用做出响应:当路由或函数不存在时返回 `404`,当应用停止时返回 `403`,当触发执行速率限制时返回 `429`,以及当应用的生产环境 `dependencies` 过大而无法安装时返回 `422`——请参见[依赖项大小限制](/l/zh/developers/extend/apps/getting-started/project-structure#dependencies)。+#### 服务端路由触发器`httpRouteTriggerSettings` 在 `/s/` 下暴露一个函数,并根据请求主机解析 workspace——这在每个 workspace 都有自己域名时有效。 然而,第三方服务商会将每个租户的事件发送到**同一个** URL。 在这种情况下,请使用 `serverRouteTriggerSettings`。diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/logic/overview.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/logic/overview.mdxindex ce779aaa681..0eededa0f59 100644--- a/packages/twenty-docs/l/zh/developers/extend/apps/logic/overview.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/apps/logic/overview.mdx@@ -37,6 +37,9 @@ Twenty 应用的 **逻辑层** 是实际*运行*的代码——用于响应 HTTP<Card title="键值存储" icon="database" href="/l/zh/developers/extend/apps/logic/key-value-store">在逻辑函数的多次运行之间持久化状态——缓存、游标和跨工作区声明。</Card>+ <Card title="后台作业" icon="layer-group" href="/l/zh/developers/extend/apps/logic/background-jobs">+ 将逻辑函数排入队列,由工作进程运行,以避开单次运行超时限制。+ </Card></CardGroup>## 触发器类型一览diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/logic/skills-and-agents.mdxindex fd02916ac50..c97ccdb5acd 100644--- a/packages/twenty-docs/l/zh/developers/extend/apps/logic/skills-and-agents.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/apps/logic/skills-and-agents.mdx@@ -100,7 +100,7 @@ export default defineAgent({</Accordion><Accordion title="runAgent" description="从逻辑函数中运行代理">-`runAgent()` 允许逻辑函数运行你的应用的某个代理(及其技能和工具)。 通过你传递给 `defineAgent()` 的 `universalIdentifier` 来标识该代理:+`runAgent()` 允许逻辑函数运行你的应用的某个代理(及其技能和工具)。 通过你传递给 `defineAgent()` 的 `universalIdentifier` 来标识该代理。 只传入 `prompt` 字符串或 `messages` 会话历史其中之一,不要同时传入两者:```ts src/logic-functions/run-enricher.tsimport { runAgent } from 'twenty-sdk/logic-function';@@ -111,7 +111,23 @@ const { result, error, success } = await runAgent({});```+对于多轮对话机器人(Slack、Discord、Teams 等),将线程历史作为 `messages` 传入,而不是单个 `prompt`:++```ts src/logic-functions/reply-in-thread.ts+import { runAgent } from 'twenty-sdk/logic-function';++const { result, error, success } = await runAgent({+ agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123',+ messages: [+ { role: 'user', content: 'Who owns Acme?' },+ { role: 'assistant', content: 'Sarah owns the Acme account.' },+ { role: 'user', content: 'What was the last touchpoint?' },+ ],+});+```+关键点:+* 提供 `prompt`(字符串)或 `messages`(1 到 100 个 `{ role: 'user' | 'assistant', content: string }` 条目)中的 **恰好一个**。* 代理以**同步**方式运行,并且可以通过其自身的工具读取/更新记录 —— `runAgent()` 会在运行完成后才 resolve。* 一个应用只能运行它自己的代理。* 应用的[默认角色](/l/zh/developers/extend/apps/config/roles)必须授予 `AI` 权限标记 —— 在其 `permissionFlagUniversalIdentifiers` 中添加 `SystemPermissionFlag.AI`(或设置 `canAccessAllTools: true`)。@@ -134,5 +150,30 @@ export default defineApplicationRole({\*\*避免循环:\*\*如果你从 `*.updated` 数据库事件触发器中调用 `runAgent()`,而代理又会更新同一条记录,请将触发器的 `updatedFields` 限定为代理永远不会写入的字段(例如来源 URL),或者在调用 `runAgent()` 之前检查任何目标字段是否仍为空。</Warning>+### 以工作区成员身份运行++当运行是由某个用户触发时(例如,一个聊天机器人在回复消息),传入 `runAsWorkspaceMemberId`,这样智能体就会以该成员的身份而不是以应用自身的身份执行:++```ts src/logic-functions/answer-question.ts+const { result } = await runAgent({+ agentUniversalIdentifier: 'b3c4d5e6-f7a8-9012-bcde-f34567890123',+ prompt: 'How many open opportunities do we have?',+ runAsWorkspaceMemberId: '20202020-0687-4c41-b707-ed1bfca972a7',+});+```++然后,此运行将以**成员自身的角色**执行:它可以执行该成员能够执行的所有操作且仅限于此,它创建的记录将归属于该成员,并且会应用该成员的行级权限。 智能体的角色不会参与——它是针对没有任何成员在背后参与的运行所使用的应用默认角色。 对于自主运行(计划任务、数据库事件触发器),省略该字段:这类运行会保持智能体自身的角色。 为保持来源追溯,执行操作的应用会附着在该运行的上下文中,但不会收窄该成员的权限。++你的应用负责将触发运行的用户映射到一个工作区成员。 要为某个成员命名,需要一个应用访问令牌,而令牌可以为谁命名,取决于它是否携带用户:++* **未绑定任何用户** 的令牌可以为任意成员命名。 逻辑函数使用这类令牌运行,通过 `client_credentials` 或由 API 密钥签发的令牌也属于此类。+* **代表某个用户签发的令牌**(例如前端组件接收到的令牌),只能为该用户自己的成员命名。++除此之外的任何情况——普通用户会话、没有应用访问令牌的 API 密钥——都不能为任何成员命名。++<Warning>+ 当工作区成员无法解析时——例如未知或已移除的成员,或者没有角色的成员——`runAgent()` 会抛出异常。 它绝不会回退到代理自身的角色,因为那样会授予比调用方请求更多的访问权限。+</Warning>+</Accordion></AccordionGroup>diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/operations/publishing.mdxindex c17f3b3269a..535309c122f 100644--- a/packages/twenty-docs/l/zh/developers/extend/apps/operations/publishing.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/apps/operations/publishing.mdx@@ -49,11 +49,7 @@ yarn twenty app:publish --private### 共享已部署的应用-<Warning>-在多个工作区之间共享私有(tarball)应用是一项 **Enterprise** 功能。 在您的工作区拥有有效的 Enterprise 密钥之前,**Distribution** 选项卡将显示升级提示,而不是共享控件。 请前往 [设置 > 管理面板 > Enterprise](/settings/admin-panel#enterprise) 以启用。-</Warning>--通过 tar 包分发的应用不会出现在公共市场中,因此同一服务器上的其他工作区无法通过浏览发现它们。 一旦您的工作区升级到企业版计划,您就可以像这样分享已部署的应用:+通过 tar 包分发的应用不会出现在公共市场中,因此同一服务器上的其他工作区无法通过浏览发现它们。 要共享已部署的应用:1. 前往 **Settings > Applications > Registrations** 并打开你的应用2. 在 **Distribution** 选项卡中,点击 **Copy share link**diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/operations/sync-and-recovery.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/operations/sync-and-recovery.mdxindex 99463dbc123..575517a8080 100644--- a/packages/twenty-docs/l/zh/developers/extend/apps/operations/sync-and-recovery.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/apps/operations/sync-and-recovery.mdx@@ -121,5 +121,6 @@ Plan: 1 to add, 1 to change, 0 to destroy.* **Manifest 构建错误**——CLI 在同步前失败(`MANIFEST_BUILD_FAILED`、`TYPECHECK_FAILED`);请修复你的应用源代码。* **同步 / 迁移错误**——构建成功,但在应用 diff 时失败,并给出实体名称和 `universalIdentifier`;请修复冲突的元数据。+* **依赖项大小错误** — 同步或安装失败,是因为应用的生产环境 `dependencies` 过大,无法作为运行时层进行安装(`LOGIC_FUNCTION_DEPENDENCIES_SIZE_EXCEEDED`);请将逻辑函数在运行时不导入的包(UI 库、开发工具等)移动到 `devDependencies`。* **应用代码运行时错误** — 同步成功,但你的逻辑函数或组件在运行时行为异常;请检查[函数日志](/l/zh/developers/extend/apps/operations/cli)。* **本地实例状态** — 不属于以上任何一种情况,但工作区仍然显示异常;请按照恢复步骤逐级排查。diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/operations/testing.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/operations/testing.mdxindex 79154ed71df..6877f2414b8 100644--- a/packages/twenty-docs/l/zh/developers/extend/apps/operations/testing.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/apps/operations/testing.mdx@@ -8,7 +8,7 @@ icon: flask## 使用 npm 包-可以在应用中安装并使用任意 npm 包。 逻辑函数和前端组件都通过 [esbuild](https://esbuild.github.io/) 打包,所有依赖都会被内联到输出中——运行时不需要 `node_modules`。+可以在应用中安装并使用任意 npm 包。 逻辑函数和前端组件都通过 [esbuild](https://esbuild.github.io/) 打包,其依赖会被内联到输出中——运行时不需要 `node_modules`。### 安装包@@ -56,14 +56,16 @@ export default defineFrontComponent({### 打包的工作原理-构建步骤使用 esbuild 为每个逻辑函数和每个前端组件生成一个自包含文件。 所有导入的包都会被内联到打包产物中。+构建步骤使用 esbuild 为每个逻辑函数和每个前端组件生成一个自包含文件。 导入的包会被内联到打包文件中,下面列出的除外。**逻辑函数** 运行在 Node.js 环境中。 Node 内置模块(`fs`、`path`、`crypto`、`http` 等) 可用且无需安装。-**前端组件** 运行在 Web Worker 中。 Node 内置模块不可用——仅可使用浏览器 API 以及可在浏览器环境中运行的 npm 包。+**前端组件** 运行在 Web Worker 中。 Node 内置模块不可用——仅可使用可在浏览器环境中运行的 npm 包。 请注意,沙盒实现了*部分* DOM,因此一个包在构建时可能一切正常,但在运行时仍可能失败;参见[当前限制](/l/zh/developers/extend/apps/layout/front-components#current-limitations)。两个环境都将 `twenty-client-sdk/core` 和 `twenty-client-sdk/metadata` 作为预置模块提供 — 这些模块不会被打包,而是在运行时由服务器解析。+前端组件也可以通过[共享依赖包](/l/zh/developers/extend/apps/layout/front-components#sharing-dependencies-across-front-components)来共享依赖。 列在应用 package.json 的 `frontComponentSharedDependencies` 字段中的包会被构建到一个单独的文件中,并在运行时从该文件加载,而不是被内联到每个组件中,因此只导入共享包的组件几乎不包含任何自身的依赖代码。+## 设置脚手架生成的应用已包含 Vitest。 如果你手动进行设置,请安装这些依赖:diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/translations/overview.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/translations/overview.mdxindex 0f1c4660e8a..f3d3947370a 100644--- a/packages/twenty-docs/l/zh/developers/extend/apps/translations/overview.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/apps/translations/overview.mdx@@ -52,7 +52,7 @@ const Card = ({ count, name }: { count: number; name: string }) => {### 何时使用哪一种-* **`<Trans>…</Trans>`** —— JSX 中的静态文本。 使用 `message` 和 `values` 属性进行插值(`<Trans message="Hi {name}" values={{ name }} />`);直接在子节点中插值无法被静态提取。+* **`Trans`** —— JSX 中的静态文本。 使用 `message` 和 `values` 属性进行插值,如 `Trans message="Hi {name}" values={{ name }}`;直接在子节点中插值无法被静态提取。* **`useTranslate().t`** —— 组件内部的动态字符串。 当用户切换语言时会重新渲染。 在渲染逻辑中优先使用这个。* **`t(...)`**(直接导入)—— 可在**任何地方**使用的即时翻译,包括事件处理函数、辅助函数和模块作用域——不仅仅在渲染逻辑中。* **`msg(...)`** —— 以数据形式(常量、配置)声明字符串的惰性描述符。 在之后通过 `t(descriptor)` 来解析它。@@ -76,7 +76,7 @@ twenty dev:translations-extract # collect strings into locales/twenty dev:translations-extract --locale fr-FR # also scaffold a target locale```-提取会收集你的 manifest 标签以及前端组件源码中的 `t()`/`msg()`/`\<Trans>` 字符串,并将它们放入 `locales/\<locale>.json` 中,以源字符串作为键。 填写翻译:+提取会收集你的 manifest 标签以及前端组件源码中的 `t()`/`msg()`/`Trans` 字符串,并将它们放入 `locales/\<locale>.json` 中,以源字符串作为键。 填写翻译:```json// locales/fr-FR.json@@ -91,7 +91,7 @@ twenty dev:translations-extract --locale fr-FR # also scaffold a target locale## 运行方式-`twenty dev:build` 会编译目录并为当前用户提供正确的语言:manifest 标签在服务端解析,前端组件目录被打包进每个组件 bundle 中。 在运行时,组件会从其执行上下文(宿主的当前语言)中读取语言环境,并将每个字符串在其目录中解析,当翻译缺失时回退到源文本。 在宿主中切换语言会实时重新渲染 `\<Trans>` 和 `useTranslate().t` 的字符串。+`twenty dev:build` 会编译目录并为当前用户提供正确的语言:manifest 标签在服务端解析,前端组件目录被打包进每个组件 bundle 中。 在运行时,组件会从其执行上下文(宿主的当前语言)中读取语言环境,并将每个字符串在其目录中解析,当翻译缺失时回退到源文本。 在宿主中切换语言会实时重新渲染 `Trans` 和 `useTranslate().t` 的字符串。由于目录在构建时被编译,更新翻译意味着需要重新运行 `twenty dev:build`(并重新部署),这和其他任何更改一样。@@ -99,4 +99,12 @@ twenty dev:translations-extract --locale fr-FR # also scaffold a target locale翻译由 `twenty dev:build`(以及 `twenty apply`)编译。 持续运行的 `twenty dev` 监视会显示源字符串,因此请使用一次性构建来测试本地化输出。</Note>-`<Trans>` 的文本子节点可以跨多行——空白会以与 JSX 相同的方式被折叠,因此 `<Trans>Welcome\n back</Trans>` 和提取出的键都会变成 `Welcome back`。+`Trans` 的文本子节点可以跨多行——空白会以与 JSX 相同的方式被折叠,因此这两种写法都会被提取为键 `Welcome back`:++```tsx+<Trans>Welcome back</Trans>+<Trans>+ Welcome+ back+</Trans>+```diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/tutorials/document-generator/building-the-ui.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/tutorials/document-generator/building-the-ui.mdxindex d4b491f687b..c048ef4b817 100644--- a/packages/twenty-docs/l/zh/developers/extend/apps/tutorials/document-generator/building-the-ui.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/apps/tutorials/document-generator/building-the-ui.mdx@@ -278,7 +278,10 @@ export default definePageLayout({投影。 生成管道读取Markdown 投影, 所以占位符, PDF, 和可共享的网页都保持正常工作状态 —查看完整的-[“模板-记录”。 年龄布局。s\`](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/examples/document-generator/src/page-layouts/template-record.page-layout.ts)。+[“模板-记录”。 年龄布局。s`](https://github.com/twentyhq/twenty/blob/main/packages/twenty-apps/examples/document-generator/src/page-layouts/template-record.page-layout.ts)。+`FIELD\` 小部件也支持其他显示模式和选项,包括+列出相隔两跳的嵌套关联记录——请参阅+[字段小部件参考](/l/zh/developers/extend/apps/layout/page-layouts#field-widgets).现在编辑器在一个合适的富文本编辑器中写入模板:<Frame caption="模板选项卡:20个本地的富文本编辑器绑定到实体字段。">diff --git a/packages/twenty-docs/l/zh/developers/extend/extend.mdx b/packages/twenty-docs/l/zh/developers/extend/extend.mdxindex c40cfa75396..ba38990713f 100644--- a/packages/twenty-docs/l/zh/developers/extend/extend.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/extend.mdx@@ -26,7 +26,7 @@ Twenty 的设计旨在实现可扩展性。 使用我们的 API、网络钩子<Card title="Webhooks" icon="bell" href="/l/zh/developers/extend/webhooks">实时接收事件通知</Card>- <Card title="应用" icon="puzzle-piece" href="/l/zh/developers/extend/apps/getting-started">+ <Card title="应用" icon="puzzle-piece" href="/l/zh/developers/extend/apps/getting-started/快速启动">以代码方式构建自定义项</Card></CardGroup>diff --git a/packages/twenty-docs/l/zh/developers/extend/oauth.mdx b/packages/twenty-docs/l/zh/developers/extend/oauth.mdxindex fbb0f817643..578eea3fbd5 100644--- a/packages/twenty-docs/l/zh/developers/extend/oauth.mdx+++ b/packages/twenty-docs/l/zh/developers/extend/oauth.mdx@@ -8,12 +8,12 @@ Twenty 对面向用户的应用采用授权码 + PKCE 实现 OAuth 2.0,对服## 何时使用 OAuth-| 场景 | 认证方式 |-| ------------------- | ----------------------------------------------------------- |-| 内部脚本、自动化 | [API 密钥](/l/zh/developers/extend/api#authentication) |-| 代表用户执行操作的外部应用 | **OAuth — 授权码** |-| 服务器到服务器,无用户上下文 | **OAuth — 客户端凭证** |-| 带有 UI 扩展的 Twenty 应用 | [应用](/l/zh/developers/extend/apps/getting-started) (OAuth 将自动处理) |+| 场景 | 认证方式 |+| ------------------- | ----------------------------------------------------------------------- |+| 内部脚本、自动化 | [API 密钥](/l/zh/developers/extend/api#authentication) |+| 代表用户执行操作的外部应用 | **OAuth — 授权码** |+| 服务器到服务器,无用户上下文 | **OAuth — 客户端凭证** |+| 带有 UI 扩展的 Twenty 应用 | [应用](/l/zh/developers/extend/apps/getting-started/quick-start) (OAuth 将自动处理) |## 注册客户端diff --git a/packages/twenty-docs/l/zh/developers/introduction.mdx b/packages/twenty-docs/l/zh/developers/introduction.mdxindex 94187bed293..3fdfc9ae109 100644--- a/packages/twenty-docs/l/zh/developers/introduction.mdx+++ b/packages/twenty-docs/l/zh/developers/introduction.mdx@@ -6,7 +6,7 @@ description: 构建应用、使用 API、进行自托管,或为代码库做出import { CardTitle } from "/snippets/card-title.mdx"<CardGroup cols={3}>- <Card href="/l/zh/developers/extend/apps/getting-started" img="/images/user-guide/halftone/dev-apps.png">+ <Card href="/l/zh/developers/extend/apps/getting-started/快速启动" img="/images/user-guide/halftone/dev-apps.png"><CardTitle>应用</CardTitle>使用自定义对象、服务器端逻辑、UI 组件和 AI 代理扩展 Twenty——全部以 TypeScript 软件包形式提供。</Card>diff --git a/packages/twenty-docs/l/zh/developers/self-host/capabilities/docker-compose.mdx b/packages/twenty-docs/l/zh/developers/self-host/capabilities/docker-compose.mdxindex 0cd6f86cc02..1e4cdb24019 100644--- a/packages/twenty-docs/l/zh/developers/self-host/capabilities/docker-compose.mdx+++ b/packages/twenty-docs/l/zh/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,以设置安全 Cookie。#### 理解`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/zh/developers/self-host/capabilities/setup.mdx b/packages/twenty-docs/l/zh/developers/self-host/capabilities/setup.mdxindex 13f1b7877db..596f5fe481d 100644--- a/packages/twenty-docs/l/zh/developers/self-host/capabilities/setup.mdx+++ b/packages/twenty-docs/l/zh/developers/self-host/capabilities/setup.mdx@@ -204,7 +204,13 @@ IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=true* Microsoft Graph: profile* Microsoft Graph: offline_access-注意:“Mail.ReadWrite”和“Mail.Send”仅在你想使用我们的工作流程操作发送电子邮件时是强制性的。 如果你只想接收邮件,你可以使用“Mail.Read”。+<Note>+“Mail.ReadWrite”和“Mail.Send”仅在你想使用我们的工作流程操作发送电子邮件时是必需的。 如果你只想接收邮件,你可以使用“Mail.Read”。+</Note>++<Note>+如果你想使用我们的工作流操作创建日历事件,则必须使用 "Calendars.ReadWrite"。 如果你只想同步日历事件,请使用 "Calendars.Read"。+</Note>### 授权重定向 URI@@ -271,9 +277,9 @@ yarn command:prod cron:workflow:automated-cron-trigger2. 找到 **电子邮件** 部分3. 配置你的 SMTP 设置:-<ArticleTabs label1="Gmail" label2="Office365" label3="Smtp4dev">+<Tabs>- <ArticleTab>+ <Tab title="Gmail">你需要提供一个 [应用密码](https://support.google.com/accounts/answer/185833)。* EMAIL_DRIVER=smtp@@ -282,9 +288,9 @@ yarn command:prod cron:workflow:automated-cron-trigger* EMAIL_SMTP_USER=gmail_email_address* EMAIL_SMTP_PASSWORD='gmail_app_password'- </ArticleTab>+ </Tab>- <ArticleTab>+ <Tab title="Office365">请记住,如果您启用了双重身份验证,您需要提供一个 [应用密码](https://support.microsoft.com/en-us/account-billing/manage-app-passwords-for-two-step-verification-d6dc8c6d-4bf7-4851-ad95-6d07799387e9)。* EMAIL_DRIVER=smtp@@ -293,9 +299,9 @@ yarn command:prod cron:workflow:automated-cron-trigger* EMAIL_SMTP_USER=office365_email_address* EMAIL_SMTP_PASSWORD='office365_password'- </ArticleTab>+ </Tab>- <ArticleTab>+ <Tab title="smtp4dev">**smtp4dev** 是一个用于开发和测试的假 SMTP 电子邮件服务器。* 运行 smtp4dev 镜像: `docker run --rm -it -p 8090:80 -p 2525:25 rnwood/smtp4dev`@@ -305,9 +311,9 @@ yarn command:prod cron:workflow:automated-cron-trigger* EMAIL_SMTP_HOST=localhost* EMAIL_SMTP_PORT=2525- </ArticleTab>+ </Tab>-</ArticleTabs>+</Tabs><Warning>**仅限环境模式:** 如果你设置 `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`,请将这些变量添加到 `.env` 文件中。@@ -380,3 +386,23 @@ LOGIC_FUNCTION_TYPE=DISABLED # default when NODE_ENV=production<Note>当使用 `LOGIC_FUNCTION_TYPE=DISABLED` 或 `CODE_INTERPRETER_TYPE=DISABLED` 时,任何执行尝试都会返回错误。 如果你想在不启用这些功能的情况下运行 Twenty,这将很有用。</Note>++## API 和前端位于不同主机上++仅当你不让后端来提供前端资源时,此项才相关。 同源部署在这里无需任何设置。++声明每一个与 API 通信的浏览器来源(origin),使用逗号分隔。 `SERVER_URL`+和 `FRONTEND_URL` 已被信任。 当浏览器从未声明的来源调用它时,服务器会记录一条警告日志。++```bash+AUTH_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/zh/developers/self-host/capabilities/upgrade-guide.mdx b/packages/twenty-docs/l/zh/developers/self-host/capabilities/upgrade-guide.mdxindex 2a1e1176759..10601e36e25 100644--- a/packages/twenty-docs/l/zh/developers/self-host/capabilities/upgrade-guide.mdx+++ b/packages/twenty-docs/l/zh/developers/self-host/capabilities/upgrade-guide.mdx@@ -25,11 +25,11 @@ cat databases_backup.sql | docker exec -i {db_container_name_or_id} psql -U {pos服务器在启动时会自动运行所有所需的升级迁移。 无需手动执行任何命令。-## 跨版本升级(v1.22+)+## 跨版本升级(v1.23+)-自 **v1.22** 起,Twenty 支持跨版本升级。 您可以从任意受支持的版本直接跳到最新版本,而无需逐一经过每个中间版本。+自 **v1.23** 起,Twenty 支持跨版本升级。 您可以从任意受支持的版本直接跳到最新版本,而无需逐一经过每个中间版本。-例如,从 v1.22 直接升级到 v2.0 完全受支持。+例如,从 v1.23 直接升级到 v2.0 完全受支持。## 升级到 v2.5+ — 静态数据加密信封@@ -97,6 +97,6 @@ docker exec -it {server_container_name_or_id} yarn command:prod upgrade:status -这将仅显示落后或失败的工作区,并附上每个失败的错误信息。-## v1.22 之前+## v1.23 之前-如果您的实例早于 v1.22,您必须按顺序逐步升级经过每个主要标记版本(从 v1.6 到 v1.7,再从 v1.7 到 v1.8,依此类推),直到达到 v1.22。 届时,您可以直接跳到最新版本。+如果您的实例早于 v1.23,您必须按顺序逐步升级经过每个主要标记版本(从 v1.6 到 v1.7,再从 v1.7 到 v1.8,依此类推),直到达到 v1.23。 届时,您可以直接跳到最新版本。diff --git a/packages/twenty-docs/l/zh/getting-started/core-concepts/apps.mdx b/packages/twenty-docs/l/zh/getting-started/core-concepts/apps.mdxindex fe55d97fbd7..92aa1d7cbc5 100644--- a/packages/twenty-docs/l/zh/getting-started/core-concepts/apps.mdx+++ b/packages/twenty-docs/l/zh/getting-started/core-concepts/apps.mdx@@ -36,6 +36,6 @@ description: 通过代码扩展 Twenty——将自定义对象、服务器端逻你在本机上以一个 TypeScript 项目的形式编写你的应用。 CLI 监听你的源码文件,并将它们实时同步到正在运行的 Twenty 服务器——编辑文件后,你可以在一秒内在 UI 中看到变更。 当模式发生变化时,会自动重新生成类型化的 API 客户端。 准备就绪后,使用 `yarn twenty app:publish --private` 推送到生产服务器,或者使用 `yarn twenty app:publish` 将你的应用发布到 npm 和 Twenty 应用市场。-<Card title="构建你的第一个应用" icon="arrow-right" href="/l/zh/developers/extend/apps/getting-started">+<Card title="构建你的第一个应用" icon="arrow-right" href="/l/zh/developers/extend/apps/getting-started/quick-start">三阶段引导——脚手架搭建、本地服务器运行、同步你的更改。</Card>diff --git a/packages/twenty-docs/l/zh/user-guide/data-model/capabilities/relation-fields.mdx b/packages/twenty-docs/l/zh/user-guide/data-model/capabilities/relation-fields.mdxindex 49bf84e0813..a1f530b13b4 100644--- a/packages/twenty-docs/l/zh/user-guide/data-model/capabilities/relation-fields.mdx+++ b/packages/twenty-docs/l/zh/user-guide/data-model/capabilities/relation-fields.mdx@@ -41,8 +41,6 @@ description: 使用关系字段在不同对象之间关联记录。多对多关系采用**连接对象**模式:一个连接双方的中间对象。 借助连接关系功能,Twenty 会直接显示最终关联的记录,并在界面中隐藏该中间对象。-<img src="/images/user-guide/fields/junction-relation-diagram.png" style={{width:'100%'}} />-<Warning>**Beta 功能**:使用前必须在 **Settings → Community → Features** 中启用连接关系。</Warning>diff --git a/packages/twenty-docs/l/zh/user-guide/legal/how-tos/legal-faq.mdx b/packages/twenty-docs/l/zh/user-guide/legal/how-tos/legal-faq.mdxindex ff2a1c35b08..661d5569ad3 100644--- a/packages/twenty-docs/l/zh/user-guide/legal/how-tos/legal-faq.mdx+++ b/packages/twenty-docs/l/zh/user-guide/legal/how-tos/legal-faq.mdx@@ -44,7 +44,7 @@ CRM 内容可在符合次级处理方条款与条件的前提下用于训练 AI所有数据在传输和静态存储过程中都经过加密。 租户数据通过“每个租户单独架构”的方式实现隔离,加密密钥会定期轮换。</Accordion><Accordion title="哪些 Twenty 员工或次级处理方可以访问客户工作区?出于什么目的?访问如何获批并记录?">-Twenty 的工程和支持团队只有在客户报告问题并且客户在“设置 → 常规 → 安全”中同意允许访问工作区时,才能访问客户工作区。+Twenty 的工程和支持团队可能会访问客户工作区,以调查和解决问题。 工作区所有者对此拥有控制权:可以随时在 Settings → General → Security 中禁用支持访问,一旦关闭,将保持关闭状态,直到你再次将其打开。</Accordion><Accordion title="在确认发生影响我们数据的安全事件后,你们的事件通知流程是什么?目标通知时间是多久?">在确认发生影响你方数据的个人数据泄露事件时,我们会在不无故拖延的前提下,并且无论如何会在知悉该事件后的 48 小时内通知你。 在当时已知的范围内,我们的通知将包括:泄露的性质、受影响数据和个人的类别及大致数量、可能产生的后果,以及已采取或计划采取的补救和减缓措施。 我们会在调查进展过程中持续向你提供更新。@@ -64,7 +64,7 @@ Twenty 的工程和支持团队只有在客户报告问题并且客户在“设被移除的记录将在备份中保留 30 天,之后将被永久删除。</Accordion><Accordion title="当工作区被关闭或请求完全删除时,对于生产数据、附件、日志和备份分别适用怎样的具体时间表?">-当工作区被删除时,其数据会立即从活动系统中移除。 备份会保留 7 天,之后所有数据将被永久删除。+当工作区被删除后,其数据会在服务终止后大约 90 天内(通常会更早)从在线系统中移除。 备份和归档副本随后会在接下来 90 天内被覆盖或清除,此后所有数据将被永久删除。 在这两个期间内,数据都与任何运营用途隔离开来。 应要求,我们可以在清除完成后提供书面证明。 有关完整条款,请参见你的数据处理协议第 4.9 条。</Accordion><Accordion title="在任何备份保留期内,被删除的数据是否与日常运营访问和使用相隔离?">是的,在任何备份保留期内,被删除的数据都与运营使用相隔离。@@ -108,4 +108,18 @@ RTO 和 RPO 均为 6 小时(如我们的 DPA 所述)。</Accordion></AccordionGroup>+## 授权许可++<AccordionGroup>+<Accordion title="如果我修改代码以添加仅供我的团队内部使用的功能,是否必须发布这些更改?">+否. 为你自己的团队运行一个修改版本并不构成分发,因此不会产生公开发布义务。 当你所在组织外部人员通过网络与你修改后的实例进行交互时,AGPL 的网络条款适用。+</Accordion>+<Accordion title="如果我创建一个单独的前端,并按原样使用 Twenty 作为后端,我是否必须公开发布这些更改?">+否. 你的前端是你自己的、独立的作品,通过 API 与 Twenty 通信并不会改变这一点。 由于 Twenty 本身未被修改,因此没有任何内容需要公开发布。+</Accordion>+<Accordion title="如果我更改代码以添加功能并转售,我是否必须公开发布这些更改?">+是的,因为你在修改代码并将其分发给他人,你有义务公开发布这些更改。 如果你不想公开发布你的更改,可以获取 Organization 许可证。+</Accordion>+</AccordionGroup>+如果你还有更多问题,请查阅我们的[条款与条件](https://twenty.com/terms)、[隐私政策](https://twenty.com/privacy-policy)和[信任中心](https://trust.twenty.com/)。 如果你的问题仍未得到解答,请将其发送至 [[email protected]](mailto:[email protected]) 或通过支持聊天联系我们。diff --git a/packages/twenty-docs/l/zh/user-guide/workflows/capabilities/use-branches-in-workflows.mdx b/packages/twenty-docs/l/zh/user-guide/workflows/capabilities/use-branches-in-workflows.mdxindex d25030915a5..f631d21db37 100644--- a/packages/twenty-docs/l/zh/user-guide/workflows/capabilities/use-branches-in-workflows.mdx+++ b/packages/twenty-docs/l/zh/user-guide/workflows/capabilities/use-branches-in-workflows.mdx@@ -20,8 +20,6 @@ description: 了解分支如何工作,以及如何控制执行哪条路径。3. 在每个 Filter 上设置条件,以确定该分支何时继续4. 只有满足其 Filter 条件的分支会继续-<img src="/images/user-guide/workflows/branches-with-filters.png" style={{width:'100%'}} />-### Filter 的工作方式* 如果 Filter 条件被**满足**:该分支继续执行