The open alternative to Salesforce, designed for AI.
TypeScript crmcrm-systemcustomergood-first-issuegraphqlhacktoberfestjavascriptmarketingmonoreponestjsopen-sourcepostgresqlreactreactjssalestypescriptweb
i18n - docs translations (#29166)
twenty-pr[bot]cc2cd3740fd7
diff --git a/packages/twenty-docs/ar/developers/extend/apps/config/application.mdx b/packages/twenty-docs/ar/developers/extend/apps/config/application.mdxindex fe170e9d56f..203094d3133 100644--- a/packages/twenty-docs/ar/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/config/application.mdx@@ -55,7 +55,7 @@ export default defineApplication({* يمكن للتطبيق الإبلاغ عن حالة تهيئته الخاصة باستخدام [`defineHealthCheck()`](/ar/developers/extend/apps/logic/logic-functions#health-check)، وذلك للأمور التي لا يعرفها إلا التطبيق نفسه — مفتاح موجود لكنه مُلغى، أو حساب تابع لجهة خارجية على الخطة الخاطئة. يغطي `isRequired` ما يمكن لـ Twenty رؤيته بمفرده؛ بينما يغطي فحص السلامة الباقي.* يقبل كلا نوعي المتغير `isRequired: true`. إذا لم تُدخل مساحة العمل قيمة متغير مطلوب بعد، فسيظل التطبيق غير مُهيأ: تعرض صفحة إعداداته لافتةً تسمي المتغيرات المفقودة، مع زر ينتقل إلى علامة التبويب حيث تُضبط هذه المتغيرات. ضع علامة «مطلوب» فقط على ما لا يمكن للتطبيق تشغيله فعليًا بدونه — يجب أن يظل المتغير الاختياري ذو القيمة الافتراضية المعقولة اختياريًا.* كلا نوعي المتغير يقبلان `isDeprecated: true`. استخدم ذلك لإيقاف استخدام متغير بدلاً من حذفه: إبقاء المفتاح معلناً يحافظ على القيمة المخزنة (حذفه يدمّر القيمة التي أدخلها المشغّل)، ولا يزال يتم حقن المتغير، بحيث يمكن لشفرتك أن تعتمد عليه كخيار احتياطي — `process.env.NEW_API_KEY ?? process.env.API_KEY`. يختفي المتغير المهمل من إعدادات التطبيق عند عدم تحديد قيمة له، ولا يؤخذ في الحسبان ضمن فحص تهيئة التطبيق، لذا تكون `isDeprecated` أعلى أولوية من `isRequired`.-* يُعيّن Twenty هذه الأسماء لكل تشغيل لدالة منطقية، لذا فهي محجوزة: `TWENTY_API_URL`، `TWENTY_APP_ACCESS_TOKEN`، `TWENTY_APP_APPLICATION_ACCESS_TOKEN`، `TWENTY_API_KEY`، `TWENTY_FUNCTIONS_URL` و`APPLICATION_ID`. يتم رفض بيان يصرّح عن أحدها كمتغير للتطبيق أو الخادم عند مزامنة التطبيق أو نشره.+* يُعيّن Twenty هذه الأسماء لكل تشغيل لدالة منطقية، لذا فهي محجوزة: `TWENTY_API_URL`، `TWENTY_APP_ACCESS_TOKEN`، `TWENTY_APP_APPLICATION_ACCESS_TOKEN`، `TWENTY_API_KEY`، `TWENTY_FUNCTIONS_URL`، `TWENTY_SERVER_ROUTES_URL` و`APPLICATION_ID`. يُحجز أيضًا كل اسم آخر يبدأ بـ `TWENTY_` للمتغيرات التي يضيفها Twenty لاحقًا. يُرفض البيان الذي يعلن اسمًا محجوزًا كمتغير للتطبيق أو الخادم عند مزامنة التطبيق أو نشره.* لإضافة إدخالاتك الخاصة إلى قائمة إعدادات التطبيق (بدلًا من صفحة **Variables** المُنشأة)، صرّح بمكوّن واجهة أمامية ووجّه [`defineSettingsMenuItem()`](/ar/developers/extend/apps/layout/front-components#settings-menu-items) إليه، في ملفه الخاص. صرّح بعدد ما تحتاج إليه ورتّبها باستخدام `position`؛ يضع `scope` عنصرًا ضمن إعدادات مساحة العمل أو ضمن إعدادات كل عضو الخاصة. يأتي عنصر **عام** الذي يديره النظام (الترقية التلقائية، عنوان URL للتطبيق، الاتصالات) دائمًا أولًا، ولا يظهر عنوان URL للتطبيق إلا عندما يحتوي التطبيق على وظائف يتم تشغيلها عبر HTTP.## إمكانات الوسائط المطلوبة@@ -191,7 +191,7 @@ const { myUserApplicationVariables } = await client.query({يحفظ `updateMyUserApplicationVariable` قيمة العضو الخاصة به. يأخذ `applicationUniversalIdentifier` الخاص بتطبيقك ويكتب قيمة الشخص الذي يقف خلف الرمز المميز: جلسة العضو نفسه، أو الرمز المميز لتطبيقك عندما يكون عضو خلفه، مثلما يحدث في مكوّن واجهة أو دالة منطقية تُشغَّل لعضو. لا يمكن لرمز تطبيقك تسمية سوى تطبيقك الخاص، ويُرفَض الرمز الذي لا يرتبط به أي شخص، كما في مهمة cron أو خطاف تثبيت. تؤدي القيمة الفارغة إلى إزالة القيمة الخاصة بالعضو، بحيث يقرأ القيمة الافتراضية مجددًا، أو سلسلة فارغة لمتغير لا يملك قيمة افتراضية.-لا يحتاج إلى إذن `APPLICATIONS`، لكنه يحتاج إلى `CONNECTED_ACCOUNTS`: في دور العضو، وعندما يجري الرمز المميز لتطبيقك الاستدعاء، في الدور الافتراضي لتطبيقك أيضًا، إذا كان يعرّف دورًا. إذا كان تطبيقك يحفظ متغيرات المستخدم، فأضف `SystemPermissionFlag.CONNECTED_ACCOUNTS` إلى `permissionFlagUniversalIdentifiers` في [الدور](/ar/developers/extend/apps/config/roles).+لا يتطلب إذن Workspace Apps، لكنه يتطلب User Apps: في دور العضو، وعندما يجري رمز تطبيقك المميز الاستدعاء، في الدور الافتراضي لتطبيقك أيضًا، إذا كان يعرّف واحدًا. إذا كان تطبيقك يحفظ متغيرات المستخدم، فأضف `SystemPermissionFlag.USER_APPS` إلى `permissionFlagUniversalIdentifiers` في [الدور](/ar/developers/extend/apps/config/roles).## الدور الافتراضي للوظيفةdiff --git a/packages/twenty-docs/ar/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/ar/developers/extend/apps/config/roles.mdxindex de346d82eb6..96ac5c71560 100644--- a/packages/twenty-docs/ar/developers/extend/apps/config/roles.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/config/roles.mdx@@ -50,10 +50,20 @@ export default defineRole({canUpdateFieldValue: false,},],- permissionFlagUniversalIdentifiers: [SystemPermissionFlag.APPLICATIONS],+ permissionFlagUniversalIdentifiers: [SystemPermissionFlag.WORKSPACE_APPS],});```+<Note>+ يتوفر `SystemPermissionFlag.USER_APPS` و`SystemPermissionFlag.WORKSPACE_APPS`+ بدءًا من الإصدار 2.54 من `twenty-sdk`؛ وتُسمّى في الإصدارات الأقدم+ `CONNECTED_ACCOUNTS` و`APPLICATIONS`. الأسماء القديمة هي أسماء مستعارة مهملة+ للعلامات نفسها، ويحتفظ الدور بكل علامة مرة واحدة فقط. لا يزال تعداد+ `SystemPermissionFlag`، على سبيل المثال باستخدام `Object.keys`، يعرض الأسماء+ القديمة. تُبلّغ واجهة API أيضًا عن هذه العلامات بمفاتيحها القديمة، على سبيل المثال في+ `currentUserWorkspace.permissionFlags`.+</Note>+## أمن على مستوى الصفتتطلب أذونات على مستوى الصف **خطة Organization أو أعلى** — راجعdiff --git a/packages/twenty-docs/ar/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/ar/developers/extend/apps/data/objects.mdxindex c7d60f1e34f..5af169a747d 100644--- a/packages/twenty-docs/ar/developers/extend/apps/data/objects.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/data/objects.mdx@@ -109,6 +109,7 @@ export default defineObject({* يحافظ `isLabelSyncedWithName`، على كائن أو حقل، على مزامنة اسم API مع التسمية عند تحرير التسمية في الإعدادات. تكون القيمة الافتراضية `false`، لذا تترك التسمية المعاد تسميتها الاسم دون تغيير.* يؤدي `isSearchable: true` في حقل إلى تضمين قيمه في البحث النصي الكامل للكائن (البحث العام وقائمة الأوامر). يتطلب ذلك أن يكون الكائن نفسه قابلاً للبحث وأن يكون نوع الحقل متوافقًا مع النص. تعني القيمة المحذوفة أنه غير قابل للبحث، باستثناء حقل معرّف تسمية الكائن، الذي يكون قابلاً للبحث دائمًا ولا يمكن إلغاء الاشتراك فيه. تفرض كل مزامنة الحالة المُعلنة، لذا فإن الحقل الذي تم تبديله ليصبح قابلاً للبحث من الإعدادات يعود إلى حالته السابقة عند مزامنة تطبيقك التالية ما لم يعلن ملف البيان عنه.* يؤدي تعيين `isAuditLogged: false` في حقل إلى إبقاء تغييراته خارج الخط الزمني للسجل. تكون قيمته الافتراضية `true`، باستثناء حقل `POSITION`، إذ تظهر تغييراته فارغة في الخط الزمني ولا يتم تسجيلها مطلقًا. عيّنه في الحقول التي يعيد تطبيقك كتابتها وفق جدول زمني، مثل طابع زمني لآخر اتصال أو علاقة تجميع، كي لا تضيف كل مزامنة صف نشاط إلى كل سجل تلمسه. لا ينتج عن تحديث يتكوّن فرقُه بالكامل من حقول غير مسجلة للتدقيق أي نشاط في الخط الزمني على الإطلاق. مثل `isSearchable`، تفرض كل عملية مزامنة الحالة المُعلنة.+* يسرد `disabledFieldPermissionActions`، في حقل، أذونات الحقل التي لا يمكن منحها عليه: `'canReadFieldValue'` أو `'canUpdateFieldValue'` أو كليهما، وهي العلامات نفسها التي يعيّنها الدور لكل حقل. لا يحصل المستخدمون ومفاتيح API والوكلاء والتطبيقات الأخرى مطلقًا على هذه الإجراءات في الحقل، بغض النظر عما يمنحه دورهم، ويفشل حفظ إذن حقل يمنح أحدها. تحتفظ دوال المنطق الخاصة بتطبيقك بها. على سبيل المثال، يُبقي `['canUpdateFieldValue']` قيمةً يحسبها تطبيقك أو يزامنها، مثل الحالة أو النتيجة، للقراءة فقط للجميع الآخرين. يعمل هذا أيضًا على الحقول التي تضيفها إلى كائنات لا تملكها باستخدام `defineField()`.* لا تحتاج الحقول المضمّنة المُعرَّفة هنا إلى `objectUniversalIdentifier` — إذ تُورَّث من الكائن الأب. استخدم [`defineField()`](/ar/developers/extend/apps/data/extending-objects) لإضافة حقول إلى كائنات لا تمتلكها.* يمكنك إنشاء كائنات جديدة باستخدام `twenty app add object`، الذي يرشدك خلال التسمية والحقول والعلاقات. راجع [Architecture → Scaffolding entities](/ar/developers/extend/apps/getting-started/scaffolding).diff --git a/packages/twenty-docs/ar/developers/extend/apps/getting-started/concepts.mdx b/packages/twenty-docs/ar/developers/extend/apps/getting-started/concepts.mdxindex e92f2f4275e..b82d9e36801 100644--- a/packages/twenty-docs/ar/developers/extend/apps/getting-started/concepts.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/getting-started/concepts.mdx@@ -22,6 +22,7 @@ your-app/│ ├── front-components/ ← defineFrontComponent│ ├── skills/ ← defineSkill│ ├── agents/ ← defineAgent+│ ├── mcp-servers/ ← defineMcpServer│ ├── views/ ← defineView│ ├── navigation-menu-items/ ← defineNavigationMenuItem│ ├── settings-menu-items/ ← defineSettingsMenuItem@@ -51,6 +52,7 @@ your-app/| **سير العمل** | سير العمل الجاهزة مع تشغيل و خطوات | [Workflows](/ar/developers/extend/apps/logic/workflows) || **موفر الاتصال** | تسجيل الدخول عبر OAuth أو تسجيل دخول مخصص لحسابات تابعة لجهات خارجية | [الاتصالات](/ar/developers/extend/apps/logic/connections) || **موفر المراسلة** | يرسل الردود من قنوات رسائل التطبيق عبر اتصال | [قنوات المراسلة](/ar/developers/extend/apps/logic/messaging-channels#sending-replies) |+| **خادم MCP** | خادم MCP خارجي يمكن للذكاء الاصطناعي لمساحة العمل استدعاؤه | [المهارات والوكلاء](/ar/developers/extend/apps/logic/skills-and-agents) || **عرض** | عروض قوائم السجلات المكوّنة مسبقًا | [العروض](/ar/developers/extend/apps/layout/views) || **عنصر قائمة التنقّل** | عناصر الشريط الجانبي المخصّصة | [عناصر قائمة التنقّل](/ar/developers/extend/apps/layout/navigation-menu-items) || **تخطيط الصفحة** | علامات التبويب وعناصر الواجهة في صفحة تفاصيل السجل | [تخطيطات الصفحات](/ar/developers/extend/apps/layout/page-layouts) |diff --git a/packages/twenty-docs/ar/developers/extend/apps/layout/front-components.mdx b/packages/twenty-docs/ar/developers/extend/apps/layout/front-components.mdxindex 026f03c7a0d..b253cd9f186 100644--- a/packages/twenty-docs/ar/developers/extend/apps/layout/front-components.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/layout/front-components.mdx@@ -163,10 +163,12 @@ export default defineSettingsMenuItem({* **`USER`** — يُعدّه كل عضو لنفسه، ضمن إعدادات المستخدم الخاصة به.<Note>- يُعرَض عنصر `USER` كعلامة تبويب على صفحة التطبيق ضمن **الإعدادات > تفضيلات التطبيق**، حيث لا يراه إلا العضو الذي سجّل الدخول، وفقط عندما يمنح دوره إذن `CONNECTED_ACCOUNTS`. لم تُفعَّل تلك الصفحة في كل مساحات العمل بعد: وحيثما لم تُفعَّل، يستمر حفظ عنصر `USER` ومزامنته، ولكن لا يُعرَض في أي مكان.+ يُعرَض عنصر `USER` كعلامة تبويب في صفحة التطبيق ضمن **الإعدادات > تفضيلات+ التطبيق**، حيث لا يراه إلا العضو الذي سجّل الدخول، وفقط عندما يمنح دوره+ إذن تطبيقات المستخدم. لم تُفعَّل تلك الصفحة في كل مساحات العمل بعد: وحيثما لم تُفعَّل، يستمر حفظ عنصر `USER` ومزامنته، ولكن لا يُعرَض في أي مكان.</Note>-يعمل عنصر `USER` باعتبار العضو الذي يعرضه. لتخزين شيء لكل شخص، عرّف المتغير باستخدام `scope: 'USER'`: تُرجع `getApplicationVariable` قيمة العضو الذي يعرض الصفحة، ويحفظها مكوّنك باستخدام `updateMyUserApplicationVariable`، الذي يكتب قيمة ذلك العضو فقط ويتطلب `SystemPermissionFlag.CONNECTED_ACCOUNTS` في دور تطبيقك، إذا كان يعرّف دورًا (راجع [قراءة المتغيرات وتحديثها في وقت التشغيل](#reading-and-updating-variables-at-runtime)). مثل عنصر `WORKSPACE`، يستبدل عنصر `USER` نموذج **المتغيرات** الذي تم إنشاؤه، لذا يجب أن يتيح للعضو تعيين كل متغير مستخدم يحتاجه تطبيقك. يحتوي متغير مساحة العمل على قيمة واحدة مشتركة بين الجميع، لذا فإن حفظ عضو واحد سيستبدل قيمة عضو آخر.+يعمل عنصر `USER` باعتبار العضو الذي يعرضه. لتخزين شيء لكل شخص، عرّف المتغير باستخدام `scope: 'USER'`: تُرجع `getApplicationVariable` قيمة العضو الذي يعرض الصفحة، ويحفظها مكوّنك باستخدام `updateMyUserApplicationVariable`، الذي يكتب قيمة ذلك العضو فقط ويتطلب `SystemPermissionFlag.USER_APPS` في دور تطبيقك، إذا كان يعرّف دورًا (راجع [قراءة المتغيرات وتحديثها في وقت التشغيل](#reading-and-updating-variables-at-runtime)). مثل عنصر `WORKSPACE`، يستبدل عنصر `USER` نموذج **المتغيرات** الذي تم إنشاؤه، لذا يجب أن يتيح للعضو تعيين كل متغير مستخدم يحتاجه تطبيقك. يحتوي متغير مساحة العمل على قيمة واحدة مشتركة بين الجميع، لذا فإن حفظ عضو واحد سيستبدل قيمة عضو آخر.<Note>تم إهمال `defineSettingsFrontComponent()` لصالح@@ -652,8 +654,8 @@ const saveMyLanguage = async (language: string) => {* رمز المكوّن الخاص بك مرتبط بتطبيقك الخاص. يستهدف `updateOneApplicationVariable` هذا التطبيق، لذا يكون `applicationId` اختياريًا ويُرفض تحديد تطبيق آخر. يُرفض بالطريقة نفسها قراءة `applicationVariables` لتطبيق آخر، ويُتعامل مع التطبيق الذي ينتمي إلى مساحة عمل أخرى على أنه غير موجود.* يجب أن يكون المفتاح من المفاتيح التي يعرّفها تطبيقك في [`defineApplication()`](/ar/developers/extend/apps/config/application). تُعامل كتابة مفتاح غير مُعرَّف على أنها غير موجودة.* تُقرأ المتغيرات السرية مقنّعة، وليس بالقيمة المخزنة مطلقًا. تعمل كتابتها بشكل طبيعي.-* تتطلب قراءة `value` لمتغير وكتابته إذن إعدادات `APPLICATIONS` لكل من دور تطبيقك ودور الشخص المسجّل دخوله، لأن رمز المكوّن هو تقاطع الاثنين. أضف `SystemPermissionFlag.APPLICATIONS` إلى `permissionFlagUniversalIdentifiers` في [دور التطبيق](/ar/developers/extend/apps/config/roles) الخاص بك.-* يتم إدراج متغير مستخدم (`scope: 'USER'`) بقيمة العضو الذي يعرض الصفحة، ما لم يكن سريًا. ترفضه `updateOneApplicationVariable`: احفظه باستخدام `updateMyUserApplicationVariable`، كما يفعل `saveMyLanguage` أعلاه. يكتب قيمة العضو الذي يعرض الصفحة فقط ويرفض تسمية تطبيق آخر. لا يحتاج إلى إذن `APPLICATIONS`، لكنه يحتاج إلى إذن `CONNECTED_ACCOUNTS` في دور العضو الذي يعرض الصفحة وفي دور تطبيقك، إذا كان يعرّف دورًا: أضف `SystemPermissionFlag.CONNECTED_ACCOUNTS` إلى `permissionFlagUniversalIdentifiers` في [دور التطبيق](/ar/developers/extend/apps/config/roles). راجع [متغيرات مساحة العمل والمستخدم](/ar/developers/extend/apps/config/application#workspace-and-user-variables).+* تتطلب قراءة `value` الخاص بمتغير وكتابته إذن إعدادات تطبيقات مساحة العمل في كل من دور تطبيقك ودور الشخص الذي سجّل الدخول، لأن الرمز المميز للمكوّن هو تقاطع الاثنين. أضف `SystemPermissionFlag.WORKSPACE_APPS` إلى `permissionFlagUniversalIdentifiers` في [دور التطبيق](/ar/developers/extend/apps/config/roles).+* يتم إدراج متغير مستخدم (`scope: 'USER'`) بقيمة العضو الذي يعرض الصفحة، ما لم يكن سريًا. ترفضه `updateOneApplicationVariable`: احفظه باستخدام `updateMyUserApplicationVariable`، كما يفعل `saveMyLanguage` أعلاه. يكتب قيمة العضو الذي يعرض الصفحة فقط ويرفض تسمية تطبيق آخر. لا يتطلب إذن تطبيقات مساحة العمل، لكنه يتطلب إذن تطبيقات المستخدم في دور العضو الذي يعرض الصفحة وفي دور تطبيقك، إذا كان يعرّف دورًا: أضف `SystemPermissionFlag.USER_APPS` إلى `permissionFlagUniversalIdentifiers` في [دور التطبيق](/ar/developers/extend/apps/config/roles). راجع [متغيرات مساحة العمل والمستخدم](/ar/developers/extend/apps/config/application#workspace-and-user-variables).### متغيرات النظام@@ -981,6 +983,8 @@ yarn add -D [email protected]استخدم [`MainButton`](/ar/ui/components/input/main-button) للإجراءات البارزة و[`LightButton`](/ar/ui/components/input/light-button) للإجراءات خفيفة الوزن. استخدم `Button` و`Field` و`Input` و`Select` وغيرها من العناصر الأولية من `twenty-ui/primitives/input` لعناصر التحكم والنماذج الأساسية. اتبع الأجزاء الموثقة لكل عنصر تحكم مركب، مثل `Field.Root` و`Field.Label` و`Field.Description`.+مرّر `alignItemWithTrigger={false}` إلى `Select.Positioner`. تتطلب محاذاة العنصر المحدد مع المشغّل، وهي الإعداد الافتراضي في Base UI، قياسات متزامنة للتخطيط لا تستطيع بيئة الاختبار المعزولة توفيرها، لذا تنهار النافذة المنبثقة عند إعادة فتحها.+استخدم [`Dropdown`](/ar/ui/components/navigation/dropdown) من `twenty-ui/components/navigation` لقوائم الإجراءات، ومنتقيات الخيارات، ولوحات النماذج غير المشروطة. استخدم `enqueueSnackbar` من `twenty-sdk/front-component` لإشعارات المضيف.تُصدَّر واجهات برمجة التطبيقات المستقلة `Dialog` و`AlertDialog` أيضاً بواسطة Twenty UI، لكن يُحظر استخدامها مباشرةً في المكوّنات الأمامية. استخدم [واجهة برمجة تطبيقات الاتصال بالمضيف](#host-communication-api) لمربعات الحوار.@@ -1144,13 +1148,13 @@ const Card = () => {تتلقى المعالجات أحداثاً ذات أنواع مبنية من حدث الصفحة، `PointerEvent` أو `MouseEvent` أو `KeyboardEvent` أو `InputEvent` أو `WheelEvent` أو `FocusEvent`، وتوجد تلك المُنشئات في بيئة الاختبار لاستخدام `dispatchEvent()`. يحمل كل حدث مُمرَّر أيضاً واجهة الحدث الاصطناعي الخاصة بـ React (`nativeEvent`, `isDefaultPrevented()`, `isPropagationStopped()`, `persist()`)، لذا يستمر عمل الرمز المكتوب للتعامل مع أحداث React رغم أن بيئة الاختبار تمرر كائن الحدث مباشرة إلى معالجك.-يعبر حدث الصفحة عندما يكون للعنصر الذي تفاعل معه المستخدم، أو لأحد أسلافه في مكوّنك، معالج لنوع ذلك الحدث. يعبر مرة واحدة ثم ينتشر داخل بيئة الاختبار كما يفعل في الصفحة: `event.target` هو العنصر الذي تفاعل معه المستخدم، و`currentTarget` هو العنصر الذي يعمل معالجه، و`stopPropagation()` يمنع تشغيل معالجات الأسلاف، و`relatedTarget` يشير إلى عنصر بيئة الاختبار الذي انتقل التركيز أو المؤشر منه أو إليه، أو يكون `null` عندما يكون ذلك العنصر خارج مكوّنك. كما في React، يعمل `onFocus` و`onBlur` أيضاً عند تغيّر التركيز داخل العنصر، ويعمل `onClickCapture` ومعالجات الالتقاط الأخرى أثناء مرحلة الالتقاط.+يعبر حدثٌ في الصفحة عندما يكون للعنصر الذي تفاعل معه المستخدم، أو لأحد أسلافه في مكوّنك، معالج لنوع ذلك الحدث، أو عندما يكون ضغطةً تنتظرها مستمعات `document` لديك (انظر أدناه). يعبر مرة واحدة ثم ينتشر داخل بيئة الاختبار كما يفعل في الصفحة: `event.target` هو العنصر الذي تفاعل معه المستخدم، و`currentTarget` هو العنصر الذي يعمل معالجه، و`stopPropagation()` يمنع تشغيل معالجات الأسلاف، و`relatedTarget` يشير إلى عنصر بيئة الاختبار الذي انتقل التركيز أو المؤشر منه أو إليه، أو يكون `null` عندما يكون ذلك العنصر خارج مكوّنك. كما في React، يعمل `onFocus` و`onBlur` أيضاً عند تغيّر التركيز داخل العنصر، ويعمل `onClickCapture` ومعالجات الالتقاط الأخرى أثناء مرحلة الالتقاط.تعمل المعالجات التي تضيفها مكتبة باستخدام `React.cloneElement`، مثل تلك المستخدمة خلف الخاصية `render` في Base UI، بعد معالجات العنصر نفسه بدلاً من استبدالها، لذلك فإن تمرير `onClick: undefined` إلى `cloneElement` لا يزيل معالج العنصر. لا يزال بإمكان معالج على عنصر `render` في Base UI استدعاء `event.preventBaseUIHandler()` لتخطي معالج Base UI الخاص.يعكس `event.target.value` و`checked` حالة عنصر التحكم بعد أن يطبق المتصفح تغيير المستخدم: في معالجات `input` و`change` و`click` و`blur` و`focusout`، وفي معالجات `keyup` بالنسبة إلى `value`. في معالجات `keydown` و`beforeinput` والمؤشر، يحتفظان بقيمة عنصر التحكم وحالة التحديد فيه كما كانت عند آخر تعديل له، أياً كان ما يستمع إليه مكوّنك: يقرأ معالج `Enter` النص المكتوب حتى الآن، لكن معالج المفتاح القابل للطباعة لا يرى ذلك المفتاح بعد، لذا اقرأ القيم المباشرة من إدخال متحكم به أو من معالج `onChange`.-تتلقى مستمعات `document` الأحداث التي تعبر من مكوّنك، لكن لا تتلقى أي شيء يحدث في موضع آخر من الصفحة، لذا لالتقاط الاختصارات باستخدام `document.addEventListener('keydown', ...)`، ضع `onKeyDown` على عنصر يلتف حول مكوّنك. لا تتلقى مستمعات `window` سوى `error` و`unhandledrejection`. لا تعبر تحركات المؤشر إلا فوق العناصر التي لها معالج حركة، ويبقى التقاط المؤشر في الصفحة، ولهذا يتوقف السحب بمجرد أن يغادر المؤشر تلك العناصر. `event.preventDefault()` لا يعبر أيضًا؛ إرسال النماذج، و`dragover`/`drop` ونقرات الروابط محمية مسبقًا من أجلك.+تتلقى مستمعات `document` الأحداث التي تعبر من مكوّنك، مع استثناء واحد للضغطات. بينما يستمع مكوّنك إلى `pointerdown` أو `pointerup` أو `pointercancel` أو `mousedown` أو `mouseup` أو `click` على `document`، كما تفعل النافذة المنبثقة المفتوحة لكي تُغلق عند الضغطات خارجها، تصل كل ضغطة إلى تلك المستمعات: تُرسَل ضغطة داخل مكوّنك إلى العنصر الذي ضغطه المستخدم حتى عندما لا يتعامل معها شيء، وتُرسَل ضغطة في مكان آخر من الصفحة إلى `document.body` مع حالة الزر وعدد النقرات ونوع المؤشر الخاص بها، ولكن من دون إحداثيات أو مفاتيح معدِّلة. لا تُرسَل النقرات من دون ضغطة، مثل تفعيل لوحة المفاتيح لعنصر تحكم خارج مكوّنك، والضغطات على أشرطة تمرير الصفحة، ولا تصل إيماءة السحب باللمس خارج مكوّنك إلا على شكل `pointerdown` و`pointercancel`، لذا فهي لا تُغلق نافذة منبثقة مفتوحة. لا يعبر أي شيء آخر من بقية الصفحة، لذا لالتقاط اختصارات لوحة المفاتيح باستخدام `document.addEventListener('keydown', ...)`، ضع `onKeyDown` على عنصر يغلّف مكوّنك. لا تتلقى مستمعات `window` سوى `error` و`unhandledrejection`. لا تعبر تحركات المؤشر إلا فوق العناصر التي لها معالج حركة، ويبقى التقاط المؤشر في الصفحة، ولهذا يتوقف السحب بمجرد أن يغادر المؤشر تلك العناصر. `event.preventDefault()` لا يعبر أيضًا؛ إرسال النماذج، و`dragover`/`drop` ونقرات الروابط محمية مسبقًا من أجلك.### السمات والأنماطdiff --git a/packages/twenty-docs/ar/developers/extend/apps/logic/connections.mdx b/packages/twenty-docs/ar/developers/extend/apps/logic/connections.mdxindex eadaa8c044a..b4d82c178cb 100644--- a/packages/twenty-docs/ar/developers/extend/apps/logic/connections.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/logic/connections.mdx@@ -508,7 +508,7 @@ await reportConnectionAuthFailure({يحدّد `scope` الخاص بالموفّر أيّهما تحصل عليه اتصالاته الجديدة:* `scope: 'WORKSPACE'` (الافتراضي) — يعمل التطبيق مع الاتصالات المشتركة مع مساحة العمل. يؤدي **إضافة اتصال** في إعدادات مساحة عمل التطبيق إلى إنشاء اتصال مشترك في مساحة العمل.-* `scope: 'USER'` — يتصل كل عضو بحسابه الخاص، مما ينشئ اتصالات شخصية. يضيف الأعضاء هذه الاتصالات ويعيدون ربطها ويزيلونها من صفحة التطبيق ضمن **الإعدادات > المستخدم > تفضيلات التطبيقات**، الأمر الذي يتطلب الإذن `CONNECTED_ACCOUNTS` (تطبيقات المستخدم). لا تحتوي إعدادات مساحة عمل التطبيق على زر **إضافة اتصال** لموفّر `USER`.+* `scope: 'USER'` — يتصل كل عضو بحسابه الخاص، مما ينشئ اتصالات شخصية. يضيف الأعضاء التطبيقات ويعيدون ربطها ويزيلونها من صفحة التطبيق ضمن **الإعدادات > المستخدم > تفضيلات التطبيقات**، الأمر الذي يتطلب إذن تطبيقات المستخدم. لا تحتوي إعدادات مساحة عمل التطبيق على زر **إضافة اتصال** لموفّر `USER`.<Note>لم يتم تمكين **تفضيلات التطبيقات** في كل مساحة عمل بعد: ففي الأماكن التي لا تكون فيها مُمكّنة،@@ -520,7 +520,7 @@ await reportConnectionAuthFailure({يكون للاتصال دائمًا نطاق موفره، ويُعد نطاق الموفر جزءًا من هويته: لا يمكن لإصدار لاحق تغيير `scope` لموفر موجود، ويُرفض التحديث إذا حاول ذلك. لنقل خدمة من نطاق إلى آخر، عرّف موفرًا جديدًا باستخدام `universalIdentifier` جديد وأزل الموفر القديم. يؤدي التحديث بعد ذلك إلى حذف الموفر القديم وكل اتصال أُنشئ به عبر مسار قطع الاتصال المعتاد (`onDisconnectLogicFunction`، وإلغاء الرمز المميز، وتنظيف القناة)، ثم يعيد الأعضاء الاتصال عبر الموفر الجديد.-تتطلب إضافة اتصال **لي فقط** أو إعادة اتصاله إذن `CONNECTED_ACCOUNTS`، بينما تتطلب إضافة اتصال **مشترك في مساحة العمل** أو إعادة اتصاله إذن `APPLICATIONS`.+تتطلب إضافة اتصال **لي فقط** أو إعادة ربطه إذن تطبيقات المستخدم، بينما تتطلب إضافة اتصال **مشترك لمساحة العمل** أو إعادة ربطه إذن تطبيقات مساحة العمل.استخدم الاتصال المناسب لكل معالج:diff --git a/packages/twenty-docs/ar/developers/extend/apps/logic/inbox.mdx b/packages/twenty-docs/ar/developers/extend/apps/logic/inbox.mdxindex 6b60f2d68aa..54e0967d4a7 100644--- a/packages/twenty-docs/ar/developers/extend/apps/logic/inbox.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/logic/inbox.mdx@@ -92,4 +92,34 @@ await sendInboxMessage({* إشارة فقط تعطل. وهو لا يضيف العضو إلى المحادثة أو يخطر بها، ومن ثم يدرج كل من ينبغي أن يتلقى الرسالة في `workspaceMemberIds`.* `INBOX_ASSISTANT_MENTION` هو النص الذي يكتبه الملحن عندما يذكر أحد الأعضاء المساعد (`@Ada`)، وبالتالي فإن رسائلك تسميه بنفس الطريقة.+## إرفاق السجلات بمحادثة++تربط `attachRecordToInboxThread()` محادثةً بسجل، وتزيل `detachRecordFromInboxThread()` الرابط.++```ts src/logic-functions/file-call-recap.ts+import {+ attachRecordToInboxThread,+ sendInboxMessage,+} from 'twenty-sdk/logic-function';++const { threadId } = await sendInboxMessage({+ workspaceMemberIds: [owner.id],+ threadKey: `call-recap-${call.id}`,+ idempotencyKey: `call-recap-${call.id}`,+ title: `Recap of ${call.title}`,+ text: call.summary,+});++await attachRecordToInboxThread({+ threadId,+ objectNameSingular: 'company',+ recordId: company.id,+});+```++* يأخذ كلاهما `threadId` الخاص بالمحادثة والسجل باعتبارهما `objectNameSingular` و`recordId`. يمكن ربط المحادثة بالأشخاص والشركات والفرص وسجلات الكائنات المخصصة.+* كلاهما متكرر بأمان: يؤدي إرفاق سجل مرتين إلى الاحتفاظ برابط واحد، ولا يؤدي فصل سجل غير مرفق إلى تغيير أي شيء.+* يعمل الاستدعاء بنفس صلاحية الوصول الخاصة بـ[إرسال رسالة](#who-sends-the-message)، والتي تتطلب إذن `AI`. يجب أن يكون العضو قادرًا على تحرير المحادثة، ويمكن لتطبيقك العمل على محادثة كتبها بنفسه أو مُنحها دوره الافتراضي؛ وإلا فسيفشل الاستدعاء بالرمز `THREAD_NOT_FOUND`.+* يجب أن يكون السجل قابلاً للقراءة باستخدام صلاحية الوصول تلك، وإلا فسيفشل الاستدعاء بالرمز `RECORD_NOT_FOUND`.+<PageBanner illustration="card-page-inbox" />diff --git a/packages/twenty-docs/ar/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/ar/developers/extend/apps/logic/logic-functions.mdxindex 2c639042676..38bb02f6ea5 100644--- a/packages/twenty-docs/ar/developers/extend/apps/logic/logic-functions.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/logic/logic-functions.mdx@@ -293,28 +293,25 @@ export default defineLogicFunction({يمكن الوصول إلى نقطة النهاية عند:```-POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionId+POST https://your-twenty-server.com/webhooks/server/:applicationRegistrationId/:resolverLogicFunctionUniversalIdentifier```-المعرّف هو `id` الخاص بالمحلّل: المفتاح الأساسي الذي يعيّنه الخادم عند مزامنة التطبيق لأول مرة مع مساحة عمل المالك، وليس `universalIdentifier` الوارد في البيان الخاص بك. اقرأه مرة أخرى من واجهة برمجة التطبيقات `/metadata` لمساحة عمل المالك، ثم سجّل عنوان URL هذا لدى الموفّر:+المقطع الأول هو معرّف تسجيل تطبيقك، والثاني هو `universalIdentifier` الخاص بالـ resolver من ملف manifest لديك. لا يُحلّ المسار إلا إلى resolver تابع لذلك التسجيل، في مساحة العمل الخاصة بمالكه. عندما يسجّل تطبيقك webhook نفسه، أنشئ عنوان URL من داخل دالة منطق باستخدام `getServerRouteUrl`؛ يحقن Twenty عنوان URL الأساسي لمسارات خادم تطبيقك باعتباره `TWENTY_SERVER_ROUTES_URL`:-```graphql-query {- findManyLogicFunctions {- id- name- universalIdentifier- }-}+```ts+import { getServerRouteUrl } from 'twenty-sdk/utils';++const destinationUrl = getServerRouteUrl(+ INVOICE_PAID_RESOLVER_UNIVERSAL_IDENTIFIER,+);```<Note>- لا يزال عنوان URL الذي يحمل `universalIdentifier` الخاص بالمحلل يُحل في الوقت الحالي،- وتحمل الاستجابة رأس `Deprecation`. يكون `universalIdentifier`- فريدًا لكل مساحة عمل، وليس عالميًا: إذا أعلن تسجيل آخر تملكه مساحة عمل- مختلفة عن المعرف نفسه، فستجيب المنصة بـ `404` لعنوان URL ذلك- بدلًا من الاختيار بينهما. انقل عناوين URL المسجلة لدى- موفري الخدمة لديك إلى صيغة `id`.+ تستمر عناوين URL التي لا تحتوي إلا على `id` أو `universalIdentifier` الخاص بالمحلل+ (`/webhooks/server/:identifier`) في الحل في الوقت الحالي، ويستجيب كلاهما بترويسة+ `Deprecation`. يعرض نموذج `universalIdentifier` الرمز `409` عندما تعلن عمليتا+ تسجيل عن المعرّف نفسه. انقل عناوين URL المسجلة لدى+ موفري الخدمة لديك إلى نموذج التسجيل.</Note>**الرد على طلب GET للتحقق.** يتحقق بعض الموفّرين من نقطة نهاية قبل أن يرسلوا إليها، وذلك بإرسال طلب `GET` يحمل تحديًا إلى عنوان URL نفسه الذي سيرسلون إليه الأحداث لاحقًا عبر `POST` — وتُعد WhatsApp Cloud API من Meta أحدهم. لا يستجيب مسار الخادم إلا لطلبات `POST` ما لم تحدد خلاف ذلك، لذا أعلن الطريقتين معًا:diff --git a/packages/twenty-docs/ar/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/ar/developers/extend/apps/logic/skills-and-agents.mdxindex ea3e9888095..4d968ab28b9 100644--- a/packages/twenty-docs/ar/developers/extend/apps/logic/skills-and-agents.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/logic/skills-and-agents.mdx@@ -103,6 +103,39 @@ export default defineAgent({* `required` (اختياري) يسرد الخصائص التي يجب على النموذج إرجاعها دائمًا.* `additionalProperties: false` (اختياري) يمنع أي خاصية غير معرّفة في `properties`.+</Accordion>+<Accordion title="defineMcpServer" description="إتاحة خادم MCP خارجي لذكاء اصطناعي مساحة العمل (بيتا)">++<Warning>+ خوادم MCP في مرحلة بيتا وليست متاحة بعد: يمكنك تعريفها، لكن لا يمكن لمساحات العمل استخدام أدواتها حتى يتم إصدار الميزة.+</Warning>++استخدم `defineMcpServer()` لإصدار خادم MCP بعيد (HTTP قابل للبث) مع تطبيقك، بحيث يتمكن ذكاء اصطناعي مساحة العمل من استخدام أدواته دون مزامنة تلك البيانات مع Twenty:++```ts src/mcp-servers/github.ts+import { defineMcpServer } from 'twenty-sdk/define';++import { GITHUB_CONNECTION_PROVIDER_UNIVERSAL_IDENTIFIER } from 'src/constants/universal-identifiers';++export default defineMcpServer({+ universalIdentifier: '0b6c4f7e-3d5a-4a8e-9a0d-6f1e2c3b4a01',+ name: 'github',+ label: 'GitHub',+ url: 'https://api.githubcopilot.com/mcp/',+ connectionProvider: {+ universalIdentifier: GITHUB_CONNECTION_PROVIDER_UNIVERSAL_IDENTIFIER,+ },+});+```++النقاط الرئيسية:+* `name` بصيغة snake_case (أحرف صغيرة وأرقام وشرطات سفلية، يبدأ بحرف، وبحد أقصى 32 حرفًا) وفريد في مساحة العمل. يُضاف كبادئة إلى أسماء أدوات الخادم.+* يجب أن يكون `url` عنوان URL من نوع HTTP أو HTTPS.+* يشير `connectionProvider` (اختياري) إلى [موفر اتصال](/ar/developers/extend/apps/logic/connections) معلن بواسطة التطبيق نفسه. ترسل الاستدعاءات رمز الوصول الخاص بذلك الاتصال كرمز Bearer. احذفه لخادم عام.+* لا يمكن أن يتغير عنوان URL في إصدار لاحق أثناء ربط موفر اتصال، لذلك لا تُرسل الرموز أبدًا إلى مضيف آخر.+* يمكن لمساحات العمل إلغاء تنشيط الخادم؛ ويحافظ إصدار لاحق من التطبيق على هذا الخيار.+* يتطلب `"engines": { "twenty": ">=2.53.0" }`.+</Accordion><Accordion title="runAgent" description="تشغيل وكيل من دالة منطقية">diff --git a/packages/twenty-docs/ar/developers/extend/apps/logic/workflows.mdx b/packages/twenty-docs/ar/developers/extend/apps/logic/workflows.mdxindex c59d20a695a..2f8e9fad0ee 100644--- a/packages/twenty-docs/ar/developers/extend/apps/logic/workflows.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/logic/workflows.mdx@@ -68,7 +68,7 @@ export default defineWorkflow({النقاط الرئيسية:-* يحتاج سير العمل والمشغّل وكل خطوة إلى `universalIdentifier` خاص بها. حافظ على استقرارها عبر الإصدارات: فهي الطريقة التي يطابق بها Twenty سير العمل المثبّت عند التثبيت التالي.+* يحتاج سير العمل وكل خطوة إلى `universalIdentifier` خاص بهما، ويمكن أن يكون للمشغّل واحد. حافظ على استقرارها عبر الإصدارات: فهي الطريقة التي يطابق بها Twenty سير العمل المثبّت عند التثبيت التالي.* يربط `nextStepIds` الرسم البياني. يشير المشغّل إلى الخطوات الأولى، وتشير كل خطوة إلى الخطوات التي تُنفَّذ بعدها.* تقرأ الخطوة مخرجات سابقة باستخدام `{{trigger.\<path>}}` أو `{{\<step universalIdentifier>.\<path>}}`.* يتحقق البناء من التعريف بالكامل: إذ تؤدي أنواع المشغّلات أو الخطوات غير المدعومة، وروابط الخطوات المعطّلة، والمراجع إلى خطوات غير معروفة إلى فشله.@@ -95,6 +95,8 @@ export default defineWorkflow({لا يحصل سير العمل اليدوي من دون `availability` على إدخال في قائمة الأوامر.+يقبل كل مشغّل أيضًا `name` و`position` و`outputSchema` اختيارية، والتي لا تؤثر إلا في كيفية ظهور سير العمل في أداة الإنشاء. من دونها، يستخدم Twenty اسمًا مثل `Manual trigger`، ويضع المشغّل في أعلى اللوحة ويحسب مخطط الإخراج من الإعدادات.+يستمع سير عمل webhook على `https://\<your-twenty-domain>/webhooks/workflows/\<workspaceId>/\<workflowId>`، حيث إن `workflowId` هو معرّف سير العمل المثبّت. يتوفر نص الطلب باعتباره `{{trigger.\<path>}}`.## الخطوات@@ -126,7 +128,8 @@ export default defineWorkflow({يمتلك تطبيق Custom الخاص بمساحة العمل مهام سير العمل المُنشأة في منشئ مهام سير العمل، وتكون الشيفرة مرجعًا موثوقًا لها بقدر ما يكون المنشئ كذلك:-* `twenty app pull` يكتب كل واحد منها من نسخته النشطة، وهي النسخة التي نشرها المنشئ آخر مرة. يتم الإبلاغ عن مهمة سير عمل تستخدم نسختها النشطة إعدادات لا يمكن لملف `defineWorkflow()` التعبير عنها، مثل خطوة Code أو مشغّل أعاد المنشئ تسميته، وتُترك في مكانها.+* `twenty app pull` يكتب كل واحد منها من نسخته النشطة، وهي النسخة التي نشرها المنشئ آخر مرة. يتم الإبلاغ عن سير عمل تستخدم نسخته النشطة إعدادات لا يمكن لملف `defineWorkflow()` التعبير عنها، مثل خطوة Code، ويُترك في مكانه.+* يحتفظ سير العمل المسحوب بما خزّنته أداة الإنشاء: مشغّل من دون `universalIdentifier`، واسم المشغّل في أداة الإنشاء، و`position` بقيمة `null` لعقدة لم تضعها أداة الإنشاء مطلقًا، و`outputSchema` يختلف عن المخطط المحسوب. تتطلب هذه الحقول twenty-sdk 2.53.0 أو إصدارًا أحدث، مطبقًا على خادم بإصدار 2.53.0 أو أحدث: ترفضها الإصدارات الأقدم باعتبارها مفاتيح غير معروفة.* `twenty app apply` ينشر مثل المنشئ. يُترك سير العمل الذي يتطابق تعريفه مع نسخته النشطة دون تغيير. وإلا، تُؤرشف النسخة النشطة ويصبح التعريف نسخة نشطة جديدة، بحيث تحتفظ عمليات التشغيل السابقة بالنسخة التي شُغِّلت بها.* يواصل المستخدمون تحرير مسارات العمل هذه في أداة الإنشاء، ويجلب السحب التالي تغييراتهم مرة أخرى.diff --git a/packages/twenty-docs/ar/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/ar/developers/extend/apps/operations/cli.mdxindex 86700b14e24..e7c13119664 100644--- a/packages/twenty-docs/ar/developers/extend/apps/operations/cli.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/operations/cli.mdx@@ -103,18 +103,18 @@ npx twenty@latest app devأوامر التطبيقات الأخرى:-| أمر | ماذا يفعل |-| ----------------------------- | ----------------------------------------------------------------- |-| `app add` | إنشاء هيكل لكائن أو حقل أو دالة منطقية أو كيان آخر |-| `app build` / `app typecheck` | بناء التطبيق محليًا أو التحقق من أنواعه |-| `app plan` | معاينة تغييرات البيانات الوصفية التي سيجريها التطبيق |-| `app apply` | بناء التطبيق ورفعه ومزامنته |-| `app generate-client` | إعادة إنشاء عميل API مضبوط الأنواع دون مزامنة |-| `app pull` | كتابة البيانات الوصفية للتطبيق المثبّت مرة أخرى إلى المصدر المحلي |-| `app translations extract` | استخراج السلاسل القابلة للترجمة إلى كتالوجات `locales/` |-| `app publish` | نشر التطبيق على npm أو في سجل Twenty خاص |-| `app install` | تثبيت حزمة تطبيق مسجّلة بالفعل في مساحة العمل |-| `app uninstall` | إزالة التطبيق وكل ما يملكه من مساحة العمل |+| أمر | ماذا يفعل |+| ----------------------------- | ------------------------------------------------------- |+| `app add` | إنشاء هيكل لكائن أو حقل أو دالة منطقية أو كيان آخر |+| `app build` / `app typecheck` | بناء التطبيق محليًا أو التحقق من أنواعه |+| `app plan` | معاينة تغييرات البيانات الوصفية التي سيجريها التطبيق |+| `app apply` | بناء التطبيق ورفعه ومزامنته |+| `app generate-client` | إعادة إنشاء عميل API مضبوط الأنواع دون مزامنة |+| `app pull` | استعادة البيانات الوصفية والترجمات والتبعيات المخزنة |+| `app translations extract` | استخراج السلاسل القابلة للترجمة إلى كتالوجات `locales/` |+| `app publish` | نشر التطبيق على npm أو في سجل Twenty خاص |+| `app install` | تثبيت حزمة تطبيق مسجّلة بالفعل في مساحة العمل |+| `app uninstall` | إزالة التطبيق وكل ما يملكه من مساحة العمل |تُحذف التعريفات المفقودة من مصدرك من مساحة العمل افتراضيًا. مرّر `--no-prune` للاحتفاظ بها. يحتفظ بها تطبيق Custom لمساحة العمل ما لم تمرّر `--prune`. يؤدي حذف الكائنات أو الحقول إلى حذف بياناتها أيضًا، لذا يتطلب تأكيدًا. راجع [المزامنة والاستعادة](/ar/developers/extend/apps/operations/sync-and-recovery) للتفاصيل.diff --git a/packages/twenty-docs/ar/developers/extend/apps/operations/marketplace-review.mdx b/packages/twenty-docs/ar/developers/extend/apps/operations/marketplace-review.mdxindex 96b4cc38993..4e24b7b57fb 100644--- a/packages/twenty-docs/ar/developers/extend/apps/operations/marketplace-review.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/operations/marketplace-review.mdx@@ -1,25 +1,23 @@----title: التحقق من سوق التطبيقات (قيد التنفيذ)-description: المتطلبات المقترحة لتلقّي تطبيقات الجهات الخارجية شارة «تم التحقق منه».+title: مراجعة سوق التطبيقات+description: متطلبات الأمان والجودة التي يجب أن يستوفيها كل تطبيق ليتم إدراجه في سوق التطبيقات.---import { PageBanner } from "/snippets/page-banner.mdx"-## كيف يعمل التدقيق+## كيف تعمل المراجعة-<Warning>- **العمل جارٍ.** قد تتطور هذه الصفحة ومتطلباتها. التحقق من تطبيقات الجهات الخارجية- غير متاح بعد. راجع- [النشر](/ar/developers/extend/apps/operations/publishing#marketplace-visibility-and-review)- للاطلاع على السلوك الحالي لسوق التطبيقات.-</Warning>+لقد اجتاز كل تطبيق مُدرج في سوق التطبيقات مراجعة Twenty للأمان والجودة. لا يؤدي النشر إلى npm إلى إدراج تطبيق تلقائيًا: إذ يظل غير مُدرج+حتى تكتمل المراجعة. راجع+[النشر](/ar/developers/extend/apps/operations/publishing#marketplace-visibility-and-review)+لمعرفة كيفية عمل الإدراج.-ينطبق التحقق على إصدار وحزمة محددين للتطبيق. يحتاج كل تحديث إلى مراجعة-وموافقة من Twenty. قد يُعاد تقييم التطبيقات المُدقَّقة مع تطور التبعيات أو الخدمات.+قد يُعاد تقييم التطبيقات المُدرجة مع تطور التطبيقات نفسها أو تبعياتها أو الخدمات التي+تعتمد عليها، ويمكن إلغاء إدراجها إذا لم تعد تستوفي قائمة التحقق.-## قائمة التحقق+## قائمة التحقق للمراجعة-يجب أن تجتاز جميع العناصر المنطبقة. نوصي باستخدام وكيل للتقييم الذاتي+يجب أن تجتاز جميع العناصر المنطبقة. نوصي باستخدام وكيل لإجراء تقييم ذاتيلكل معيار مع الأدلة والإصلاحات المطلوبة قبل الإرسال.* [ ] **الناشر.** [طالب بتطبيقك](/ar/developers/extend/apps/operations/publishing#claiming-your-app)@@ -28,32 +26,32 @@ import { PageBanner } from "/snippets/page-banner.mdx"النتائج المانعة.* [ ] **الأذونات.** اطلب فقط[الأذونات](/ar/developers/extend/apps/config/roles) اللازمة لميزات التطبيق.-* [ ] **الوظائف.** يسهل اتباع الإعداد وسير العمل الأساسي ويعملان كما هو- معلن، من دون أعطال أو فقدان للعمل أو سجلات مكررة. لا توجد ميزات- نائبة أو عناصر تحكم معطلة.-* [ ] **الأداء.** التزم بحدود المعدل المشتركة لواجهة API/المهام، وتعامل مع التقييد، و+* [ ] **الوظائف.** من السهل اتباع الإعداد وسير العمل الأساسي ويعملان كما+ هو معلن، دون أعطال أو عمل مفقود أو سجلات مكررة. لا توجد ميزات مؤقتة+ أو عناصر تحكم معطلة.+* [ ] **الأداء.** احترم حدود المعدل المشتركة لـ API/المهام، وتعامل مع التقييد، واتبع- [الممارسات الجيدة لتطوير التطبيقات](/ar/developers/extend/apps/getting-started/good-practices).+ [أفضل ممارسات تطوير التطبيقات](/ar/developers/extend/apps/getting-started/good-practices).* [ ] **الفائدة.** أنجز مهمة ذات معنى في CRM لجمهور أوسع من- إعداد عميل واحد. تتأهل الموصلات الصغيرة وعمليات الأتمتة بلا واجهة.-* [ ] **التجربة الأصلية.** أعد استخدام الكائنات والعروض وسير العمل الأصلية عند الاقتضاء.+ إعداد عميل واحد. تتأهل الموصلات الصغيرة وعمليات الأتمتة دون واجهة مستخدم.+* [ ] **تجربة أصلية.** أعد استخدام الكائنات والعروض وسير العمل الأصلية عند الاقتضاء.إذا كان للتطبيق واجهة مستخدم، فاستخدم[`twenty-ui`](/ar/developers/extend/apps/layout/front-components#using-twenty-ui-components)وطابق تخطيطات Twenty وتفاعلاتها واصطلاحات إمكانية الوصول فيها.-* [ ] **الخصوصية.** وضّح البيانات التي تغادر مساحة العمل، وإلى أين تذهب ولماذا،+* [ ] **الخصوصية.** اشرح البيانات التي تغادر مساحة العمل، وإلى أين تذهب ولماذا،بما في ذلك موفرو الذكاء الاصطناعي، ومدة الاحتفاظ بها، وكيفية حذفها.-* [ ] **الصيانة والتوافق.** حدّد إصدارات Twenty المدعومة، وحافظ على استقرار- معرّفات الكيانات، وأصلح الأخطاء الحرجة وعمليات التكامل المعطلة مع مرور+* [ ] **الصيانة والتوافق.** صرّح بإصدارات Twenty المدعومة، وحافظ على استقرار+ معرّفات الكيانات، وأصلح الأخطاء الحرجة وعمليات التكامل المعطلة بمرورالوقت.-* [ ] **الشعار والمعرض.** وفّر شعارًا أصليًا يسهل تمييزه وصورًا مصقولة+* [ ] **الشعار والمعرض.** قدّم شعارًا أصليًا يسهل تمييزه وصورًا مصقولةللتطبيق الفعلي. اتبع[إرشادات الصور](/ar/developers/extend/apps/operations/publishing#marketplace-metadata).-* [ ] **الإدراج وREADME.** صف الميزات والانتماءات بدقة في- الاسم والوصف ولقطات الشاشة. اجعل README قصيرًا ومنسقًا جيدًا،+* [ ] **الإدراج وREADME.** صف الميزات والارتباطات بدقة في+ الاسم والوصف ولقطات الشاشة. حافظ على README مختصرًا ومنسقًا جيدًا،ومركزًا على قيمة التطبيق.* [ ] **التسعير.** وضّح بجلاء ما إذا كان التطبيق مجانيًا أو مدفوعًا، وأسعار الخطط،وتكرار الفوترة، وأي خدمات مدفوعة مطلوبة من جهات خارجية.-* [ ] **التوثيق والدعم.** وفّر إرشادات الإعداد ومثالًا عمليًا،+* [ ] **الوثائق والدعم.** قدّم تعليمات الإعداد ومثالًا عمليًا،وجهة اتصال للدعم. إذا كنت تستخدم مسارات مشتركة، فأكمل[الإعداد](/ar/developers/extend/apps/operations/publishing#setting-up-server-routes)وتحقق من وصول الأحداث إلى مساحة العمل الصحيحة.diff --git a/packages/twenty-docs/ar/developers/extend/apps/operations/overview.mdx b/packages/twenty-docs/ar/developers/extend/apps/operations/overview.mdxindex 9397a412428..e246bb7007a 100644--- a/packages/twenty-docs/ar/developers/extend/apps/operations/overview.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/operations/overview.mdx@@ -42,8 +42,8 @@ import { CardTitle } from "/snippets/card-title.mdx"بناية ، نشر كرة التار ، نشر إلى npm ، تثبيت.</Card><Card href="/ar/developers/extend/apps/operations/marketplace-review" img="/images/documentation/banner-icons-v2/permissions.svg">- <CardTitle>فحص السوق (WIP)</CardTitle>- مقترح لأمان وجودة وعمليات فحص تشغيلي لإصدار تطبيقات طرف ثالث.+ <CardTitle>مراجعة السوق</CardTitle>+ عمليات التحقق من الأمان والجودة والتشغيل التي يجب أن يجتازها التطبيق حتى يتم إدراجه.</Card><Card href="/ar/developers/extend/apps/operations/monitoring" img="/images/user-guide/halftone/card-page-monitoring.svg"><CardTitle>رصد</CardTitle>diff --git a/packages/twenty-docs/ar/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/ar/developers/extend/apps/operations/publishing.mdxindex 4c3d13eeef2..2db96c30001 100644--- a/packages/twenty-docs/ar/developers/extend/apps/operations/publishing.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/operations/publishing.mdx@@ -222,7 +222,7 @@ npm يقبل إثبات المصدر (provenance) فقط من مستودعات## النشر على npm-يؤهل نشر تطبيقك على npm تطبيقك لسوق Twenty. بعد مزامنة الكتالوج وأي [إعداد مطلوب لمسار الخادم](#setting-up-server-routes)، يمكن لمساحات العمل استعراضه وتثبيته وترقيته من واجهة المستخدم. تظهر تطبيقات المجتمع عندما يعطل المستخدمون عامل التصفية **المعتمدة فقط**.+يؤهل نشر تطبيقك على npm تطبيقك لسوق Twenty. بعد مزامنة الكتالوج وأي [إعداد مطلوب لمسار الخادم](#setting-up-server-routes)، يمكن لمساحات العمل استعراضه وتثبيته وترقيته من واجهة المستخدم بمجرد اجتيازه [مراجعة السوق](/ar/developers/extend/apps/operations/marketplace-review).### المتطلبات@@ -370,17 +370,13 @@ twenty app publish --tag betaتتم إدارة هذا الإعداد مسبقاً بالنيابة عنك على Twenty Cloud.</Accordion>-## الظهور في السوق والاعتماد+## ظهور السوق والمراجعة-تحدد المطالبة الملكية؛ ولا تمنح شارة **معتمد**. يكون السوق افتراضياً على **المعتمدة فقط**. للعثور على تطبيقات المجتمع، انتقل إلى **الإعدادات > التطبيقات > السوق**، وافتح عامل التصفية، وأزل تحديد **المعتمدة فقط**. يمكنك أيضاً مشاركة صفحة التثبيت المباشر لتطبيقك باستخدام **تطبيقاتي > تطبيقك > التوزيع > نسخ رابط المشاركة**.+اجتاز كل تطبيق مُدرج في السوق مراجعة Twenty للأمان والجودة. يبقى التطبيق المنشور حديثًا غير مُدرج إلى أن يجتاز [مراجعة السوق](/ar/developers/extend/apps/operations/marketplace-review)؛ تؤدي المطالبة به إلى إثبات الملكية، لكنها لا تُدرجه.-تنطبق تسمية المعتمد حالياً على التطبيقات التي تديرها Twenty، والتي يمكن للفريق أن يضمن أمانها وجودتها. يمكن نشر تطبيقات الجهات الخارجية وتثبيتها من دون هذه التسمية.+لا يزال بالإمكان تثبيت تطبيق غير مُدرج. في **الإعدادات > التطبيقات > السوق**، افتح عامل التصفية وفعّل **إظهار التطبيقات غير المُدرجة**، أو شارك صفحة التثبيت المباشر للتطبيق باستخدام **تطبيقاتي > تطبيقك > التوزيع > نسخ رابط المشاركة**. ترى مساحات العمل تحذيرًا يفيد بأن التطبيق لم يخضع للمراجعة من قِبل Twenty.-إن [قائمة التحقق المقترحة لفحص السوق التابع لجهة خارجية](/ar/developers/extend/apps/operations/marketplace-review)-قيد الإعداد. وهي تصف معايير المراجعة والأدلة الخاصة بكل إصدار،-وليست برنامج شهادات متاحًا.--إذا كان تطبيقك لا يزال مفقوداً مع تعطيل **المعتمدة فقط**، فتأكد من اكتمال مزامنة الكتالوج، وملء جميع متغيرات الخادم المطلوبة، واكتمال أي إعداد لمسار الخادم.+إذا كان تطبيقك مُدرجًا لكنه لا يزال مفقودًا من السوق، فتأكد من اكتمال مزامنة الكتالوج، وتعبئة جميع متغيرات الخادم المطلوبة، واكتمال أي إعداد لمسار الخادم.## تثبيت التطبيقاتdiff --git a/packages/twenty-docs/ar/developers/extend/apps/operations/sync-and-recovery.mdx b/packages/twenty-docs/ar/developers/extend/apps/operations/sync-and-recovery.mdxindex a782bfc2f34..d5e000e7ce4 100644--- a/packages/twenty-docs/ar/developers/extend/apps/operations/sync-and-recovery.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/operations/sync-and-recovery.mdx@@ -24,7 +24,7 @@ import { PageBanner } from "/snippets/page-banner.mdx"| معاينة التغييرات **بدون تطبيقها** | `twenty app plan` | يحتسب الفرق ويطبعه؛ ولا يكتب أي شيء. || المزامنة دون حذف أي شيء | `twenty app apply --no-prune` | ينشئ ويحدّث فقط: تُترك الكيانات الموجودة في مساحة العمل ولكنها غير موجودة في مصدرك كما هي. تقبله أيضًا `plan` و`dev`. || تقليم التطبيق المخصص لمساحة العمل | `twenty app apply --prune` | يحتفظ ذلك التطبيق بالكيانات غير الموجودة في المصدر ما لم تمرر `--prune`. مقبول أيضًا بواسطة `plan` و`dev`. |-| إعادة إنشاء المصدر المحلي من مساحة العمل | `twenty app pull` | **تجريبي.** يكتب التطبيق المثبّت مرة أخرى إلى ملفات التعريف. انظر أدناه. |+| إعادة إنشاء المصدر المحلي من مساحة العمل | `twenty app pull` | **تجريبي.** يستعيد ملفات التعريف والترجمات والتبعيات المخزنة. انظر أدناه. || إزالة التطبيق من مساحة العمل | `twenty app uninstall` | أضف `--yes` لتخطي رسالة التأكيد. || إرسال ملف tarball إلى خادم | `twenty app publish --private` | يتطلّب إصدارًا **أعلى بشكل صارم** في `package.json` — راجع قسم [النشر](/ar/developers/extend/apps/operations/publishing). || النشر في السوق (npm) | `twenty app publish` | — |@@ -109,17 +109,23 @@ Plan: 1 to add, 1 to change, 0 to destroy.قبل تشغيله، وراجِع الفرق.</Warning>-`twenty app pull` هو عكس `apply`: يقرأ تطبيقًا من مساحة العمل ويعيد كتابته كملفات تعريف.+`twenty app pull` هو عكس `apply`: يقرأ تطبيقًا من مساحة العمل ويستعيد ملفات التعريف والترجمات وملفات التبعيات المخزنة الخاصة به.```bash-twenty app pull --universal-identifier <universalIdentifier>+twenty app pull --remote dev+twenty app pull --path ./workspace-app --yes --no-input```-يتطلب السحب مشروعًا موجودًا — أنشئ واحدًا باستخدام `twenty app init` أولًا، ثم اسحب إليه. من دون `--universal-identifier`، يستهدف السحب التطبيق الذي يعلنه ملف `defineApplication()` المحلي لديك. إذا كان `--universal-identifier` يحدد تطبيقًا مختلفًا عن التطبيق الذي يعلنه مشروعك، يرفض السحب بدلًا من ترك تطبيقين في شجرة واحدة: اسحب ذلك التطبيق إلى دليله الخاص. إذا كان المشروع يحتوي على ملف تطبيق لا يمكن قراءة معرّفه، عادةً لأن التبعيات غير مثبّتة، فإن pull يرفض أيضًا ويطلب منك تشغيل `yarn install` أولًا. أضف `--verbose` لتوسيع أقسام التغطية في التقرير، والتي تسمي عندئذ ما يصل إلى 20 معرّفًا لكل نوع من البيانات الوصفية بدلًا من الإجماليات فقط.+داخل تطبيق، يقرأ pull معرّف `defineApplication()` المحلي ويسترجع ذلك التطبيق. خارج تطبيق، يطلب دليلاً وتأكيداً، وينشئ مشروعاً محلياً للتطبيق المخصص لمساحة العمل المحددة، ويثبّت التبعيات باستخدام Yarn، ثم يسحب التعريفات. يتضمن المشروع الجديد ملفات الحزمة والتهيئة، من دون كيانات العرض التوضيحي الخاصة بالمُهيِّئ.++استخدم `--path` لتحديد تطبيق موجود أو دليل جديد أو فارغ. يتطلب الإنشاء غير التفاعلي `--path` و`--yes`؛ ويرفض pull الكتابة فوق دليل غير فارغ وغير ذي صلة. لا يؤدي إنشاء مشروع إلى تسجيل تطبيق أو تغيير مساحة العمل. يؤدي مشروع SDK موجود دون تعريف تطبيق أيضًا إلى سحب التطبيق المخصص. لا يوجد خيار `--universal-identifier`.++إذا فشل تثبيت التبعيات لمشروع جديد، فسيُحتفَظ بالهيكل المُنشأ. شغّل `yarn install` داخله، ثم أعد محاولة السحب. لا تثبّت المشاريع الموجودة التبعيات تلقائيًا. إذا تعذرت قراءة معرّف التطبيق الخاص بها، فسيُبلّغ السحب عن ذلك الخطأ بدلًا من إنشاء تطبيق آخر. أضف `--verbose` لتوسيع أقسام التغطية في التقرير، والتي تسمي عندئذ ما يصل إلى 20 معرّفًا لكل نوع من البيانات الوصفية بدلًا من الإجماليات فقط.**ما الذي يكتبه:*** تكوين التطبيق؛+* ملفات التبعيات المخزنة `package.json` و`yarn.lock`، في جذر المشروع؛* الكائنات، مع حقولها مضمنة؛* الحقول التي أضافها تطبيقك إلى كائنات لا يملكها؛* الفهارس المنشأة؛@@ -138,6 +144,10 @@ twenty app pull --universal-identifier <universalIdentifier>يذهب كل كيان إلى الملف الذي يعرّفه بالفعل، لذا لا يعيد السحب الثاني كتابة سوى ما تغيّر على الخادم. يُعاد أيضًا كتابة ملف عندما يستخدم دالة تعريف مختلفة عما ستكتبه عملية السحب، على سبيل المثال، دور أصبح الدور الافتراضي أو لم يعد كذلك. توضع الكيانات الجديدة بجانب الملفات الموجودة من نوعها، ويكون الاسم المُولَّد الذي قد يقع على ملف غير ذي صلة مؤهَّلًا بدلًا من استبداله.+**ملفات التبعيات.** عند تغيير `package.json` أو `yarn.lock` المخزَّن، يستبدل السحب الملف المحلي ويبلّغ عن أي تعديلات محلية تمت الكتابة فوقها. إذا لم يتغير الملف البعيد منذ السحب السابق، تُحتفَظ بالتعديلات المحلية. لا يؤدي غياب ملف بعيد إلى حذف نظيره المحلي. عندما لا تتضمن الحزمة المُصدَّرة `twenty-sdk`، كما يفعل تطبيق Custom لمساحة العمل، يحتفظ السحب بتبعية SDK المحلية لكي تظل أوامر CLI قادرة على تحميل المشروع. تُكتب ملفات التبعيات والبيانات الوصفية والخط الأساسي معًا، ويُتراجع عنها معًا إذا فشلت عملية كتابة.++شغّل `yarn install` بعد سحب تغييرات التبعيات. لا يثبّت السحب الحزم، ولا يشغّل نصوص الحزم، ولا يعيد إنشاء العميل مكتوب الأنواع.+**ما الذي لا يكتبه:*** **لم تُصدَّر بعد** — عناصر قائمة الأوامر وعناصر قائمة الإعدادات، ودوال المنطق والمكونات الأمامية، وموفرو الاتصال، ومتغيرات التطبيق، والأصول العامة، وأنواع نشاط المخطط الزمني، والمصدر المخزَّن لدوالك.@@ -146,15 +156,15 @@ twenty app pull --universal-identifier <universalIdentifier>* **موضوعة في تخطيط صفحة افتراضي أو أجنبي** — تُكتب علامات التبويب والأدوات المضافة إلى تخطيط صفحة افتراضي للمحرك، أو إلى تخطيط يملكه تطبيق آخر، كملفات `definePageLayoutTab()` و`definePageLayoutWidget()` مستقلة، لأن المعرّف الذي ترتبط به معروف.* **أدوات لا يمكن للتصدير حملها بعد** — في أي تخطيط، بما في ذلك تخطيطك الخاص، يتم الإبلاغ عن أداة من النوع المهمل `VIEW`، أو أداة تعرض أحد المكوّنات الأمامية الخاصة بتطبيقك أو عناصر قائمة الأوامر، أو أداة بلا موضع لوضع تخطيط علامة التبويب الخاصة بها، ويُكتب التخطيط أو علامة التبويب بدونها.* **سير العمل التي لا يمكن للتصدير نقلها بعد** — يُبلّغ عن سير عمل تم تغييره في منشئ سير العمل منذ آخر مزامنة، أو سير عمل للنظام أو خاص، أو سير عمل يتضمن خطوة Code أو رسالة دردشة، وهي أمور لا يدعمها سير عمل التطبيق، وكذلك سير عمل يستدعي إجراء سير عمل لتطبيق آخر، ويُترك في مكانه. يُعد التطبيق المخصص لمساحة العمل الاستثناء للحالتين الأولى والأخيرة: إذ ينشر المنشئ سير العمل الخاص به أيضًا، وقد يستدعي إجراءات أي تطبيق، لذا يتم جلبه. يتم الإبلاغ عن أحد مهام سير العمل الخاصة به بدلًا من ذلك عندما لا تكون له نسخة نشطة، أو عندما تستخدم نسخته النشطة إعدادات لا يمكن للتعريف التعبير عنها. تُستخرج خطوات البريد الإلكتروني والتقويم: يُكتب الحساب المشترك مع مساحة العمل بوصفه `connectedAccountHandle` الخاص به، بينما يُحتفظ بالحساب الخاص بالعضو والمتغيرات كما هي. يُبلّغ عن سير العمل بدلاً من ذلك عندما يكون حساب إحدى الخطوات مؤرشفًا، أو لم يعد بإمكانه تنفيذ الخطوة، أو يشارك عنوانه مع حساب أقدم، لأن تطبيق المعرّف سيختار حسابًا آخر.-* **الوكلاء والمهارات التي لا يمكن للتصدير حملها بعد** — يتم الإبلاغ عن مهارة معطّلة، ووكيل له أكثر من دور واحد أو مرتبط بسحب دور لا يكتب، ويُتركان في مكانهما.-* **حالة وقت تشغيل مساحة العمل** — تعيينات أدوار الأعضاء ومفاتيح API، وخطافات الويب، والتنقل لكل مستخدم وعناصر التنقل المثبّتة بسجل، وكلها مستبعدة حسب التصميم.+* **الوكلاء الذين لا يمكن للتصدير نقلهم بعد** — يُبلّغ عن الوكيل الذي له أكثر من دور واحد، أو المرتبط بدور لا تكتب إليه عملية السحب، ويُترك في مكانه.+* **حالة وقت التشغيل لمساحة العمل**، ومرفقات السجلات، ومرفقات البريد الإلكتروني، وتعيينات أدوار الأعضاء ومفاتيح API، وخطافات الويب، والتنقل لكل مستخدم، وعناصر التنقل المثبتة في سجل، كلها مستبعدة حسب التصميم، بما في ذلك لتطبيق Custom لمساحة العمل.* **مملوك لتطبيق آخر** — يُبلَّغ عنه، ولا يُسحب مطلقًا.يسرد التقرير في نهاية عملية السحب كل ذلك، مجمّعًا حسب النوع والسبب. كل ما يشير إليه على أنه غير مكتوب لا يزال موجودًا في مساحة عملك، لذا أعد دفع شجرة مسحوبة باستخدام `twenty app apply --no-prune` حتى تُغطى الأنواع المفقودة. يُطبَّق التطبيق المخصص لمساحة العمل بهذه الطريقة افتراضيًا بالفعل. سيحذف تطبيق مع التقليم (الإعداد الافتراضي للتطبيقات الأخرى، و`--prune` للتطبيق المخصص) تلك العناصر، ويسرد `twenty app plan` بالضبط العناصر التي سيحذفها.**الحالة المحلية لمساحة العمل.** يُكتب الكيان المعطّل في مساحة العمل كتعريف نشط، ولا تُكتب التجاوزات التي أجرتها مساحة العمل على كيان، مثل تسمية معاد تسميتها. يسرد التقرير تلك الصفوف ضمن "مكتوبة بدون حالتها المحلية لمساحة العمل". إن تطبيق الشجرة مرة أخرى على مساحة العمل نفسها يترك تلك الحالة دون تغيير؛ وتحصل مساحة عمل أخرى على الكيان نشطًا وبدون التجاوزات.-**الملف الأساسي.** يسجل pull ما سحبه في `.twenty/pull-base.json`، وهو متجاهَل بواسطة git ولكل checkout. هذا الملف هو ما تقارن به عملية سحب لاحقة لترك الملفات التي لم يتغير كيانها دون مساس، ولحذف ملف كيان لم يعد موجودًا في مساحة العمل. إن checkout من دونه يكتب كل شيء ببساطة ولا يحذف شيئًا.+**الملف الأساسي.** يسجل السحب ما سحبه في `.twenty/cli/pull-base.json`، وهو متجاهل بواسطة git ولكل نسخة سحب. هذا الملف هو ما تقارن به عملية سحب لاحقة لترك الملفات التي لم يتغير كيانها دون مساس، ولحذف ملف كيان لم يعد موجودًا في مساحة العمل. إن checkout من دونه يكتب كل شيء ببساطة ولا يحذف شيئًا.## سلّم الاستعادةdiff --git a/packages/twenty-docs/es/developers/extend/apps/config/application.mdx b/packages/twenty-docs/es/developers/extend/apps/config/application.mdxindex e6b1d07e9ff..1062998aa58 100644--- a/packages/twenty-docs/es/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/config/application.mdx@@ -55,7 +55,7 @@ Notas:* Una aplicación puede informar de su propio estado de configuración con [`defineHealthCheck()`](/es/developers/extend/apps/logic/logic-functions#health-check), para aquello que solo la aplicación puede saber: una clave que está presente pero revocada, una cuenta de terceros con el plan incorrecto. `isRequired` cubre lo que Twenty puede ver por sí mismo; la comprobación de estado cubre el resto.* Ambos tipos de variable aceptan `isRequired: true`. Una variable obligatoria que el espacio de trabajo aún no ha rellenado deja la aplicación sin configurar: su página de configuración muestra un banner que indica las variables que faltan, con un botón que salta a la pestaña donde se configuran. Marca como obligatorio solo lo que la aplicación realmente no puede ejecutar sin ello; una variable opcional con un valor predeterminado razonable debe seguir siendo opcional.* Ambos tipos de variable aceptan `isDeprecated: true`. Úsala para retirar una variable en lugar de eliminarla: mantener la clave declarada conserva el valor almacenado (eliminarla destruye el valor que el operador introdujo), y la variable sigue siendo inyectada, por lo que tu código puede recurrir a ella — `process.env.NEW_API_KEY ?? process.env.API_KEY`. Una variable obsoleta desaparece de la configuración de la app una vez que no tiene ningún valor y nunca cuenta para la verificación de configuración de la app, por lo que `isDeprecated` tiene prioridad sobre `isRequired`.-* Twenty asigna estos nombres para cada ejecución de función lógica, por lo que están reservados: `TWENTY_API_URL`, `TWENTY_APP_ACCESS_TOKEN`, `TWENTY_APP_APPLICATION_ACCESS_TOKEN`, `TWENTY_API_KEY`, `TWENTY_FUNCTIONS_URL` y `APPLICATION_ID`. Un manifiesto que declare uno de ellos como una variable de aplicación o de servidor se rechaza cuando la aplicación se sincroniza o se publica.+* Twenty establece estos nombres para cada ejecución de función lógica, por lo que están reservados: `TWENTY_API_URL`, `TWENTY_APP_ACCESS_TOKEN`, `TWENTY_APP_APPLICATION_ACCESS_TOKEN`, `TWENTY_API_KEY`, `TWENTY_FUNCTIONS_URL`, `TWENTY_SERVER_ROUTES_URL` y `APPLICATION_ID`. También se reserva cualquier otro nombre que comience con `TWENTY_`, para las variables que Twenty agregue más adelante. Un manifiesto que declara un nombre reservado como variable de aplicación o servidor se rechaza cuando la aplicación se sincroniza o publica.* Para añadir tus propias entradas al menú de configuración de la aplicación (en lugar de la página **Variables** generada), declara un componente de frontend y apunta un [`defineSettingsMenuItem()`](/es/developers/extend/apps/layout/front-components#settings-menu-items) a él, en su propio archivo. Declara tantos como necesites y ordénalos con `position`; `scope` coloca un elemento en la configuración del espacio de trabajo o en la configuración propia de cada miembro. El elemento **General** administrado por el sistema (actualización automática, URL de la app, conexiones) siempre aparece primero, y la URL de la app solo se muestra cuando la app tiene funciones activadas mediante HTTP.## Capacidades multimedia solicitadas@@ -191,7 +191,7 @@ Los valores son cadenas, en el mismo formato que `process.env` (consulta [Tipos`updateMyUserApplicationVariable` guarda el valor propio de un miembro. Toma el `applicationUniversalIdentifier` de tu aplicación y escribe el valor de la persona detrás del token: la propia sesión del miembro o el token de tu aplicación cuando hay un miembro detrás de él, como en un componente frontal o una función lógica ejecutada para un miembro. El token de tu aplicación solo puede nombrar tu propia aplicación, y se rechaza un token sin nadie detrás de él, como en una tarea cron o un hook de instalación. Un valor vacío elimina el valor propio del miembro, por lo que vuelve a leer el valor predeterminado o una cadena vacía para una variable que no tiene uno.-No necesita permiso `APPLICATIONS`, pero necesita `CONNECTED_ACCOUNTS`: en el rol del miembro y, cuando el token de tu aplicación realiza la llamada, también en el rol predeterminado de tu aplicación, si declara uno. Si tu aplicación guarda variables de usuario, añade `SystemPermissionFlag.CONNECTED_ACCOUNTS` a `permissionFlagUniversalIdentifiers` en su [rol](/es/developers/extend/apps/config/roles).+No necesita el permiso Aplicaciones del espacio de trabajo, pero sí necesita Aplicaciones de usuario: en el rol del miembro y, cuando el token de tu aplicación realiza la llamada, también en el rol predeterminado de tu aplicación, si declara uno. Si tu aplicación guarda variables de usuario, añade `SystemPermissionFlag.USER_APPS` a `permissionFlagUniversalIdentifiers` en su [rol](/es/developers/extend/apps/config/roles).## Rol de función predeterminadodiff --git a/packages/twenty-docs/es/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/es/developers/extend/apps/config/roles.mdxindex 0d050b0b44b..b5a9cac76b0 100644--- a/packages/twenty-docs/es/developers/extend/apps/config/roles.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/config/roles.mdx@@ -50,10 +50,20 @@ export default defineRole({canUpdateFieldValue: false,},],- permissionFlagUniversalIdentifiers: [SystemPermissionFlag.APPLICATIONS],+ permissionFlagUniversalIdentifiers: [SystemPermissionFlag.WORKSPACE_APPS],});```+<Note>+ `SystemPermissionFlag.USER_APPS` y `SystemPermissionFlag.WORKSPACE_APPS`+ están disponibles a partir de `twenty-sdk` 2.54; las versiones anteriores los denominan+ `CONNECTED_ACCOUNTS` y `APPLICATIONS`. Los nombres antiguos son alias obsoletos+ para los mismos indicadores, y un rol conserva cada indicador una sola vez. La enumeración de+ `SystemPermissionFlag`, por ejemplo con `Object.keys`, sigue mostrando los nombres+ antiguos. La API también informa de estos indicadores con sus claves antiguas, por ejemplo en+ `currentUserWorkspace.permissionFlags`.+</Note>+## Seguridad a nivel de filaLos permisos a nivel de fila requieren el **plan Organization o superior** — consultadiff --git a/packages/twenty-docs/es/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/es/developers/extend/apps/data/objects.mdxindex 768a463d305..b71b555a17b 100644--- a/packages/twenty-docs/es/developers/extend/apps/data/objects.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/data/objects.mdx@@ -109,6 +109,7 @@ export default defineObject({* `isLabelSyncedWithName`, en un objeto o en un campo, mantiene el nombre de la API sincronizado con la etiqueta cuando esta se edita en Configuración. De forma predeterminada es `false`, por lo que una etiqueta renombrada deja el nombre sin cambios.* `isSearchable: true`, en un campo, incluye sus valores en la búsqueda de texto completo del objeto (búsqueda global y el menú de comandos). Requiere que el propio objeto permita búsquedas y que el tipo de campo sea compatible con texto. Un valor omitido significa que no permite búsquedas, excepto en el campo identificador de etiqueta del objeto, que siempre permite búsquedas y no se puede excluir. Cada sincronización aplica el estado declarado, por lo que un campo cuya opción de búsqueda se active desde Configuración se revertirá en la siguiente sincronización de tu aplicación, a menos que el manifiesto lo declare.* `isAuditLogged: false` en un campo evita que sus cambios aparezcan en la cronología del registro. De forma predeterminada es `true`, excepto en un campo `POSITION`, cuyos cambios aparecen en blanco en la cronología y nunca se registran. Establécelo en los campos que tu aplicación reescribe de forma programada, como una marca de tiempo del último contacto o una relación de acumulación, para que cada sincronización no agregue una fila de actividad a cada registro que modifique. Una actualización cuyo diferencial completo está compuesto por campos sin registro de auditoría no produce ninguna actividad en la cronología. Al igual que `isSearchable`, cada sincronización aplica el estado declarado.+* `disabledFieldPermissionActions`, en un campo, enumera los permisos de campo que no se pueden conceder en él: `'canReadFieldValue'`, `'canUpdateFieldValue'` o ambos, los mismos indicadores que un rol establece por campo. Los usuarios, las claves de API, los agentes y otras aplicaciones nunca obtienen estas acciones en el campo, independientemente de lo que conceda su rol, y guardar un permiso de campo que conceda una de ellas falla. Las funciones de lógica de tu propia aplicación las conservan. Por ejemplo, `['canUpdateFieldValue']` mantiene un valor que tu aplicación calcula o sincroniza, como un estado o una puntuación, en modo de solo lectura para todos los demás. También funciona en los campos que agregas a objetos que no te pertenecen con `defineField()`.* Los campos en línea definidos aquí **no** necesitan un `objectUniversalIdentifier`, ya que se hereda del objeto padre. Usa [`defineField()`](/es/developers/extend/apps/data/extending-objects) para añadir campos a objetos que no te pertenecen.* Puedes generar nuevos objetos con `twenty app add object`, que te guía en la asignación de nombres, los campos y las relaciones. Consulta [Arquitectura → Generación de entidades](/es/developers/extend/apps/getting-started/scaffolding).diff --git a/packages/twenty-docs/es/developers/extend/apps/getting-started/concepts.mdx b/packages/twenty-docs/es/developers/extend/apps/getting-started/concepts.mdxindex fe468dc263e..3efaf0052ae 100644--- a/packages/twenty-docs/es/developers/extend/apps/getting-started/concepts.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/getting-started/concepts.mdx@@ -22,6 +22,7 @@ your-app/│ ├── front-components/ ← defineFrontComponent│ ├── skills/ ← defineSkill│ ├── agents/ ← defineAgent+│ ├── mcp-servers/ ← defineMcpServer│ ├── views/ ← defineView│ ├── navigation-menu-items/ ← defineNavigationMenuItem│ ├── settings-menu-items/ ← defineSettingsMenuItem@@ -51,6 +52,7 @@ your-app/| **Flujo de trabajo** | Flujos de trabajo listos con un disparador y pasos | [Workflows](/es/developers/extend/apps/logic/workflows) || **Proveedor de conexión** | OAuth o inicio de sesión personalizado para cuentas de terceros | [Conexiones](/es/developers/extend/apps/logic/connections) || **Proveedor de mensajería** | Envía respuestas desde los canales de mensajería de una aplicación a través de una conexión | [Canales de mensajería](/es/developers/extend/apps/logic/messaging-channels#sending-replies) |+| **Servidor MCP** | Servidor MCP externo al que puede llamar la IA del espacio de trabajo | [Habilidades y agentes](/es/developers/extend/apps/logic/skills-and-agents) || **Vista** | Vistas de listas de registros preconfiguradas | [Vistas](/es/developers/extend/apps/layout/views) || **Elemento del menú de navegación** | Entradas personalizadas de la barra lateral | [Elementos del menú de navegación](/es/developers/extend/apps/layout/navigation-menu-items) || **Diseño de página** | Pestañas y widgets en la página de detalles de un registro | [Diseños de página](/es/developers/extend/apps/layout/page-layouts) |diff --git a/packages/twenty-docs/es/developers/extend/apps/layout/front-components.mdx b/packages/twenty-docs/es/developers/extend/apps/layout/front-components.mdxindex 01e0c7a4f20..a823d3e4e74 100644--- a/packages/twenty-docs/es/developers/extend/apps/layout/front-components.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/layout/front-components.mdx@@ -163,14 +163,14 @@ Declara tantos como necesites. El elemento propio **General** de Twenty — actu* **`USER`** — cada miembro lo configura para sí mismo, en su propia configuración de usuario.<Note>- Un elemento `USER` se muestra como una pestaña en la página de la app, en \*\*Configuración > Preferencias de la app- \*\*, donde solo lo ve el miembro que ha iniciado sesión y únicamente cuando su- rol concede el permiso `CONNECTED_ACCOUNTS`. Esa página todavía no está habilitada en+ Un elemento `USER` se muestra como una pestaña en la página de la aplicación en **Configuración > Preferencias+ de la aplicación**, donde solo lo ve el miembro que inició sesión y únicamente cuando su+ rol concede el permiso User Apps. Esa página todavía no está habilitada entodos los espacios de trabajo: donde no lo está, un elemento `USER` se conserva y sincroniza,pero no hay nada que lo muestre.</Note>-Un elemento `USER` se ejecuta como el miembro que lo visualiza. Para almacenar algo por persona, declara la variable con `scope: 'USER'`: `getApplicationVariable` devuelve el valor del miembro que está viendo la página, y tu componente lo guarda con `updateMyUserApplicationVariable`, que escribe únicamente el valor de ese miembro y necesita `SystemPermissionFlag.CONNECTED_ACCOUNTS` en el rol de tu app, si declara uno (consulta [Lectura y actualización de variables en tiempo de ejecución](#reading-and-updating-variables-at-runtime)). Al igual que un elemento `WORKSPACE`, un elemento `USER` reemplaza el formulario generado **Variables**, por lo que debe permitir que el miembro establezca todas las variables de usuario que necesita su aplicación. Una variable de espacio de trabajo contiene un valor compartido por todos, por lo que el guardado de un miembro sobrescribiría el de otro.+Un elemento `USER` se ejecuta como el miembro que lo visualiza. Para almacenar algo por persona, declara la variable con `scope: 'USER'`: `getApplicationVariable` devuelve el valor del miembro que está visualizando y tu componente lo guarda con `updateMyUserApplicationVariable`, que solo escribe el valor de ese miembro y necesita `SystemPermissionFlag.USER_APPS` en el rol de tu aplicación, si declara uno (consulta [Lectura y actualización de variables en tiempo de ejecución](#reading-and-updating-variables-at-runtime)). Al igual que un elemento `WORKSPACE`, un elemento `USER` reemplaza el formulario generado **Variables**, por lo que debe permitir que el miembro establezca todas las variables de usuario que necesita su aplicación. Una variable de espacio de trabajo contiene un valor compartido por todos, por lo que el guardado de un miembro sobrescribiría el de otro.<Note>`defineSettingsFrontComponent()` está obsoleta en favor de@@ -656,8 +656,8 @@ Notas:* El token de tu componente está vinculado a tu propia aplicación. `updateOneApplicationVariable` la selecciona como destino, por lo que `applicationId` es opcional y se rechaza nombrar otra aplicación. La lectura de las `applicationVariables` de otra aplicación se rechaza de la misma manera, y una aplicación que pertenece a otro espacio de trabajo se interpreta como no encontrada.* La clave debe ser una que tu aplicación declare en [`defineApplication()`](/es/developers/extend/apps/config/application). Escribir una clave que no está declarada se considera no encontrada.* Las variables secretas se leen enmascaradas, nunca como el valor almacenado. Escribirlas funciona normalmente.-* Leer el `value` de una variable y escribirlo requieren el permiso de configuración `APPLICATIONS` tanto en el rol de tu aplicación como en el rol de la persona que ha iniciado sesión, ya que el token del componente es la intersección de ambos. Añade `SystemPermissionFlag.APPLICATIONS` a `permissionFlagUniversalIdentifiers` en tu [rol de aplicación](/es/developers/extend/apps/config/roles).-* Una variable de usuario (`scope: 'USER'`) se inyecta con el valor del miembro que está viendo la página, a menos que sea secreta. `updateOneApplicationVariable` lo rechaza: guárdelo con `updateMyUserApplicationVariable`, como lo hace `saveMyLanguage` anteriormente. Escribe únicamente el valor del miembro que está viendo la página y no permite indicar otra aplicación. No necesita el permiso `APPLICATIONS`, pero necesita el permiso `CONNECTED_ACCOUNTS` en el rol del miembro que está viendo la página y en el rol de tu app, si declara uno: añade `SystemPermissionFlag.CONNECTED_ACCOUNTS` a `permissionFlagUniversalIdentifiers` en tu [rol de aplicación](/es/developers/extend/apps/config/roles). Consulte [Variables de espacio de trabajo y de usuario](/es/developers/extend/apps/config/application#workspace-and-user-variables).+* La lectura del `value` de una variable y su escritura requieren el permiso de configuración de Workspace Apps tanto en el rol de tu aplicación como en el rol de la persona que inició sesión, ya que el token del componente es la intersección de ambos. Añade `SystemPermissionFlag.WORKSPACE_APPS` a `permissionFlagUniversalIdentifiers` en tu [rol de aplicación](/es/developers/extend/apps/config/roles).+* Una variable de usuario (`scope: 'USER'`) se inyecta con el valor del miembro que está viendo la página, a menos que sea secreta. `updateOneApplicationVariable` lo rechaza: guárdelo con `updateMyUserApplicationVariable`, como lo hace `saveMyLanguage` anteriormente. Escribe únicamente el valor del miembro que está viendo la página y no permite indicar otra aplicación. No necesita permiso de Workspace Apps, pero necesita el permiso User Apps en el rol del miembro que está visualizando y en el rol de tu aplicación, si declara uno: añade `SystemPermissionFlag.USER_APPS` a `permissionFlagUniversalIdentifiers` en tu [rol de aplicación](/es/developers/extend/apps/config/roles). Consulte [Variables de espacio de trabajo y de usuario](/es/developers/extend/apps/config/application#workspace-and-user-variables).### Variables del sistema@@ -985,6 +985,8 @@ Los controles fundamentales se agrupan en `twenty-ui/primitives/\<family>`. LosUsa [`MainButton`](/es/ui/components/input/main-button) para acciones destacadas y [`LightButton`](/es/ui/components/input/light-button) para acciones ligeras. Usa `Button`, `Field`, `Input`, `Select` y otras primitivas de `twenty-ui/primitives/input` para controles y formularios fundamentales. Sigue las partes documentadas de cada control compuesto, como `Field.Root`, `Field.Label` y `Field.Description`.+Pasa `alignItemWithTrigger={false}` a `Select.Positioner`. Alinear el elemento seleccionado con el desencadenador, el valor predeterminado de Base UI, necesita mediciones de diseño síncronas que el entorno aislado no puede proporcionar, por lo que la ventana emergente se contrae al volver a abrirse.+Usa [`Dropdown`](/es/ui/components/navigation/dropdown) de `twenty-ui/components/navigation` para menús de acciones, selectores de opciones y paneles de formularios no modales. Usa `enqueueSnackbar` de `twenty-sdk/front-component` para las notificaciones del anfitrión.Las API independientes `Dialog` y `AlertDialog` también son exportadas por Twenty UI, pero se prohíbe su uso directo en los componentes de frontend. Use la [API de comunicación del host](#host-communication-api) para los cuadros de diálogo.@@ -1149,13 +1151,13 @@ Eventos de ratón, puntero, tacto, arrastre, teclado, foco, `input`/`change`/`suLos manejadores reciben eventos tipados creados a partir del evento de la página, `PointerEvent`, `MouseEvent`, `KeyboardEvent`, `InputEvent`, `WheelEvent` o `FocusEvent`, y esos constructores existen en el sandbox para `dispatchEvent()`. Cada evento reenviado también incluye la interfaz de eventos sintéticos de React (`nativeEvent`, `isDefaultPrevented()`, `isPropagationStopped()`, `persist()`), por lo que el código escrito para eventos de React sigue funcionando aunque el sandbox entregue el objeto de evento directamente a tu manejador.-Un evento de la página cruza cuando el elemento con el que interactuó el usuario, o uno de sus antecesores en tu componente, tiene un manejador para ese tipo de evento. Cruza una vez y luego se propaga dentro del sandbox como lo hace en la página: `event.target` es el elemento con el que interactuó el usuario, `currentTarget` es el elemento cuyo manejador se está ejecutando, `stopPropagation()` impide que se ejecuten los manejadores de los antecesores y `relatedTarget` apunta al elemento del sandbox desde o hacia el que se movieron el foco o el puntero, o es `null` cuando ese elemento está fuera de tu componente. Como en React, `onFocus` y `onBlur` también se ejecutan para cambios de foco dentro del elemento, y `onClickCapture` y los demás manejadores de captura se ejecutan durante la fase de captura.+Un evento de página cruza cuando el elemento con el que interactuó el usuario, o uno de sus antepasados en tu componente, tiene un controlador para ese tipo de evento, o cuando es una pulsación que esperan tus escuchadores de `document` (consulta más abajo). Cruza una vez y luego se propaga dentro del sandbox como lo hace en la página: `event.target` es el elemento con el que interactuó el usuario, `currentTarget` es el elemento cuyo manejador se está ejecutando, `stopPropagation()` impide que se ejecuten los manejadores de los antecesores y `relatedTarget` apunta al elemento del sandbox desde o hacia el que se movieron el foco o el puntero, o es `null` cuando ese elemento está fuera de tu componente. Como en React, `onFocus` y `onBlur` también se ejecutan para cambios de foco dentro del elemento, y `onClickCapture` y los demás manejadores de captura se ejecutan durante la fase de captura.Los manejadores que una biblioteca añade con `React.cloneElement`, como los que están detrás de la prop `render` de Base UI, se ejecutan después de los propios manejadores del elemento en lugar de reemplazarlos, por lo que pasar `onClick: undefined` a `cloneElement` no elimina el manejador del elemento. Un manejador en un elemento `render` de Base UI todavía puede llamar a `event.preventBaseUIHandler()` para omitir el propio manejador de Base UI.`event.target.value` y `checked` reflejan el control una vez que el navegador ha aplicado el cambio del usuario: en los manejadores `input`, `change`, `click`, `blur` y `focusout`, y en los manejadores `keyup` para `value`. En los manejadores `keydown`, `beforeinput` y de puntero, contienen el valor y el estado marcado del control a partir de su última edición, independientemente de lo que escuche tu componente: un manejador `Enter` lee el texto escrito hasta el momento, pero un manejador para una tecla imprimible aún no ve esa tecla, así que lee valores en tiempo real de una entrada controlada o de un manejador `onChange`.-Los listeners de `document` reciben los eventos que cruzan desde tu componente, pero nada de lo que ocurre en otra parte de la página, así que, para capturar atajos con `document.addEventListener('keydown', ...)`, coloca un `onKeyDown` en un elemento que envuelva tu componente. Los listeners de `window` solo reciben `error` y `unhandledrejection`. Los movimientos del puntero solo cruzan sobre elementos que tienen un manejador de movimiento, y la captura del puntero permanece en la página, por lo que un arrastre se detiene en cuanto el puntero sale de esos elementos. `event.preventDefault()` tampoco cruza; el envío de formularios, `dragover`/`drop` y los clics en enlaces ya están protegidos por ti.+Los escuchadores de `document` reciben los eventos que cruzan desde tu componente, con una excepción para las pulsaciones. Mientras tu componente escucha `pointerdown`, `pointerup`, `pointercancel`, `mousedown`, `mouseup` o `click` en `document`, como hace una ventana emergente abierta para cerrarse al pulsar fuera, cada pulsación llega a esos escuchadores: una pulsación dentro de tu componente se envía al elemento que pulsó el usuario incluso cuando nada la controla, y una pulsación en otra parte de la página se envía a `document.body` con el estado de sus botones, el número de clics y el tipo de puntero, pero sin coordenadas ni teclas modificadoras. Los clics sin una pulsación, como cuando el teclado activa un control fuera de tu componente, y las pulsaciones en las barras de desplazamiento de la página no se envían, y un gesto de deslizamiento táctil fuera de tu componente solo llega como `pointerdown` y `pointercancel`, por lo que no cierra una ventana emergente abierta. Nada más del resto de la página cruza, así que, para capturar atajos con `document.addEventListener('keydown', ...)`, coloca un `onKeyDown` en un elemento que envuelva tu componente. Los listeners de `window` solo reciben `error` y `unhandledrejection`. Los movimientos del puntero solo cruzan sobre elementos que tienen un manejador de movimiento, y la captura del puntero permanece en la página, por lo que un arrastre se detiene en cuanto el puntero sale de esos elementos. `event.preventDefault()` tampoco cruza; el envío de formularios, `dragover`/`drop` y los clics en enlaces ya están protegidos por ti.### Atributos y estilosdiff --git a/packages/twenty-docs/es/developers/extend/apps/logic/connections.mdx b/packages/twenty-docs/es/developers/extend/apps/logic/connections.mdxindex d42b81ce76d..f105a385f9d 100644--- a/packages/twenty-docs/es/developers/extend/apps/logic/connections.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/logic/connections.mdx@@ -508,7 +508,7 @@ Cada conexión tiene uno de dos ámbitos:El `scope` del proveedor determina cuál reciben sus nuevas conexiones:* `scope: 'WORKSPACE'` (el predeterminado) — la aplicación funciona con conexiones compartidas con el espacio de trabajo. **Agregar conexión** en la configuración del espacio de trabajo de la aplicación crea una conexión compartida con el espacio de trabajo.-* `scope: 'USER'` — cada miembro conecta su propia cuenta, creando conexiones personales. Los miembros las agregan, reconectan y eliminan desde la página de la app en **Configuración > Usuario > Preferencias de apps**, lo que requiere el permiso `CONNECTED_ACCOUNTS` (Apps de usuario). La configuración del espacio de trabajo de la aplicación no tiene un botón **Agregar conexión** para un proveedor `USER`.+* `scope: 'USER'` — cada miembro conecta su propia cuenta, creando conexiones personales. Los miembros las añaden, reconectan y eliminan desde la página de la aplicación en **Configuración > Usuario > Preferencias de aplicaciones**, lo que requiere el permiso Aplicaciones de usuario. La configuración del espacio de trabajo de la aplicación no tiene un botón **Agregar conexión** para un proveedor `USER`.<Note>**Preferencias de apps** aún no está habilitado en todos los espacios de trabajo: donde no lo está,@@ -520,7 +520,7 @@ Un proveedor tiene exactamente un ámbito. Si tu aplicación necesita tanto unaUna conexión siempre tiene el ámbito de su proveedor, y el ámbito de un proveedor forma parte de su identidad: una versión posterior no puede cambiar el `scope` de un proveedor existente, y la actualización se rechaza si lo intenta. Para mover un servicio de un ámbito a otro, declare un proveedor nuevo con un `universalIdentifier` nuevo y elimine el anterior. La actualización elimina entonces el proveedor anterior y todas las conexiones realizadas con él mediante la ruta de desconexión habitual (`onDisconnectLogicFunction`, revocación de tokens, limpieza de canales), y los miembros se conectan de nuevo mediante el proveedor nuevo.-Agregar o volver a conectar una conexión **Solo para mí** requiere el permiso `CONNECTED_ACCOUNTS`, y agregar o volver a conectar una conexión **Compartida con el espacio de trabajo** requiere el permiso `APPLICATIONS`.+Para añadir o reconectar una conexión **Solo para mí** se requiere el permiso Aplicaciones de usuario, y para añadir o reconectar una conexión **Compartida en el espacio de trabajo** se requiere el permiso Aplicaciones del espacio de trabajo.Usa la conexión adecuada para cada controlador:diff --git a/packages/twenty-docs/es/developers/extend/apps/logic/inbox.mdx b/packages/twenty-docs/es/developers/extend/apps/logic/inbox.mdxindex 5d4c1de7ca7..e4ca5c11547 100644--- a/packages/twenty-docs/es/developers/extend/apps/logic/inbox.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/logic/inbox.mdx@@ -92,4 +92,34 @@ await sendInboxMessage({* Una mención sólo renderiza. No añade al miembro a la conversación o notificarlos, así que lista a todos los que deberían recibir el mensaje en `workspaceMemberIds`.* `INBOX_ASSISTANT_MENTION` es el texto que el compositor escribe cuando un miembro menciona al asistente (`@Ada`), así que tus mensajes lo llaman de la misma manera.+## Asociar registros a una conversación++`attachRecordToInboxThread()` vincula una conversación a un registro y `detachRecordFromInboxThread()` elimina el vínculo.++```ts src/logic-functions/file-call-recap.ts+import {+ attachRecordToInboxThread,+ sendInboxMessage,+} from 'twenty-sdk/logic-function';++const { threadId } = await sendInboxMessage({+ workspaceMemberIds: [owner.id],+ threadKey: `call-recap-${call.id}`,+ idempotencyKey: `call-recap-${call.id}`,+ title: `Recap of ${call.title}`,+ text: call.summary,+});++await attachRecordToInboxThread({+ threadId,+ objectNameSingular: 'company',+ recordId: company.id,+});+```++* Ambos reciben el `threadId` de la conversación y el registro como `objectNameSingular` y `recordId`. Una conversación se puede vincular a personas, empresas, oportunidades y registros de objetos personalizados.+* Ambos son idempotentes: asociar un registro dos veces mantiene un solo vínculo y desasociar un registro que no está asociado no cambia nada.+* La llamada se ejecuta con el mismo acceso que [enviar un mensaje](#who-sends-the-message), lo que requiere el permiso `AI`. Un miembro debe poder editar la conversación, y tu aplicación puede actuar en una conversación que ella misma escribió o en una a la que se concedió su rol predeterminado; de lo contrario, la llamada falla con `THREAD_NOT_FOUND`.+* El registro debe poder leerse con ese acceso; de lo contrario, la llamada falla con `RECORD_NOT_FOUND`.+<PageBanner illustration="card-page-inbox" />diff --git a/packages/twenty-docs/es/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/es/developers/extend/apps/logic/logic-functions.mdxindex a58cfdd13ef..b17491c7a2c 100644--- a/packages/twenty-docs/es/developers/extend/apps/logic/logic-functions.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/logic/logic-functions.mdx@@ -294,28 +294,25 @@ export default defineLogicFunction({El endpoint es accesible en:```-POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionId+POST https://your-twenty-server.com/webhooks/server/:applicationRegistrationId/:resolverLogicFunctionUniversalIdentifier```-El identificador es el `id` del resolver: la clave principal que el servidor asigna cuando la aplicación se sincroniza por primera vez en el espacio de trabajo del propietario, no el `universalIdentifier` de tu manifiesto. Recupéralo de la API `/metadata` del espacio de trabajo del propietario y, a continuación, registra esa URL con el proveedor:+El primer segmento es el id del registro de tu aplicación; el segundo es el `universalIdentifier` del resolver de tu manifiesto. Una ruta solo se resuelve en un resolver de ese registro, en su espacio de trabajo propietario. Cuando tu aplicación registra el webhook en sí, crea la URL desde dentro de una función lógica con `getServerRouteUrl`; Twenty inyecta la URL base de las rutas de servidor de tu aplicación como `TWENTY_SERVER_ROUTES_URL`:-```graphql-query {- findManyLogicFunctions {- id- name- universalIdentifier- }-}+```ts+import { getServerRouteUrl } from 'twenty-sdk/utils';++const destinationUrl = getServerRouteUrl(+ INVOICE_PAID_RESOLVER_UNIVERSAL_IDENTIFIER,+);```<Note>- Por ahora, una URL que contiene el `universalIdentifier` del resolver sigue resolviendo,- y la respuesta incluye un encabezado `Deprecation`. Un `universalIdentifier` es- único por espacio de trabajo, no globalmente: si otro registro propiedad de un- espacio de trabajo diferente declara el mismo, la plataforma responde `404` para esa- URL en lugar de elegir entre ellos. Mueve las URL registradas con tus- proveedores al formato `id`.+ Las URL que solo contienen el `id` o el `universalIdentifier` del resolvedor+ (`/webhooks/server/:identifier`) aún se resuelven por ahora, y ambas responden con+ un encabezado `Deprecation`. La forma `universalIdentifier` devuelve `409` cuando dos+ registros declaran el mismo identificador. Traslade las URL registradas con sus+ proveedores al formulario de registro.</Note>**Responder a un `GET` de verificación.** Algunos proveedores verifican un punto de conexión antes de entregar contenido en él, enviando un `GET` con un desafío a la misma URL a la que más tarde enviarán eventos mediante `POST`; la API de WhatsApp Cloud de Meta es uno de ellos. Una ruta de servidor responde solo a `POST`, a menos que indiques lo contrario, así que declara ambos métodos:diff --git a/packages/twenty-docs/es/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/es/developers/extend/apps/logic/skills-and-agents.mdxindex 2107a3ea7c0..40f15c772eb 100644--- a/packages/twenty-docs/es/developers/extend/apps/logic/skills-and-agents.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/logic/skills-and-agents.mdx@@ -103,6 +103,39 @@ Notas sobre el esquema:* `required` (opcional) enumera las propiedades que el modelo siempre debe devolver.* `additionalProperties: false` (opcional) prohíbe cualquier propiedad que no esté declarada en `properties`.+</Accordion>+<Accordion title="defineMcpServer" description="Expón un servidor MCP externo a la IA del espacio de trabajo (beta)">++<Warning>+ Los servidores MCP están en beta y aún no están disponibles: puedes declararlos, pero los espacios de trabajo no pueden usar sus herramientas hasta que se lance la función.+</Warning>++Usa `defineMcpServer()` para incluir un servidor MCP remoto (HTTP transmisible) con tu aplicación, para que la IA del espacio de trabajo pueda usar sus herramientas sin sincronizar esos datos con Twenty:++```ts src/mcp-servers/github.ts+import { defineMcpServer } from 'twenty-sdk/define';++import { GITHUB_CONNECTION_PROVIDER_UNIVERSAL_IDENTIFIER } from 'src/constants/universal-identifiers';++export default defineMcpServer({+ universalIdentifier: '0b6c4f7e-3d5a-4a8e-9a0d-6f1e2c3b4a01',+ name: 'github',+ label: 'GitHub',+ url: 'https://api.githubcopilot.com/mcp/',+ connectionProvider: {+ universalIdentifier: GITHUB_CONNECTION_PROVIDER_UNIVERSAL_IDENTIFIER,+ },+});+```++Puntos clave:+* `name` está en snake_case (letras minúsculas, dígitos y guiones bajos, comienza con una letra y tiene como máximo 32 caracteres) y es único en el espacio de trabajo. Sirve de prefijo para los nombres de las herramientas del servidor.+* `url` debe ser una URL HTTP o HTTPS.+* `connectionProvider` (opcional) hace referencia a un [proveedor de conexión](/es/developers/extend/apps/logic/connections) declarado por la misma aplicación. Las llamadas envían el token de acceso de esa conexión como un token Bearer. Omítelo para un servidor público.+* La URL no puede cambiar en una versión posterior mientras haya un proveedor de conexión vinculado, por lo que los tokens nunca se envían a otro host.+* Los espacios de trabajo pueden desactivar el servidor; una versión posterior de la aplicación conserva esa elección.+* Requiere `"engines": { "twenty": ">=2.53.0" }`.+</Accordion><Accordion title="runAgent" description="Ejecutar un agente desde una función de lógica">diff --git a/packages/twenty-docs/es/developers/extend/apps/logic/workflows.mdx b/packages/twenty-docs/es/developers/extend/apps/logic/workflows.mdxindex e77380e96e3..c69fb991c70 100644--- a/packages/twenty-docs/es/developers/extend/apps/logic/workflows.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/logic/workflows.mdx@@ -68,7 +68,7 @@ export default defineWorkflow({Puntos clave:-* El flujo de trabajo, su desencadenador y cada paso necesitan su propio `universalIdentifier`. Mantenlos estables entre versiones: así es como Twenty encuentra el flujo de trabajo instalado en la próxima instalación.+* El flujo de trabajo y cada paso necesitan su propio `universalIdentifier`, y el desencadenador puede tener uno. Mantenlos estables entre versiones: así es como Twenty encuentra el flujo de trabajo instalado en la próxima instalación.* `nextStepIds` conecta el grafo. El desencadenador apunta a los primeros pasos, y cada paso apunta a los pasos que se ejecutan después de él.* Un paso lee la salida anterior con `{{trigger.\<path>}}` o `{{\<step universalIdentifier>.\<path>}}`.* La compilación valida toda la definición: los tipos de desencadenador o de paso no compatibles, los enlaces de pasos rotos y las referencias a pasos desconocidos hacen que falle.@@ -95,6 +95,8 @@ Una referencia que Twenty no puede resolver hace que falle la instalación.Un flujo de trabajo manual sin `availability` no obtiene ninguna entrada en el menú de comandos.+Cada desencadenador también acepta `name`, `position` y `outputSchema` opcionales, que solo determinan el aspecto del flujo de trabajo en el constructor. Sin ellos, Twenty usa un nombre como `Manual trigger`, coloca el desencadenador en la parte superior del lienzo y calcula el esquema de salida a partir de la configuración.+Un flujo de trabajo de webhook escucha en `https://\<your-twenty-domain>/webhooks/workflows/\<workspaceId>/\<workflowId>`, donde `workflowId` es el id del flujo de trabajo instalado. El cuerpo de la solicitud está disponible como `{{trigger.\<path>}}`.## Pasos@@ -126,7 +128,8 @@ Sus entradas coinciden con los pasos del [generador de flujos de trabajo](/es/usLa aplicación personalizada del espacio de trabajo posee los flujos de trabajo creados en el generador de flujos de trabajo, y el código es tan autoritativo para ellos como el generador:-* `twenty app pull` escribe cada uno desde su versión activa, la que el generador publicó por última vez. Se informa de un flujo de trabajo cuya versión activa usa configuraciones que un archivo `defineWorkflow()` no puede expresar, como un paso de Code o un desencadenador que el generador renombró, y se deja en su lugar.+* `twenty app pull` escribe cada uno desde su versión activa, la que el generador publicó por última vez. Se informa sobre un flujo de trabajo cuya versión activa utiliza configuraciones que un archivo `defineWorkflow()` no puede expresar, como un paso de código, y se deja en su lugar.+* Un flujo de trabajo extraído conserva lo que almacenó el constructor: un desencadenador sin `universalIdentifier`, el nombre del desencadenador en el constructor, una `position` de `null` para un nodo que el constructor nunca colocó y un `outputSchema` que difiere del calculado. Estos campos requieren twenty-sdk 2.53.0 o posterior, aplicado a un servidor con la versión 2.53.0 o posterior: las versiones anteriores los rechazan como claves desconocidas.* `twenty app apply` publica como el generador. Un flujo de trabajo cuya definición coincide con su versión activa se deja sin cambios. De lo contrario, la versión activa se archiva y la definición se convierte en una nueva versión activa, por lo que las ejecuciones anteriores conservan la versión que ejecutaron.* Los usuarios siguen editando estos flujos de trabajo en el constructor, y la siguiente extracción recupera sus cambios.diff --git a/packages/twenty-docs/es/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/es/developers/extend/apps/operations/cli.mdxindex e7f0bca6a79..1dfc6fc5580 100644--- a/packages/twenty-docs/es/developers/extend/apps/operations/cli.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/operations/cli.mdx@@ -103,18 +103,18 @@ npx twenty@latest app devOtros comandos de la aplicación:-| Comando | Qué hace |-| ----------------------------- | ------------------------------------------------------------------------------------ |-| `app add` | Genera la estructura de un objeto, campo, función de lógica u otra entidad |-| `app build` / `app typecheck` | Compila o verifica los tipos de la aplicación localmente |-| `app plan` | Obtén una vista previa de los cambios de metadatos que realizaría una aplicación |-| `app apply` | Compila, carga y sincroniza la aplicación |-| `app generate-client` | Regenera el cliente de API tipado sin sincronizar |-| `app pull` | Escribe los metadatos de la aplicación instalada de vuelta en el código fuente local |-| `app translations extract` | Extraer cadenas traducibles en catálogos de `locales/` |-| `app publish` | Publica la aplicación en npm o en un registro privado de Twenty |-| `app install` | Instala un paquete de aplicación ya registrado en el espacio de trabajo |-| `app uninstall` | Elimina la aplicación y todo lo que posee del espacio de trabajo |+| Comando | Qué hace |+| ----------------------------- | -------------------------------------------------------------------------------- |+| `app add` | Genera la estructura de un objeto, campo, función de lógica u otra entidad |+| `app build` / `app typecheck` | Compila o verifica los tipos de la aplicación localmente |+| `app plan` | Obtén una vista previa de los cambios de metadatos que realizaría una aplicación |+| `app apply` | Compila, carga y sincroniza la aplicación |+| `app generate-client` | Regenera el cliente de API tipado sin sincronizar |+| `app pull` | Restaurar metadatos, traducciones y dependencias almacenadas |+| `app translations extract` | Extraer cadenas traducibles en catálogos de `locales/` |+| `app publish` | Publica la aplicación en npm o en un registro privado de Twenty |+| `app install` | Instala un paquete de aplicación ya registrado en el espacio de trabajo |+| `app uninstall` | Elimina la aplicación y todo lo que posee del espacio de trabajo |Las definiciones que faltan en tu código fuente se eliminan del espacio de trabajo de forma predeterminada. Pasa `--no-prune` para conservarlos. La aplicación personalizada del espacio de trabajo los conserva a menos que pases `--prune`. Eliminar objetos o campos también elimina sus datos, por lo que requiere confirmación. Consulta [Sincronización y recuperación](/es/developers/extend/apps/operations/sync-and-recovery) para obtener más detalles.diff --git a/packages/twenty-docs/es/developers/extend/apps/operations/marketplace-review.mdx b/packages/twenty-docs/es/developers/extend/apps/operations/marketplace-review.mdxindex dcf3387c526..0fe1341a4be 100644--- a/packages/twenty-docs/es/developers/extend/apps/operations/marketplace-review.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/operations/marketplace-review.mdx@@ -1,61 +1,42 @@----title: Evaluación del Marketplace (en curso)-description: Requisitos propuestos para que las aplicaciones de terceros reciban una insignia de Verificada.+title: Revisión del Marketplace+description: Requisitos de seguridad y calidad que todas las aplicaciones deben cumplir para aparecer en el marketplace.---import { PageBanner } from "/snippets/page-banner.mdx"-## Cómo funciona el veterinario+## Cómo funciona la revisión-<Warning>- **Trabajo en curso.** Esta página y sus requisitos pueden evolucionar. La evaluación de terceros- aún no está disponible. Consulta- [Publicación](/es/developers/extend/apps/operations/publishing#marketplace-visibility-and-review)- para conocer el comportamiento actual del marketplace.-</Warning>+Todas las aplicaciones incluidas en el marketplace han superado la revisión de seguridad y calidad de Twenty. Publicar en npm no incluye una aplicación por sí solo: permanece sin incluir hasta que se complete la revisión. Consulta+[Publicación](/es/developers/extend/apps/operations/publishing#marketplace-visibility-and-review)+para saber cómo funciona la inclusión.-La evaluación se aplica a una versión y un paquete exactos de la aplicación. Cada actualización necesita revisión y-aprobación de Twenty. Las aplicaciones evaluadas pueden volver a evaluarse a medida que las dependencias o los servicios-evolucionen.+Las aplicaciones incluidas pueden reevaluarse a medida que evolucionen ellas, sus dependencias o los servicios de los que dependen, y pueden dejar de incluirse si dejan de cumplir la lista de verificación.-## Lista de verificación de evaluación+## Lista de verificación de la revisión-Todos los elementos aplicables deben aprobarse. Recomendamos usar un agente para autoevaluar-cada criterio con pruebas y las correcciones necesarias antes de enviarlo.+Todos los elementos aplicables deben aprobarse. Recomendamos usar un agente para autoevaluar cada criterio con pruebas y las correcciones necesarias antes de enviar la solicitud.* [ ] **Editor.** [Reclama tu aplicación](/es/developers/extend/apps/operations/publishing#claiming-your-app)y [publica con procedencia](/es/developers/extend/apps/operations/publishing#ci-publishing).-* [ ] **Seguridad.** Supera la revisión de seguridad interna de Twenty y resuelve los- hallazgos bloqueantes.-* [ ] **Permisos.** Solicita solo los+* [ ] **Seguridad.** Supera la revisión interna de seguridad de Twenty y resuelve los hallazgos que bloquean la publicación.+* [ ] **Permisos.** Solicita únicamente los[permisos](/es/developers/extend/apps/config/roles) necesarios para las funciones de la aplicación.-* [ ] **Funcionalidad.** La configuración y los flujos de trabajo principales son fáciles de seguir y funcionan como- se anuncia, sin bloqueos, trabajo perdido ni registros duplicados. Sin funciones de marcador de posición- ni controles defectuosos.-* [ ] **Rendimiento.** Respeta los límites de frecuencia compartidos de API y trabajos, controla la limitación de solicitudes y- sigue las+* [ ] **Funcionalidad.** La configuración y los flujos de trabajo principales son fáciles de seguir y funcionan como se anuncia, sin fallos, pérdida de trabajo ni registros duplicados. No debe haber funciones de marcador de posición ni controles que no funcionen.+* [ ] **Rendimiento.** Respeta los límites de frecuencia compartidos de API/tareas, gestiona la limitación de velocidad y sigue las[buenas prácticas de desarrollo de aplicaciones](/es/developers/extend/apps/getting-started/good-practices).-* [ ] **Utilidad.** Completa una tarea significativa de CRM para un público más amplio que- la configuración de un solo cliente. Los conectores pequeños y las automatizaciones sin interfaz cumplen los requisitos.+* [ ] **Utilidad.** Completa una tarea de CRM significativa para un público más amplio que la configuración de un solo cliente. Los conectores pequeños y las automatizaciones sin interfaz cumplen los requisitos.* [ ] **Experiencia nativa.** Reutiliza objetos, vistas y flujos de trabajo nativos cuando corresponda.- Si la aplicación tiene una UI, usa+ Si la aplicación tiene una interfaz de usuario, usa[`twenty-ui`](/es/developers/extend/apps/layout/front-components#using-twenty-ui-components)- y ajusta los diseños, las interacciones y las convenciones de accesibilidad de Twenty.-* [ ] **Privacidad.** Explica qué datos salen del espacio de trabajo, adónde van y por qué,- incluidos los proveedores de IA, cuánto tiempo se conservan y cómo se pueden eliminar.-* [ ] **Mantenimiento y compatibilidad.** Declara las versiones compatibles de Twenty, mantén estables los- identificadores de entidad y corrige los errores críticos y las integraciones defectuosas con el- tiempo.-* [ ] **Logotipo y galería.** Proporciona un logotipo original y reconocible e imágenes- pulidas de la aplicación real. Sigue las+ y adapta los diseños, las interacciones y las convenciones de accesibilidad de Twenty.+* [ ] **Privacidad.** Explica qué datos salen del espacio de trabajo, adónde van y por qué, incluidos los proveedores de IA, durante cuánto tiempo se conservan y cómo se pueden eliminar.+* [ ] **Mantenimiento y compatibilidad.** Declara las versiones compatibles de Twenty, mantén estables los identificadores de entidad y corrige con el tiempo los errores críticos y las integraciones que no funcionen.+* [ ] **Logotipo y galería.** Proporciona un logotipo original y reconocible, e imágenes pulidas de la aplicación real. Sigue las[directrices de imágenes](/es/developers/extend/apps/operations/publishing#marketplace-metadata).-* [ ] **Listado y README.** Describe con precisión las funciones y afiliaciones en- el nombre, la descripción y las capturas de pantalla. Mantén el README breve, bien formateado- y centrado en el valor de la aplicación.-* [ ] **Precios.** Indica claramente si la aplicación es gratuita o de pago, los precios de los planes,- la frecuencia de facturación y los servicios de terceros de pago necesarios.-* [ ] **Documentación y soporte.** Proporciona instrucciones de configuración, un ejemplo funcional- y un contacto de soporte. Si usas rutas compartidas, completa la+* [ ] **Ficha y README.** Describe con precisión las funciones y las afiliaciones en el nombre, la descripción y las capturas de pantalla. Mantén el README breve, bien formateado y centrado en el valor de la aplicación.+* [ ] **Precios.** Indica claramente si la aplicación es gratuita o de pago, los precios de los planes, la frecuencia de facturación y los servicios de terceros de pago necesarios.+* [ ] **Documentación y soporte.** Proporciona instrucciones de configuración, un ejemplo funcional y un contacto de soporte. Si utilizas rutas compartidas, completa la[configuración](/es/developers/extend/apps/operations/publishing#setting-up-server-routes)y verifica que los eventos lleguen al espacio de trabajo correcto.diff --git a/packages/twenty-docs/es/developers/extend/apps/operations/overview.mdx b/packages/twenty-docs/es/developers/extend/apps/operations/overview.mdxindex 96cfda8096a..d1152027fcd 100644--- a/packages/twenty-docs/es/developers/extend/apps/operations/overview.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/operations/overview.mdx@@ -42,8 +42,8 @@ La **capa de operaciones** es todo lo que haces *a* tu aplicación en lugar de *Construir, desplegar un tarball, publicar en npm, instalar.</Card><Card href="/es/developers/extend/apps/operations/marketplace-review" img="/images/documentation/banner-icons-v2/permissions.svg">- <CardTitle>Vetting en el mercado (WIP)</CardTitle>- Comprobaciones de seguridad, calidad y operativas para versiones de aplicaciones de terceros.+ <CardTitle>Revisión del marketplace</CardTitle>+ Comprobaciones de seguridad, calidad y operativas que una aplicación debe superar para aparecer en la lista.</Card><Card href="/es/developers/extend/apps/operations/monitoring" img="/images/user-guide/halftone/card-page-monitoring.svg"><CardTitle>monitoreando</CardTitle>diff --git a/packages/twenty-docs/es/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/es/developers/extend/apps/operations/publishing.mdxindex 010eae2275a..7d7ad35b451 100644--- a/packages/twenty-docs/es/developers/extend/apps/operations/publishing.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/operations/publishing.mdx@@ -223,7 +223,7 @@ Los flujos de trabajo `ci.yml` y `cd.yml` hacen referencia a acciones reutilizab## Publicación en npm-Publicarla en npm hace que tu aplicación sea apta para el marketplace de Twenty. Después de la sincronización del catálogo y de cualquier [configuración de rutas de servidor](#setting-up-server-routes) necesaria, los espacios de trabajo pueden explorarla, instalarla y actualizarla desde la interfaz de usuario. Las aplicaciones de la comunidad aparecen cuando los usuarios desactivan el filtro **Solo verificadas**.+Publicarla en npm hace que tu aplicación sea apta para el marketplace de Twenty. Tras la sincronización del catálogo y cualquier [configuración de rutas del servidor](#setting-up-server-routes) necesaria, los espacios de trabajo pueden buscarla, instalarla y actualizarla desde la interfaz de usuario una vez que supere la [revisión del marketplace](/es/developers/extend/apps/operations/marketplace-review).### Requisitos@@ -372,17 +372,13 @@ Si tienes problemas para reclamar tu aplicación, contáctanos en [Discord](httpEsta configuración ya está gestionada por ti en Twenty Cloud.</Accordion>-## Visibilidad y verificación en el marketplace+## Visibilidad y revisión en Marketplace-La reclamación establece la propiedad; no otorga una insignia de **Verificada**. El marketplace muestra **Solo verificadas** de forma predeterminada. Para encontrar aplicaciones de la comunidad, ve a **Configuración > Aplicaciones > Marketplace**, abre el filtro y desmarca **Solo verificadas**. También puedes compartir la página de instalación directa de tu aplicación mediante **Mis aplicaciones > tu aplicación > Distribución > Copiar enlace para compartir**.+Todas las aplicaciones incluidas en Marketplace han superado la revisión de seguridad y calidad de Twenty. Una aplicación recién publicada permanece sin listar hasta que supera la [revisión del marketplace](/es/developers/extend/apps/operations/marketplace-review); reclamarla establece la propiedad, pero no la incluye en la lista.-Actualmente, la etiqueta Verificada se aplica a las aplicaciones mantenidas por Twenty, cuya seguridad y calidad el equipo puede garantizar. Las aplicaciones de terceros se pueden publicar e instalar sin esta etiqueta.+Una aplicación sin listar aún se puede instalar. En **Configuración > Aplicaciones > Marketplace**, abre el filtro y activa **Mostrar aplicaciones sin listar**, o comparte la página de instalación directa de la aplicación mediante **Mis aplicaciones > tu aplicación > Distribución > Copiar enlace para compartir**. Los espacios de trabajo ven una advertencia de que la aplicación no ha sido revisada por Twenty.-La propuesta de [lista de verificación para la evaluación de marketplaces de terceros](/es/developers/extend/apps/operations/marketplace-review)-es un trabajo en curso. Describe criterios de revisión específicos de cada versión y pruebas,-no un programa de certificación disponible.--Si tu aplicación sigue sin aparecer con **Solo verificadas** desactivado, confirma que la sincronización del catálogo haya finalizado, que se hayan completado todas las variables de servidor requeridas y que se haya completado cualquier configuración de rutas de servidor.+Si tu aplicación está incluida en la lista pero aún no aparece en Marketplace, confirma que la sincronización del catálogo se haya completado, que se hayan rellenado todas las variables de servidor necesarias y que se haya completado cualquier configuración de rutas del servidor.## Instalar aplicacionesdiff --git a/packages/twenty-docs/es/developers/extend/apps/operations/sync-and-recovery.mdx b/packages/twenty-docs/es/developers/extend/apps/operations/sync-and-recovery.mdxindex 0c6061984a7..6a8217e5e4f 100644--- a/packages/twenty-docs/es/developers/extend/apps/operations/sync-and-recovery.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/operations/sync-and-recovery.mdx@@ -23,7 +23,7 @@ El desarrollo de aplicaciones locales gira en torno a la **sincronización**: la| Previsualizar cambios **sin aplicarlos** | `twenty app plan` | Calcula e imprime el diff; no escribe nada. || Sincroniza sin eliminar nada | `twenty app apply --no-prune` | Solo crea y actualiza: las entidades que existen en el espacio de trabajo, pero no en tu fuente, se dejan sin modificar. También lo aceptan `plan` y `dev`. || Depure la aplicación personalizada del espacio de trabajo | `twenty app apply --prune` | Esa aplicación conserva las entidades que faltan en el origen a menos que pase `--prune`. También lo aceptan `plan` y `dev`. |-| Regenerar la fuente local desde el espacio de trabajo | `twenty app pull` | **Experimental.** Escribe la aplicación instalada de nuevo en los archivos de definición. Consulta más abajo. |+| Regenerar la fuente local desde el espacio de trabajo | `twenty app pull` | **Experimental.** Restaura los archivos de definición, las traducciones y las dependencias almacenadas. Consulta más abajo. || Eliminar la aplicación del espacio de trabajo | `twenty app uninstall` | Agrega `--yes` para omitir la confirmación. || Enviar un tarball a un servidor | `twenty app publish --private` | Requiere una versión de `package.json` **estrictamente superior**; consulta [Publicación](/es/developers/extend/apps/operations/publishing). || Publicar en el marketplace (npm) | `twenty app publish` | — |@@ -108,17 +108,23 @@ Un plan:antes de ejecutarlo y revisa el diff.</Warning>-`twenty app pull` es lo contrario de `apply`: lee una aplicación del espacio de trabajo y la vuelve a escribir como archivos de definición.+`twenty app pull` es la operación inversa de `apply`: lee una aplicación desde el espacio de trabajo y restaura sus archivos de definición, traducciones y archivos de dependencias almacenados.```bash-twenty app pull --universal-identifier <universalIdentifier>+twenty app pull --remote dev+twenty app pull --path ./workspace-app --yes --no-input```-Pull necesita un proyecto existente — primero crea uno con `twenty app init` y, después, extrae en él. Sin `--universal-identifier`, pull se dirige a la aplicación que declara tu archivo local `defineApplication()`. Si `--universal-identifier` nombra una aplicación diferente de la que declara tu proyecto, pull se niega a hacerlo en lugar de dejar dos aplicaciones en un árbol: extrae esa en su propio directorio. Si el proyecto tiene un archivo de aplicación cuyo identificador no se puede leer, normalmente porque las dependencias no están instaladas, pull también se niega y te pide que ejecutes primero `yarn install`. Añade `--verbose` para ampliar las secciones de cobertura del informe, que entonces nombran hasta 20 identificadores por tipo de metadatos en lugar de solo los totales.+Dentro de una aplicación, pull lee su identificador local `defineApplication()` y recupera esa aplicación. Fuera de una aplicación, solicita un directorio y confirmación, crea un proyecto local para la aplicación personalizada del espacio de trabajo seleccionado, instala las dependencias con Yarn y luego extrae las definiciones. El nuevo proyecto incluye archivos de paquete y configuración, sin las entidades de demostración del inicializador.++Usa `--path` para seleccionar una aplicación existente o un directorio nuevo o vacío. La creación no interactiva requiere `--path` y `--yes`; pull se niega a sobrescribir un directorio no vacío no relacionado. Crear un proyecto no registra una aplicación ni cambia el espacio de trabajo. Un proyecto de SDK existente sin una definición de aplicación también extrae la aplicación personalizada. No existe la opción `--universal-identifier`.++Si falla la instalación de dependencias para un proyecto nuevo, se conserva la estructura base. Ejecuta `yarn install` dentro de ella y, luego, vuelve a intentar la extracción. Los proyectos existentes no instalan las dependencias automáticamente. Si no se puede leer su identificador de aplicación, la extracción informa de ese error en lugar de crear otra aplicación. Añade `--verbose` para ampliar las secciones de cobertura del informe, que entonces nombran hasta 20 identificadores por tipo de metadatos en lugar de solo los totales.**Qué escribe:*** la configuración de la aplicación;+* archivos de dependencias `package.json` y `yarn.lock` almacenados, en la raíz del proyecto;* objetos, con sus campos en línea;* campos que tu aplicación añadió a objetos que no posee;* índices creados;@@ -137,6 +143,10 @@ Pull necesita un proyecto existente — primero crea uno con `twenty app init` yCada entidad va al archivo que ya la define, por lo que una segunda extracción vuelve a escribir solo lo que cambió en el servidor. Un archivo también se vuelve a escribir cuando usa una función de definición distinta de la que escribiría pull; por ejemplo, un rol que se convirtió en el rol predeterminado o dejó de serlo. Las entidades nuevas se colocan junto a los archivos existentes de su tipo, y un nombre generado que coincidiría con un archivo no relacionado se califica en lugar de sobrescribirlo.+**Archivos de dependencias.** Cuando cambia el `package.json` o `yarn.lock` almacenado, pull reemplaza el archivo local e informa de cualquier edición local sobrescrita. Si el archivo remoto no ha cambiado desde el pull anterior, se conservan las ediciones locales. La ausencia de un archivo remoto no elimina su equivalente local. Cuando el paquete exportado omite `twenty-sdk`, como hace la aplicación Custom del espacio de trabajo, pull conserva la dependencia local del SDK para que los comandos de CLI aún puedan cargar el proyecto. Los archivos de dependencias, los metadatos y la base se escriben juntos y se revierten juntos si se produce un error de escritura.++Ejecuta `yarn install` después de obtener los cambios de dependencias. Pull no instala paquetes, ejecuta scripts de paquetes ni regenera el cliente tipado.+**Qué no escribe:*** **Aún no se exportan** — elementos del menú de comandos y del menú de configuración, funciones lógicas y componentes frontend, proveedores de conexión, variables de aplicación, recursos públicos, tipos de actividad de cronología y la fuente almacenada de tus funciones.@@ -145,15 +155,15 @@ Cada entidad va al archivo que ya la define, por lo que una segunda extracción* **Colocados en un diseño de página predeterminado o ajeno** — las pestañas y los widgets añadidos a un diseño de página predeterminado del motor, o a uno que pertenece a otra aplicación, se escriben como archivos independientes de `definePageLayoutTab()` y `definePageLayoutWidget()`, ya que se conoce el identificador al que se adjuntan.* **Widgets que la exportación aún no puede incluir** — en cualquier diseño, incluido el suyo, se informa de un widget del tipo obsoleto `VIEW`, un widget que muestra uno de los componentes de frontend o elementos del menú de comandos de su propia aplicación, o un widget sin posición para el modo de diseño de su pestaña, y el diseño o la pestaña se escribe sin él.* **Flujos de trabajo que la exportación aún no puede incluir** — se informa sobre un flujo de trabajo modificado en el generador de flujos de trabajo desde la última sincronización, un flujo de trabajo del sistema o privado, uno con un paso de Código o de mensaje de chat, que los flujos de trabajo de aplicaciones no admiten, y uno que llama a la acción de flujo de trabajo de otra aplicación, y se dejan en su lugar. La aplicación personalizada del espacio de trabajo es la excepción para el primer y el último caso: el generador también publica sus flujos de trabajo, y estos pueden llamar a las acciones de cualquier aplicación, por lo que se incorporan. En su lugar, se informa de uno de sus flujos de trabajo cuando no tiene una versión activa o cuando su versión activa utiliza configuraciones que una definición no puede expresar. Se extraen los pasos de correo electrónico y calendario: una cuenta compartida con el espacio de trabajo se escribe como su `connectedAccountHandle`, mientras que la cuenta privada de un miembro y las variables se conservan tal como están. En cambio, se informa sobre el flujo de trabajo cuando la cuenta de un paso está archivada, ya no puede ejecutar el paso o comparte su dirección con una cuenta más antigua, ya que aplicar el identificador seleccionaría otra cuenta.-* **Agentes y habilidades que la exportación aún no puede transportar**: se informa de una habilidad desactivada y de un agente con más de un rol o vinculado a una extracción de rol que no se escribe, y se dejan en su lugar.-* **Estado de tiempo de ejecución del espacio de trabajo** — asignaciones de roles de miembros y claves de API, webhooks, navegación por usuario y elementos de navegación fijados a un registro, todo excluido por diseño.+* **Agentes que la exportación aún no puede transportar** — se informa de un agente con más de un rol, o vinculado a un rol que la extracción no escribe, y se deja en su lugar.+* **El estado de ejecución del espacio de trabajo**, los adjuntos de registros, los adjuntos de correo electrónico, las asignaciones de roles de miembros y claves de API, los webhooks, la navegación por usuario y los elementos de navegación fijados a un registro, todo excluido por diseño, incluso para la aplicación Custom del espacio de trabajo.* **Propiedad de otra aplicación** — se informa de ello, pero nunca se extrae.El informe al final de una extracción enumera todo ello, agrupado por tipo y motivo. Todo lo que indique como no escrito sigue estando en su espacio de trabajo, así que vuelva a enviar un árbol extraído con `twenty app apply --no-prune` hasta que se cubran los tipos que faltan. La aplicación personalizada del espacio de trabajo ya se aplica de esta forma de manera predeterminada. Una aplicación con depuración (la predeterminada para otras aplicaciones, `--prune` para la aplicación personalizada) los eliminaría, y `twenty app plan` enumera exactamente cuáles.**Estado local del espacio de trabajo.** Una entidad desactivada en el espacio de trabajo se escribe como una definición activa, y las anulaciones que el espacio de trabajo realizó en una entidad, como una etiqueta renombrada, no se escriben. El informe enumera esas filas bajo "Escritas sin su estado local del espacio de trabajo". Aplicar el árbol de nuevo al mismo espacio de trabajo deja ese estado intacto; otro espacio de trabajo recibe la entidad activa y sin las anulaciones.-**El archivo base.** Pull registra lo que extrajo en `.twenty/pull-base.json`, que está ignorado por git y es específico de cada checkout. Ese archivo es con lo que una extracción posterior compara para dejar intactos los archivos cuya entidad no cambió y para eliminar el archivo de una entidad que ya no está en el espacio de trabajo. Un checkout sin él simplemente escribe todo y no elimina nada.+**El archivo base.** Pull registra lo que obtuvo en `.twenty/cli/pull-base.json`, que se ignora en git y es específico de cada copia de trabajo. Ese archivo es con lo que una extracción posterior compara para dejar intactos los archivos cuya entidad no cambió y para eliminar el archivo de una entidad que ya no está en el espacio de trabajo. Un checkout sin él simplemente escribe todo y no elimina nada.## Escalera de recuperacióndiff --git a/packages/twenty-docs/it/developers/extend/apps/config/application.mdx b/packages/twenty-docs/it/developers/extend/apps/config/application.mdxindex 683df673f3e..1e2b73a9824 100644--- a/packages/twenty-docs/it/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/config/application.mdx@@ -55,7 +55,7 @@ Note:* Un'app può segnalare il proprio stato di configurazione con [`defineHealthCheck()`](/it/developers/extend/apps/logic/logic-functions#health-check), per ciò che solo l'app può sapere — una chiave presente ma revocata, un account di terze parti con il piano errato. `isRequired` copre ciò che Twenty può vedere autonomamente; il controllo di integrità copre il resto.* Entrambi i tipi di variabile accettano `isRequired: true`. Una variabile obbligatoria che lo spazio di lavoro non ha ancora compilato lascia l'app non configurata: la relativa pagina delle impostazioni mostra un banner che indica le variabili mancanti, con un pulsante che porta alla scheda in cui sono impostate. Contrassegna come obbligatorio solo ciò senza cui l'app non può effettivamente funzionare: una variabile facoltativa con un valore predefinito sensato dovrebbe rimanere facoltativa.* Entrambi i tipi di variabile accettano `isDeprecated: true`. Usala per ritirare una variabile invece di eliminarla: mantenere la chiave dichiarata preserva il valore memorizzato (eliminandola si distrugge il valore inserito dall'operatore) e la variabile è ancora iniettata, così il tuo codice può ripiegare su di essa — `process.env.NEW_API_KEY ?? process.env.API_KEY`. Una variabile deprecata scompare dalle impostazioni dell'app non appena non ha più un valore e non viene mai conteggiata nel controllo di configurazione dell'app, quindi `isDeprecated` prevale su `isRequired`.-* Twenty imposta questi nomi per ogni esecuzione di funzione logica, quindi sono riservati: `TWENTY_API_URL`, `TWENTY_APP_ACCESS_TOKEN`, `TWENTY_APP_APPLICATION_ACCESS_TOKEN`, `TWENTY_API_KEY`, `TWENTY_FUNCTIONS_URL` e `APPLICATION_ID`. Un manifest che dichiara uno di essi come variabile dell'applicazione o del server viene rifiutato quando l'app viene sincronizzata o pubblicata.+* Twenty imposta questi nomi per ogni esecuzione di funzioni logiche, pertanto sono riservati: `TWENTY_API_URL`, `TWENTY_APP_ACCESS_TOKEN`, `TWENTY_APP_APPLICATION_ACCESS_TOKEN`, `TWENTY_API_KEY`, `TWENTY_FUNCTIONS_URL`, `TWENTY_SERVER_ROUTES_URL` e `APPLICATION_ID`. Anche ogni altro nome che inizia con `TWENTY_` è riservato, per le variabili che Twenty aggiunge in seguito. Un manifesto che dichiara un nome riservato come variabile dell'applicazione o del server viene rifiutato quando l'app viene sincronizzata o pubblicata.* Per aggiungere le tue voci al menu delle impostazioni dell'app (al posto della pagina **Variables** generata), dichiara un front component e configura un [`defineSettingsMenuItem()`](/it/developers/extend/apps/layout/front-components#settings-menu-items) affinché punti a esso, in un proprio file. Dichiarane quanti te ne servono e ordinali con `position`; `scope` colloca un elemento nelle impostazioni del workspace o nelle impostazioni personali di ciascun membro. L'elemento **Generale** gestito dal sistema (aggiornamento automatico, URL dell'app, connessioni) è sempre il primo e l'URL dell'app viene visualizzato solo quando l'app dispone di funzioni attivate da HTTP.## Funzionalità multimediali richieste@@ -191,7 +191,7 @@ I valori sono stringhe, nello stesso formato di `process.env` (consulta [Tipi di`updateMyUserApplicationVariable` salva il valore personale di un membro. Prende l'`applicationUniversalIdentifier` della tua app e scrive il valore della persona dietro al token: la sessione del membro stesso oppure il token della tua app quando dietro c'è un membro, ad esempio in un componente front-end o in una funzione logica eseguita per un membro. Il token della tua app può identificare solo la tua app e un token senza nessuna persona associata, ad esempio in un processo cron o in un hook di installazione, viene rifiutato. Un valore vuoto rimuove il valore proprio del membro, quindi viene letto nuovamente il valore predefinito oppure una stringa vuota per una variabile senza valore predefinito.-Non richiede l'autorizzazione `APPLICATIONS`, ma richiede `CONNECTED_ACCOUNTS`: nel ruolo del membro e, quando il token della tua app effettua la chiamata, anche nel ruolo predefinito della tua app, se ne dichiara uno. Se la tua app salva variabili utente, aggiungi `SystemPermissionFlag.CONNECTED_ACCOUNTS` a `permissionFlagUniversalIdentifiers` nel suo [ruolo](/it/developers/extend/apps/config/roles).+Non richiede l'autorizzazione Workspace Apps, ma richiede User Apps: nel ruolo del membro e, quando il token dell'app effettua la chiamata, anche nel ruolo predefinito dell'app, se ne dichiara uno. Se l'app salva variabili utente, aggiungi `SystemPermissionFlag.USER_APPS` a `permissionFlagUniversalIdentifiers` nel suo [ruolo](/it/developers/extend/apps/config/roles).## Ruolo funzione predefinitodiff --git a/packages/twenty-docs/it/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/it/developers/extend/apps/config/roles.mdxindex 9523acb248d..948be32b574 100644--- a/packages/twenty-docs/it/developers/extend/apps/config/roles.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/config/roles.mdx@@ -50,10 +50,20 @@ export default defineRole({canUpdateFieldValue: false,},],- permissionFlagUniversalIdentifiers: [SystemPermissionFlag.APPLICATIONS],+ permissionFlagUniversalIdentifiers: [SystemPermissionFlag.WORKSPACE_APPS],});```+<Note>+ `SystemPermissionFlag.USER_APPS` e `SystemPermissionFlag.WORKSPACE_APPS`+ sono disponibili in `twenty-sdk` dalla versione 2.54; le versioni precedenti li denominano+ `CONNECTED_ACCOUNTS` e `APPLICATIONS`. I vecchi nomi sono alias deprecati+ per gli stessi flag e un ruolo mantiene ogni flag una sola volta. L'enumerazione di+ `SystemPermissionFlag`, ad esempio con `Object.keys`, elenca ancora i vecchi+ nomi. L'API segnala inoltre questi flag con le loro vecchie chiavi, ad esempio in+ `currentUserWorkspace.permissionFlags`.+</Note>+## Sicurezza a livello di rigaLe autorizzazioni a livello di riga richiedono il **piano Organization o superiore** — consulta idiff --git a/packages/twenty-docs/it/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/it/developers/extend/apps/data/objects.mdxindex ce4296cc4af..842f1a1a253 100644--- a/packages/twenty-docs/it/developers/extend/apps/data/objects.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/data/objects.mdx@@ -109,6 +109,7 @@ export default defineObject({* `isLabelSyncedWithName`, su un oggetto o su un campo, mantiene il nome API sincronizzato con l'etichetta quando quest'ultima viene modificata in Impostazioni. Per impostazione predefinita è `false`, quindi un'etichetta rinominata lascia invariato il nome.* `isSearchable: true`, su un campo, include i relativi valori nella ricerca full-text dell'oggetto (ricerca globale e menu dei comandi). Richiede che l'oggetto stesso sia ricercabile e un tipo di campo compatibile con il testo. Un valore omesso indica che non è ricercabile, ad eccezione del campo identificatore dell'etichetta dell'oggetto, che è sempre ricercabile e non può essere escluso. Ogni sincronizzazione applica lo stato dichiarato, quindi un campo reso ricercabile da Impostazioni viene ripristinato alla successiva sincronizzazione dell'app, a meno che il manifest non lo dichiari.* `isAuditLogged: false`, su un campo, mantiene le relative modifiche fuori dalla cronologia del record. Per impostazione predefinita è `true`, tranne che su un campo `POSITION`, le cui modifiche vengono visualizzate vuote nella cronologia e non vengono mai registrate. Impostalo sui campi che la tua app riscrive periodicamente, ad esempio un timestamp dell'ultimo contatto o una relazione di rollup, in modo che ogni sincronizzazione non aggiunga una riga di attività a ogni record che modifica. Un aggiornamento la cui intera differenza è costituita da campi non registrati nell'audit non produce alcuna attività nella cronologia. Come `isSearchable`, ogni sincronizzazione applica lo stato dichiarato.+* `disabledFieldPermissionActions`, in un campo, elenca le autorizzazioni del campo che non possono esservi concesse: `'canReadFieldValue'`, `'canUpdateFieldValue'` o entrambe, gli stessi flag impostati da un ruolo per ciascun campo. Gli utenti, le chiavi API, gli agenti e le altre app non ottengono mai queste azioni sul campo, indipendentemente da ciò che concede il loro ruolo, e il salvataggio di un'autorizzazione del campo che ne concede una non riesce. Le funzioni della logica della tua app le mantengono. Ad esempio, `['canUpdateFieldValue']` mantiene in sola lettura per tutti gli altri un valore che la tua app calcola o sincronizza, come uno stato o un punteggio. Funziona anche sui campi che aggiungi a oggetti che non possiedi con `defineField()`.* I campi inline definiti qui **non** hanno bisogno di un `objectUniversalIdentifier` — viene ereditato dall'oggetto padre. Usa [`defineField()`](/it/developers/extend/apps/data/extending-objects) per aggiungere campi a oggetti che non possiedi.* Puoi generare nuovi oggetti con `twenty app add object`, che ti guida nella denominazione, nei campi e nelle relazioni. Vedi [Architettura → Scaffolding delle entità](/it/developers/extend/apps/getting-started/scaffolding).diff --git a/packages/twenty-docs/it/developers/extend/apps/getting-started/concepts.mdx b/packages/twenty-docs/it/developers/extend/apps/getting-started/concepts.mdxindex 8c4e8417e88..7cf0e1a2287 100644--- a/packages/twenty-docs/it/developers/extend/apps/getting-started/concepts.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/getting-started/concepts.mdx@@ -22,6 +22,7 @@ your-app/│ ├── front-components/ ← defineFrontComponent│ ├── skills/ ← defineSkill│ ├── agents/ ← defineAgent+│ ├── mcp-servers/ ← defineMcpServer│ ├── views/ ← defineView│ ├── navigation-menu-items/ ← defineNavigationMenuItem│ ├── settings-menu-items/ ← defineSettingsMenuItem@@ -51,6 +52,7 @@ your-app/| \*\*Flusso Di Lavoro | Flussi di lavoro pronti con un trigger e passi | [Workflows](/it/developers/extend/apps/logic/workflows) || **Provider di connessione** | OAuth o accesso personalizzato per account di terze parti | [Connessioni](/it/developers/extend/apps/logic/connections) || **Provider di messaggistica** | Invia risposte dai canali di messaggistica di un'app tramite una connessione | [Canali di messaggistica](/it/developers/extend/apps/logic/messaging-channels#sending-replies) |+| **Server MCP** | Server MCP esterno che l'IA dell'area di lavoro può chiamare | [Abilità e agenti](/it/developers/extend/apps/logic/skills-and-agents) || **Vista** | Viste di elenco dei record preconfigurate | [Viste](/it/developers/extend/apps/layout/views) || **Voce del menu di navigazione** | Voci della barra laterale personalizzate | [Voci del menu di navigazione](/it/developers/extend/apps/layout/navigation-menu-items) || **Layout di pagina** | Schede e widget nella pagina dei dettagli di un record | [Layout di pagina](/it/developers/extend/apps/layout/page-layouts) |diff --git a/packages/twenty-docs/it/developers/extend/apps/layout/front-components.mdx b/packages/twenty-docs/it/developers/extend/apps/layout/front-components.mdxindex dddc0588aaa..24e596ff098 100644--- a/packages/twenty-docs/it/developers/extend/apps/layout/front-components.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/layout/front-components.mdx@@ -164,13 +164,13 @@ Dichiarane quante te ne servono. La voce **Generale** di Twenty — aggiornament<Note>Un elemento `USER` viene visualizzato come scheda nella pagina dell'app in **Impostazioni > Preferenze- dell'app**, dove può vederlo solo il membro che ha effettuato l'accesso e solo quando il suo- ruolo concede l'autorizzazione `CONNECTED_ACCOUNTS`. Quella pagina non è ancora abilitata in+ app**, dove può vederlo solo il membro connesso e solo quando il suo+ ruolo concede l'autorizzazione App utente. Quella pagina non è ancora abilitata inogni spazio di lavoro: dove non lo è, un elemento `USER` viene mantenuto e sincronizzatoma non viene visualizzato da nulla.</Note>-Una voce `USER` viene eseguita come il membro che la visualizza. Per memorizzare qualcosa per persona, dichiara la variabile con `scope: 'USER'`: `getApplicationVariable` restituisce il valore del membro che sta visualizzando la pagina e il componente lo salva con `updateMyUserApplicationVariable`, che scrive solo il valore di quel membro e richiede `SystemPermissionFlag.CONNECTED_ACCOUNTS` nel ruolo della tua app, se ne dichiara uno (vedi [Lettura e aggiornamento delle variabili in fase di esecuzione](#reading-and-updating-variables-at-runtime)). Come un elemento `WORKSPACE`, un elemento `USER` sostituisce il modulo **Variabili** generato, quindi dovrebbe consentire al membro di impostare tutte le variabili utente necessarie all'app. Una variabile dello spazio di lavoro contiene un valore condiviso da tutti, quindi il salvataggio di un membro sovrascriverebbe quello di un altro.+Una voce `USER` viene eseguita come il membro che la visualizza. Per archiviare qualcosa per ogni persona, dichiara la variabile con `scope: 'USER'`: `getApplicationVariable` restituisce il valore del membro che visualizza la pagina e il tuo componente lo salva con `updateMyUserApplicationVariable`, che scrive solo il valore di quel membro e richiede `SystemPermissionFlag.USER_APPS` nel ruolo della tua app, se ne dichiara uno (vedi [Lettura e aggiornamento delle variabili in fase di esecuzione](#reading-and-updating-variables-at-runtime)). Come un elemento `WORKSPACE`, un elemento `USER` sostituisce il modulo **Variabili** generato, quindi dovrebbe consentire al membro di impostare tutte le variabili utente necessarie all'app. Una variabile dello spazio di lavoro contiene un valore condiviso da tutti, quindi il salvataggio di un membro sovrascriverebbe quello di un altro.<Note>`defineSettingsFrontComponent()` è deprecato a favore di@@ -658,8 +658,8 @@ Note:* Il token del componente è associato alla tua applicazione. `updateOneApplicationVariable` la interessa, quindi `applicationId` è facoltativo e specificare un'altra applicazione viene rifiutato. Anche la lettura delle `applicationVariables` di un'altra applicazione viene rifiutata allo stesso modo e un'applicazione appartenente a un altro workspace risulta non trovata.* La chiave deve essere una di quelle dichiarate dall'app in [`defineApplication()`](/it/developers/extend/apps/config/application). La scrittura di una chiave non dichiarata risulta non trovata.* Le variabili segrete, quando vengono lette, vengono mascherate e non restituiscono mai il valore memorizzato. La loro scrittura funziona normalmente.-* Per leggere il `value` di una variabile e scriverlo, è necessaria l'autorizzazione alle impostazioni `APPLICATIONS` sia per il ruolo della tua app sia per il ruolo della persona che ha effettuato l'accesso, poiché il token del componente è l'intersezione dei due. Aggiungi `SystemPermissionFlag.APPLICATIONS` a `permissionFlagUniversalIdentifiers` nel tuo [ruolo dell'applicazione](/it/developers/extend/apps/config/roles).-* Una variabile utente (`scope: 'USER'`) viene iniettata con il valore del membro che visualizza, a meno che non sia segreta. `updateOneApplicationVariable` la rifiuta: salvala con `updateMyUserApplicationVariable`, come fa `saveMyLanguage` sopra. Scrive solo il valore del membro che sta visualizzando la pagina e rifiuta di specificare un'altra applicazione. Non richiede alcuna autorizzazione `APPLICATIONS`, ma richiede l'autorizzazione `CONNECTED_ACCOUNTS` nel ruolo del membro che sta visualizzando la pagina e nel ruolo della tua app, se ne dichiara uno: aggiungi `SystemPermissionFlag.CONNECTED_ACCOUNTS` a `permissionFlagUniversalIdentifiers` nel tuo [ruolo dell'applicazione](/it/developers/extend/apps/config/roles). Vedi [Variabili dello spazio di lavoro e dell'utente](/it/developers/extend/apps/config/application#workspace-and-user-variables).+* La lettura del `value` di una variabile e la sua scrittura richiedono l'autorizzazione alle impostazioni App workspace sia nel ruolo della tua app sia nel ruolo della persona connessa, poiché il token del componente è l'intersezione dei due. Aggiungi `SystemPermissionFlag.WORKSPACE_APPS` a `permissionFlagUniversalIdentifiers` nel tuo [ruolo dell'applicazione](/it/developers/extend/apps/config/roles).+* Una variabile utente (`scope: 'USER'`) viene iniettata con il valore del membro che visualizza, a meno che non sia segreta. `updateOneApplicationVariable` la rifiuta: salvala con `updateMyUserApplicationVariable`, come fa `saveMyLanguage` sopra. Scrive solo il valore del membro che sta visualizzando la pagina e rifiuta di specificare un'altra applicazione. Non richiede alcuna autorizzazione App workspace, ma richiede l'autorizzazione App utente nel ruolo del membro che visualizza la pagina e nel ruolo della tua app, se ne dichiara uno: aggiungi `SystemPermissionFlag.USER_APPS` a `permissionFlagUniversalIdentifiers` nel tuo [ruolo dell'applicazione](/it/developers/extend/apps/config/roles). Vedi [Variabili dello spazio di lavoro e dell'utente](/it/developers/extend/apps/config/application#workspace-and-user-variables).### Variabili di sistema@@ -987,6 +987,8 @@ I controlli fondamentali sono raggruppati in `twenty-ui/primitives/\<family>`. LUsa [`MainButton`](/it/ui/components/input/main-button) per le azioni principali e [`LightButton`](/it/ui/components/input/light-button) per le azioni leggere. Usa `Button`, `Field`, `Input`, `Select` e altre primitive da `twenty-ui/primitives/input` per controlli e moduli di base. Segui le parti documentate di ciascun controllo composto, come `Field.Root`, `Field.Label` e `Field.Description`.+Passa `alignItemWithTrigger={false}` a `Select.Positioner`. L'allineamento dell'elemento selezionato con l'attivatore, impostazione predefinita di Base UI, richiede misurazioni sincrone del layout che il sandbox non può fornire, quindi il popup si comprime quando viene riaperto.+Usa [`Dropdown`](/it/ui/components/navigation/dropdown) da `twenty-ui/components/navigation` per menu di azioni, selettori di opzioni e pannelli di moduli non modali. Usa `enqueueSnackbar` da `twenty-sdk/front-component` per le notifiche dell'host.Le API autonome `Dialog` e `AlertDialog` sono anch'esse esportate da Twenty UI, ma l'uso diretto nei componenti front-end è vietato. Utilizza l'[API di comunicazione con l'host](#host-communication-api) per le finestre di dialogo.@@ -1151,13 +1153,13 @@ Mouse, puntatore, touch, drag, tastiera, focus, `input`/`change`/`submit`, `scroI gestori ricevono eventi tipizzati creati a partire dall'evento della pagina, `PointerEvent`, `MouseEvent`, `KeyboardEvent`, `InputEvent`, `WheelEvent` o `FocusEvent`, e questi costruttori sono presenti nel sandbox per `dispatchEvent()`. Ogni evento inoltrato include anche la superficie dell'evento sintetico di React (`nativeEvent`, `isDefaultPrevented()`, `isPropagationStopped()`, `persist()`), quindi il codice scritto per gli eventi React continua a funzionare anche se il sandbox passa direttamente al tuo gestore l'oggetto evento.-Un evento della pagina attraversa il confine quando l'elemento con cui l'utente ha interagito, o uno dei suoi antenati nel tuo componente, ha un gestore per quel tipo di evento. Attraversa il confine una sola volta e poi si propaga all'interno del sandbox come avviene nella pagina: `event.target` è l'elemento con cui l'utente ha interagito, `currentTarget` è l'elemento il cui gestore è in esecuzione, `stopPropagation()` impedisce l'esecuzione dei gestori degli antenati e `relatedTarget` punta all'elemento del sandbox da cui o verso cui si è spostato il focus o il puntatore, oppure è `null` quando tale elemento è esterno al tuo componente. Come in React, anche `onFocus` e `onBlur` vengono eseguiti per le modifiche del focus all'interno dell'elemento, mentre `onClickCapture` e gli altri gestori di cattura vengono eseguiti durante la fase di cattura.+Un evento della pagina attraversa quando l'elemento con cui l'utente ha interagito, o uno dei suoi elementi antenati nel tuo componente, ha un gestore per quel tipo di evento, oppure quando si tratta di una pressione che i tuoi listener di `document` stanno aspettando (vedi sotto). Attraversa il confine una sola volta e poi si propaga all'interno del sandbox come avviene nella pagina: `event.target` è l'elemento con cui l'utente ha interagito, `currentTarget` è l'elemento il cui gestore è in esecuzione, `stopPropagation()` impedisce l'esecuzione dei gestori degli antenati e `relatedTarget` punta all'elemento del sandbox da cui o verso cui si è spostato il focus o il puntatore, oppure è `null` quando tale elemento è esterno al tuo componente. Come in React, anche `onFocus` e `onBlur` vengono eseguiti per le modifiche del focus all'interno dell'elemento, mentre `onClickCapture` e gli altri gestori di cattura vengono eseguiti durante la fase di cattura.I gestori che una libreria aggiunge con `React.cloneElement`, come quelli associati alla prop `render` di Base UI, vengono eseguiti dopo i gestori dell'elemento stesso invece di sostituirli, quindi passare `onClick: undefined` a `cloneElement` non rimuove il gestore dell'elemento. Un gestore su un elemento `render` di Base UI può comunque chiamare `event.preventBaseUIHandler()` per ignorare il gestore di Base UI.`event.target.value` e `checked` riflettono il controllo una volta che il browser ha applicato la modifica dell'utente: nei gestori `input`, `change`, `click`, `blur` e `focusout`, e nei gestori `keyup` per `value`. Nei gestori `keydown`, `beforeinput` e del puntatore, contengono il valore e lo stato selezionato del controllo a partire dalla sua ultima modifica, indipendentemente da ciò che il tuo componente ascolta: un gestore `Enter` legge il testo digitato finora, ma un gestore per un tasto stampabile non vede ancora quel tasto; pertanto, leggi i valori in tempo reale da un input controllato o da un gestore `onChange`.-I listener `document` ricevono gli eventi che attraversano il confine dal tuo componente, ma non ciò che accade altrove nella pagina; quindi, per intercettare scorciatoie con `document.addEventListener('keydown', ...)`, inserisci un `onKeyDown` su un elemento che avvolge il tuo componente. I listener `window` ricevono solo `error` e `unhandledrejection`. Gli spostamenti del puntatore attraversano il confine solo sugli elementi che hanno un gestore di spostamento, e la cattura del puntatore rimane nella pagina; per questo motivo, un trascinamento si interrompe non appena il puntatore lascia tali elementi. `event.preventDefault()` non viene propagato nemmeno; l'invio dei form, `dragover`/`drop` e i clic sui link sono già protetti per te.+I listener di `document` ricevono gli eventi che attraversano dal tuo componente, con un'eccezione per le pressioni. Mentre il tuo componente rimane in ascolto di `pointerdown`, `pointerup`, `pointercancel`, `mousedown`, `mouseup` o `click` su `document`, come fa un popup aperto per chiudersi in caso di pressioni esterne, ogni pressione raggiunge tali listener: una pressione all'interno del tuo componente viene inviata all'elemento premuto dall'utente anche quando nulla la gestisce, e una pressione in un'altra parte della pagina viene inviata a `document.body` con lo stato del pulsante, il numero di clic e il tipo di puntatore, ma senza coordinate né tasti modificatori. I clic senza una pressione, come quando la tastiera attiva un controllo esterno al tuo componente, e le pressioni sulle barre di scorrimento della pagina non vengono inviati; inoltre, uno scorrimento con tocco esterno al tuo componente arriva solo come `pointerdown` e `pointercancel`, quindi non chiude un popup aperto. Nient'altro dal resto della pagina attraversa, quindi per intercettare le scorciatoie con `document.addEventListener('keydown', ...)`, inserisci un `onKeyDown` su un elemento che racchiude il tuo componente. I listener `window` ricevono solo `error` e `unhandledrejection`. Gli spostamenti del puntatore attraversano il confine solo sugli elementi che hanno un gestore di spostamento, e la cattura del puntatore rimane nella pagina; per questo motivo, un trascinamento si interrompe non appena il puntatore lascia tali elementi. `event.preventDefault()` non viene propagato nemmeno; l'invio dei form, `dragover`/`drop` e i clic sui link sono già protetti per te.### Attributi e stilediff --git a/packages/twenty-docs/it/developers/extend/apps/logic/connections.mdx b/packages/twenty-docs/it/developers/extend/apps/logic/connections.mdxindex 4c114c32ea0..44634971853 100644--- a/packages/twenty-docs/it/developers/extend/apps/logic/connections.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/logic/connections.mdx@@ -508,7 +508,7 @@ Ogni connessione ha uno di due ambiti:Il `scope` del provider stabilisce quale ambito riceveranno le sue nuove connessioni:* `scope: 'WORKSPACE'` (il valore predefinito) — l'app funziona con connessioni condivise con lo spazio di lavoro. **Aggiungi connessione** nelle impostazioni dello spazio di lavoro dell'app crea una connessione condivisa nello spazio di lavoro.-* `scope: 'USER'` — ciascun membro connette il proprio account, creando connessioni personali. I membri li aggiungono, ricollegano e rimuovono dalla pagina dell'app in **Impostazioni > Utente > Preferenze app**, per la quale è necessaria l'autorizzazione `CONNECTED_ACCOUNTS` (App utente). Le impostazioni dello spazio di lavoro dell'app non dispongono del pulsante **Aggiungi connessione** per un provider `USER`.+* `scope: 'USER'` — ciascun membro connette il proprio account, creando connessioni personali. I membri li aggiungono, ricollegano e rimuovono dalla pagina dell'app in **Impostazioni > Utente > Preferenze app**, che richiede l'autorizzazione App utente. Le impostazioni dello spazio di lavoro dell'app non dispongono del pulsante **Aggiungi connessione** per un provider `USER`.<Note>**Preferenze app** non è ancora abilitato in ogni spazio di lavoro: dove non lo è,@@ -520,7 +520,7 @@ Un provider ha esattamente un ambito. Se la tua app necessita sia di una credenzUna connessione ha sempre l'ambito del proprio provider e l'ambito di un provider fa parte della sua identità: una versione successiva non può modificare lo `scope` di un provider esistente e l'aggiornamento viene rifiutato se tenta di farlo. Per spostare un servizio da un ambito all'altro, dichiara un nuovo provider con un nuovo `universalIdentifier` e rimuovi quello vecchio. L'aggiornamento elimina quindi il vecchio provider e ogni connessione effettuata con esso tramite il normale percorso di disconnessione (`onDisconnectLogicFunction`, revoca del token, pulizia del canale), e i membri si connettono nuovamente tramite il nuovo provider.-L'aggiunta o la riconnessione di una connessione **Solo per me** richiede l'autorizzazione `CONNECTED_ACCOUNTS`, mentre l'aggiunta o la riconnessione di una connessione **Condivisa nell'area di lavoro** richiede l'autorizzazione `APPLICATIONS`.+L'aggiunta o il ricollegamento di una connessione **Solo per me** richiede l'autorizzazione App utente, mentre l'aggiunta o il ricollegamento di una connessione **Condivisa nell'area di lavoro** richiede l'autorizzazione App dell'area di lavoro.Usa quella giusta per ciascun handler:diff --git a/packages/twenty-docs/it/developers/extend/apps/logic/inbox.mdx b/packages/twenty-docs/it/developers/extend/apps/logic/inbox.mdxindex b79469006b8..67bd427a524 100644--- a/packages/twenty-docs/it/developers/extend/apps/logic/inbox.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/logic/inbox.mdx@@ -92,4 +92,34 @@ await sendInboxMessage({* Una menzione solo render. Non aggiunge il membro alla conversazione né li notifica, quindi elenca tutti coloro che dovrebbero ricevere il messaggio in `workspaceMemberIds`.* `INBOX_ASSISTANT_MENTION` è il testo che il compositore scrive quando un membro menziona l'assistente (`@Ada`), quindi i tuoi messaggi lo chiamano allo stesso modo.+## Collegare record a una conversazione++`attachRecordToInboxThread()` collega una conversazione a un record e `detachRecordFromInboxThread()` rimuove il collegamento.++```ts src/logic-functions/file-call-recap.ts+import {+ attachRecordToInboxThread,+ sendInboxMessage,+} from 'twenty-sdk/logic-function';++const { threadId } = await sendInboxMessage({+ workspaceMemberIds: [owner.id],+ threadKey: `call-recap-${call.id}`,+ idempotencyKey: `call-recap-${call.id}`,+ title: `Recap of ${call.title}`,+ text: call.summary,+});++await attachRecordToInboxThread({+ threadId,+ objectNameSingular: 'company',+ recordId: company.id,+});+```++* Entrambi accettano il `threadId` della conversazione e il record come `objectNameSingular` e `recordId`. Una conversazione può essere collegata a record di persone, aziende, opportunità e oggetti personalizzati.+* Entrambi sono idempotenti: collegare un record due volte mantiene un unico collegamento, mentre scollegare un record non collegato non modifica nulla.+* La chiamata viene eseguita con lo stesso accesso dell'[invio di un messaggio](#who-sends-the-message), che richiede l'autorizzazione `AI`. Un membro deve poter modificare la conversazione e l'applicazione può agire su una conversazione che ha scritto essa stessa o su una a cui è stato concesso il relativo ruolo predefinito; in caso contrario, la chiamata non riesce con `THREAD_NOT_FOUND`.+* Il record deve essere leggibile con tale accesso, altrimenti la chiamata non riesce con `RECORD_NOT_FOUND`.+<PageBanner illustration="card-page-inbox" />diff --git a/packages/twenty-docs/it/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/it/developers/extend/apps/logic/logic-functions.mdxindex 64b4316db28..e5eedb4fb24 100644--- a/packages/twenty-docs/it/developers/extend/apps/logic/logic-functions.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/logic/logic-functions.mdx@@ -293,28 +293,25 @@ export default defineLogicFunction({L'endpoint è raggiungibile all'indirizzo:```-POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionId+POST https://your-twenty-server.com/webhooks/server/:applicationRegistrationId/:resolverLogicFunctionUniversalIdentifier```-L'identificatore è l'`id` del resolver: la chiave primaria che il server assegna quando l'app viene sincronizzata per la prima volta nel workspace proprietario, non l'`universalIdentifier` del tuo manifest. Recuperalo dall'API `/metadata` del workspace proprietario, quindi registra quell'URL con il provider:+Il primo segmento è l'id della registrazione della tua app, il secondo è il `universalIdentifier` del resolver dal tuo manifest. Una route viene risolta solo a un resolver di quella registrazione, nel relativo workspace proprietario. Quando la tua app registra il webhook stesso, crea l'URL dall'interno di una funzione logica con `getServerRouteUrl`; Twenty inserisce l'URL di base delle route del server della tua app come `TWENTY_SERVER_ROUTES_URL`:-```graphql-query {- findManyLogicFunctions {- id- name- universalIdentifier- }-}+```ts+import { getServerRouteUrl } from 'twenty-sdk/utils';++const destinationUrl = getServerRouteUrl(+ INVOICE_PAID_RESOLVER_UNIVERSAL_IDENTIFIER,+);```<Note>- Un URL contenente il `universalIdentifier` del resolver continua per ora a essere risolto,- e la risposta include un header `Deprecation`. Un `universalIdentifier` è- univoco per spazio di lavoro, non a livello globale: se un'altra registrazione di proprietà di un- diverso spazio di lavoro dichiara lo stesso identificatore, la piattaforma restituisce `404` per quell'- URL anziché scegliere tra le due. Sposta gli URL registrati presso i tuoi- provider nella forma `id`.+ Gli URL che contengono solo l'`id` o l'`universalIdentifier` del resolver+ (`/webhooks/server/:identifier`) continuano per ora a essere risolti, ed entrambi restituiscono+ un'intestazione `Deprecation`. Il formato `universalIdentifier` restituisce `409` quando due+ registrazioni dichiarano lo stesso identificatore. Sposta gli URL registrati presso i tuoi+ provider nel modulo di registrazione.</Note>**Risposta a una verifica GET.** Alcuni provider verificano un endpoint prima di inviarvi dati, inviando un `GET` contenente una verifica allo stesso URL a cui in seguito invieranno eventi tramite `POST` — WhatsApp Cloud API di Meta è uno di questi. Una route del server risponde solo a `POST`, a meno che non venga specificato diversamente, quindi dichiara entrambi i metodi:diff --git a/packages/twenty-docs/it/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/it/developers/extend/apps/logic/skills-and-agents.mdxindex ddddcbd9694..715833ae07b 100644--- a/packages/twenty-docs/it/developers/extend/apps/logic/skills-and-agents.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/logic/skills-and-agents.mdx@@ -103,6 +103,39 @@ Note sullo schema:* `required` (facoltativo) elenca le proprietà che il modello deve sempre restituire.* `additionalProperties: false` (facoltativo) vieta qualsiasi proprietà non dichiarata in `properties`.+</Accordion>+<Accordion title="defineMcpServer" description="Esponi un server MCP esterno all'IA dello spazio di lavoro (beta)">++<Warning>+ I server MCP sono in beta e non sono ancora attivi: puoi dichiararli, ma gli spazi di lavoro non possono usare i loro strumenti finché la funzionalità non verrà rilasciata.+</Warning>++Usa `defineMcpServer()` per distribuire un server MCP remoto (Streamable HTTP) con la tua app, in modo che l'IA dello spazio di lavoro possa usare i suoi strumenti senza sincronizzare tali dati in Twenty:++```ts src/mcp-servers/github.ts+import { defineMcpServer } from 'twenty-sdk/define';++import { GITHUB_CONNECTION_PROVIDER_UNIVERSAL_IDENTIFIER } from 'src/constants/universal-identifiers';++export default defineMcpServer({+ universalIdentifier: '0b6c4f7e-3d5a-4a8e-9a0d-6f1e2c3b4a01',+ name: 'github',+ label: 'GitHub',+ url: 'https://api.githubcopilot.com/mcp/',+ connectionProvider: {+ universalIdentifier: GITHUB_CONNECTION_PROVIDER_UNIVERSAL_IDENTIFIER,+ },+});+```++Punti chiave:+* `name` è in snake_case (lettere minuscole, cifre e trattini bassi, inizia con una lettera, massimo 32 caratteri) ed è univoco nello spazio di lavoro. Funge da prefisso per i nomi degli strumenti del server.+* `url` deve essere un URL HTTP o HTTPS.+* `connectionProvider` (facoltativo) fa riferimento a un [provider di connessione](/it/developers/extend/apps/logic/connections) dichiarato dalla stessa app. Le chiamate inviano il token di accesso di tale connessione come token Bearer. Omettilo per un server pubblico.+* L'URL non può cambiare in una versione successiva quando è collegato un provider di connessione, affinché i token non vengano mai inviati a un altro host.+* Gli spazi di lavoro possono disattivare il server; una versione successiva dell'app mantiene questa scelta.+* Richiede `"engines": { "twenty": ">=2.53.0" }`.+</Accordion><Accordion title="runAgent" description="Esegui un agente da una funzione di logica">diff --git a/packages/twenty-docs/it/developers/extend/apps/logic/workflows.mdx b/packages/twenty-docs/it/developers/extend/apps/logic/workflows.mdxindex 95185722e61..415f43583b7 100644--- a/packages/twenty-docs/it/developers/extend/apps/logic/workflows.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/logic/workflows.mdx@@ -68,7 +68,7 @@ export default defineWorkflow({Punti chiave:-* Il workflow, il relativo trigger e ogni passaggio necessitano del proprio `universalIdentifier`. Mantienili stabili tra le release: è così che Twenty trova una corrispondenza con il workflow installato all'installazione successiva.+* Il flusso di lavoro e ogni passaggio necessitano del proprio `universalIdentifier`, e il trigger può averne uno. Mantienili stabili tra le release: è così che Twenty trova una corrispondenza con il workflow installato all'installazione successiva.* `nextStepIds` collega il grafo. Il trigger punta ai primi passaggi e ogni passaggio punta ai passaggi eseguiti dopo di esso.* Un passaggio legge l'output precedente con `{{trigger.\<path>}}` o `{{\<step universalIdentifier>.\<path>}}`.* La build convalida l'intera definizione: tipi di trigger o passaggio non supportati, collegamenti tra passaggi non validi e riferimenti a passaggi sconosciuti causano l'errore.@@ -95,6 +95,8 @@ Un riferimento che Twenty non riesce a risolvere causa l'errore di installazioneUn workflow manuale senza `availability` non ottiene alcuna voce nel menu dei comandi.+Ogni trigger accetta anche `name`, `position` e `outputSchema` facoltativi, che definiscono solo l'aspetto del flusso di lavoro nel builder. Senza di essi, Twenty usa un nome come `Manual trigger`, posiziona il trigger nella parte superiore dell'area di lavoro e calcola lo schema di output dalle impostazioni.+Un workflow webhook resta in ascolto su `https://\<your-twenty-domain>/webhooks/workflows/\<workspaceId>/\<workflowId>`, dove `workflowId` è l'id del workflow installato. Il corpo della richiesta è disponibile come `{{trigger.\<path>}}`.## Passaggi@@ -126,7 +128,8 @@ I relativi input corrispondono ai passaggi del [generatore di workflow](/it/userL'applicazione Custom dell'area di lavoro possiede i workflow creati nel workflow builder e il codice ha per essi la stessa autorevolezza del builder:-* `twenty app pull` scrive ciascuno dalla relativa versione attiva, quella pubblicata per ultima dal builder. Un workflow la cui versione attiva utilizza impostazioni che un file `defineWorkflow()` non può esprimere, come un passaggio Code o un trigger rinominato dal builder, viene segnalato e lasciato al suo posto.+* `twenty app pull` scrive ciascuno dalla relativa versione attiva, quella pubblicata per ultima dal builder. Un flusso di lavoro la cui versione attiva usa impostazioni che un file `defineWorkflow()` non può esprimere, come un passaggio Code, viene segnalato e lasciato invariato.+* Un flusso di lavoro recuperato mantiene ciò che il builder ha memorizzato: un trigger senza `universalIdentifier`, il nome del trigger nel builder, una `position` pari a `null` per un nodo che il builder non ha mai posizionato e un `outputSchema` diverso da quello calcolato. Questi campi richiedono twenty-sdk 2.53.0 o versioni successive, applicati a un server con 2.53.0 o versioni successive: le versioni precedenti li rifiutano come chiavi sconosciute.* `twenty app apply` pubblica come il builder. Un workflow la cui definizione corrisponde alla sua versione attiva non viene modificato. Altrimenti, la versione attiva viene archiviata e la definizione diventa una nuova versione attiva, così le esecuzioni precedenti mantengono la versione con cui sono state eseguite.* Gli utenti continuano a modificare questi workflow nel builder e il pull successivo recupera le loro modifiche.diff --git a/packages/twenty-docs/it/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/it/developers/extend/apps/operations/cli.mdxindex a65fd27850e..31646cb9daf 100644--- a/packages/twenty-docs/it/developers/extend/apps/operations/cli.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/operations/cli.mdx@@ -110,7 +110,7 @@ Altri comandi dell'app:| `app plan` | Visualizza in anteprima le modifiche ai metadati che un'applicazione apporterebbe || `app apply` | Compila, carica e sincronizza l'app || `app generate-client` | Rigenera il client API tipizzato senza sincronizzare |-| `app pull` | Scrivi nuovamente i metadati dell'app installata nel codice sorgente locale |+| `app pull` | Ripristina i metadati, le traduzioni e le dipendenze archiviate || `app translations extract` | Estrai le stringhe traducibili nei cataloghi in `locales/` || `app publish` | Pubblica l'app su npm o in un registro privato Twenty || `app install` | Installa nello spazio di lavoro un pacchetto dell'app già registrato |diff --git a/packages/twenty-docs/it/developers/extend/apps/operations/marketplace-review.mdx b/packages/twenty-docs/it/developers/extend/apps/operations/marketplace-review.mdxindex f91c17eb7b3..c30d54728e8 100644--- a/packages/twenty-docs/it/developers/extend/apps/operations/marketplace-review.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/operations/marketplace-review.mdx@@ -1,26 +1,23 @@----title: Verifica del marketplace (in corso)-description: Requisiti proposti affinché le app di terze parti ricevano un badge di verifica.+title: Revisione del marketplace+description: Requisiti di sicurezza e qualità che ogni app deve soddisfare per essere pubblicata nel marketplace.---import { PageBanner } from "/snippets/page-banner.mdx"-## Come funziona il controllo+## Come funziona la revisione-<Warning>- **Lavori in corso.** Questa pagina e i relativi requisiti potrebbero evolvere. La verifica di terze parti- non è ancora disponibile. Consulta- [Pubblicazione](/it/developers/extend/apps/operations/publishing#marketplace-visibility-and-review)- per il comportamento attuale del marketplace.-</Warning>+Ogni app pubblicata nel marketplace ha superato la revisione della sicurezza e della qualità di Twenty. La pubblicazione su npm non inserisce automaticamente un'app nell'elenco: rimane non elencata+finché la revisione non è completata. Consulta+[Pubblicazione](/it/developers/extend/apps/operations/publishing#marketplace-visibility-and-review)+per sapere come funziona l'inserimento nell'elenco.-La verifica si applica a una versione e a un pacchetto dell'app specifici. Ogni aggiornamento richiede la revisione e-l'approvazione di Twenty. Le app verificate possono essere rivalutate man mano che le dipendenze o i servizi-evolvono.+Le app elencate possono essere rivalutate man mano che esse, le relative dipendenze o i servizi su cui+si basano evolvono e possono essere rimosse dall'elenco se non soddisfano più la checklist.-## Elenco di controllo per la verifica+## Checklist di revisione-Tutti gli elementi applicabili devono essere superati. Consigliamo di utilizzare un agente per autovalutare+Tutti gli elementi applicabili devono essere superati. Consigliamo di usare un agente per valutare autonomamenteogni criterio con prove e correzioni necessarie prima dell'invio.* [ ] **Editore.** [Rivendica la tua app](/it/developers/extend/apps/operations/publishing#claiming-your-app)@@ -29,32 +26,32 @@ ogni criterio con prove e correzioni necessarie prima dell'invio.problemi bloccanti.* [ ] **Autorizzazioni.** Richiedi solo le[autorizzazioni](/it/developers/extend/apps/config/roles) necessarie per le funzionalità dell'app.-* [ ] **Funzionalità.** La configurazione e i flussi di lavoro principali sono facili da seguire e funzionano come+* [ ] **Funzionalità.** La configurazione e i workflow principali sono facili da seguire e funzionano comepubblicizzato, senza arresti anomali, lavoro perso o record duplicati. Nessuna funzionalità segnaposto- né controllo non funzionante.-* [ ] **Prestazioni.** Rispetta i limiti di frequenza condivisi per API/processi, gestisci il throttling e+ o controllo non funzionante.+* [ ] **Prestazioni.** Rispetta i limiti di frequenza condivisi per API/processi, gestisci la limitazione esegui le[buone pratiche per lo sviluppo di app](/it/developers/extend/apps/getting-started/good-practices).* [ ] **Utilità.** Completa un'attività CRM significativa per un pubblico più ampio rispetto alla- configurazione di un singolo cliente. I connettori piccoli e le automazioni headless sono idonei.-* [ ] **Esperienza nativa.** Riutilizza oggetti, viste e flussi di lavoro nativi ove appropriato.+ configurazione di un singolo cliente. Sono idonei anche connettori piccoli e automazioni headless.+* [ ] **Esperienza nativa.** Riutilizza oggetti, viste e workflow nativi quando appropriato.Se l'app ha un'interfaccia utente, usa[`twenty-ui`](/it/developers/extend/apps/layout/front-components#using-twenty-ui-components)e adotta i layout, le interazioni e le convenzioni di accessibilità di Twenty.-* [ ] **Privacy.** Spiega quali dati lasciano lo spazio di lavoro, dove vanno e perché,- inclusi i fornitori di IA, per quanto tempo vengono conservati e come possono essere eliminati.-* [ ] **Manutenzione e compatibilità.** Dichiara le versioni supportate di Twenty, mantieni+* [ ] **Privacy.** Spiega quali dati escono dallo spazio di lavoro, dove vanno e perché,+ inclusi i provider di IA, per quanto tempo vengono conservati e come possono essere eliminati.+* [ ] **Manutenzione e compatibilità.** Dichiara le versioni di Twenty supportate, mantienistabili gli identificatori delle entità e correggi nel tempo bug critici e integrazioni non funzionanti.* [ ] **Logo e galleria.** Fornisci un logo originale e riconoscibile e immaginicurate dell'app effettiva. Segui le[linee guida per le immagini](/it/developers/extend/apps/operations/publishing#marketplace-metadata).-* [ ] **Scheda e README.** Descrivi accuratamente le funzionalità e le affiliazioni nel+* [ ] **Scheda e README.** Descrivi accuratamente funzionalità e affiliazioni nelnome, nella descrizione e negli screenshot. Mantieni il README breve, ben formattatoe incentrato sul valore dell'app.* [ ] **Prezzi.** Indica chiaramente se l'app è gratuita o a pagamento, i prezzi dei piani,- la frequenza di fatturazione e gli eventuali servizi di terze parti a pagamento necessari.-* [ ] **Documentazione e supporto.** Fornisci istruzioni di configurazione, un esempio funzionante- e un contatto per il supporto. Se utilizzi route condivise, completa la+ la frequenza di fatturazione e gli eventuali servizi di terze parti a pagamento richiesti.+* [ ] **Documentazione e supporto.** Fornisci istruzioni per la configurazione, un esempio funzionante+ e un contatto per l'assistenza. Se utilizzi route condivise, completa la[configurazione](/it/developers/extend/apps/operations/publishing#setting-up-server-routes)e verifica che gli eventi raggiungano lo spazio di lavoro corretto.diff --git a/packages/twenty-docs/it/developers/extend/apps/operations/overview.mdx b/packages/twenty-docs/it/developers/extend/apps/operations/overview.mdxindex 2b6e2018967..af17f4f15fb 100644--- a/packages/twenty-docs/it/developers/extend/apps/operations/overview.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/operations/overview.mdx@@ -42,8 +42,8 @@ Il **livello operativo** è tutto ciò che fai *alla* tua app piuttosto che *conBuild, deploy a tarball, publish to npm, install.</Card><Card href="/it/developers/extend/apps/operations/marketplace-review" img="/images/documentation/banner-icons-v2/permissions.svg">- Controllo <CardTitle>Marketplace (WIP)</CardTitle>- Proposto sicurezza, qualità e controlli operativi per le versioni di app di terze parti.+ <CardTitle>Revisione del marketplace</CardTitle>+ Controlli di sicurezza, qualità e operativi che un'app deve superare per essere pubblicata.</Card><Card href="/it/developers/extend/apps/operations/monitoring" img="/images/user-guide/halftone/card-page-monitoring.svg"><CardTitle>Monitoraggio</CardTitle>diff --git a/packages/twenty-docs/it/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/it/developers/extend/apps/operations/publishing.mdxindex 2cd44737562..a450befbed5 100644--- a/packages/twenty-docs/it/developers/extend/apps/operations/publishing.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/operations/publishing.mdx@@ -223,7 +223,7 @@ I workflow `ci.yml` e `cd.yml` fanno riferimento ad azioni riutilizzabili a `@ma## Pubblicazione su npm-La pubblicazione su npm rende la tua app idonea per il marketplace di Twenty. Dopo la sincronizzazione del catalogo e l'eventuale [configurazione delle route del server](#setting-up-server-routes) richiesta, gli spazi di lavoro possono sfogliarla, installarla e aggiornarla dall'interfaccia utente. Le app della community vengono visualizzate quando gli utenti disattivano il filtro **Solo verificate**.+La pubblicazione su npm rende la tua app idonea per il marketplace di Twenty. Dopo la sincronizzazione del catalogo e qualsiasi [configurazione delle route del server](#setting-up-server-routes) richiesta, gli spazi di lavoro possono visualizzarla, installarla e aggiornarla dall'interfaccia utente una volta superata la [revisione del marketplace](/it/developers/extend/apps/operations/marketplace-review).### Requisiti@@ -373,17 +373,13 @@ Se riscontri problemi nel rivendicare la tua app, contattaci su [Discord](https:Questa configurazione è già gestita per te su Twenty Cloud.</Accordion>-## Visibilità e verifica nel marketplace+## Visibilità e revisione del Marketplace-La rivendicazione stabilisce la proprietà; non assegna un badge **Verificata**. Il marketplace usa per impostazione predefinita **Solo verificate**. Per trovare le app della community, vai a **Impostazioni > Applicazioni > Marketplace**, apri il filtro e deseleziona **Solo verificate**. Puoi anche condividere la pagina di installazione diretta della tua app usando **Le mie app > la tua app > Distribuzione > Copia link di condivisione**.+Ogni app elencata nel marketplace ha superato la revisione di sicurezza e qualità di Twenty. Un'app appena pubblicata resta non elencata finché non supera la [revisione del marketplace](/it/developers/extend/apps/operations/marketplace-review); rivendicarla ne stabilisce la proprietà, ma non la inserisce nell'elenco.-L'etichetta Verificata si applica attualmente alle app gestite da Twenty, per le quali il team può garantire sicurezza e qualità. Le app di terze parti possono essere pubblicate e installate senza questa etichetta.+Un'app non elencata può comunque essere installata. In **Impostazioni > Applicazioni > Marketplace**, apri il filtro e attiva **Mostra app non elencate**, oppure condividi la pagina di installazione diretta dell'app usando **Le mie app > la tua app > Distribuzione > Copia link di condivisione**. Gli spazi di lavoro visualizzano un avviso che indica che l'app non è stata revisionata da Twenty.-La [checklist di valutazione del marketplace di terze parti](/it/developers/extend/apps/operations/marketplace-review)-proposta è un lavoro in corso. Descrive criteri di revisione ed evidenze specifici della versione,-non un programma di certificazione disponibile.--Se la tua app continua a non essere visibile con **Solo verificate** disattivato, verifica che la sincronizzazione del catalogo sia stata completata, che tutte le variabili del server richieste siano compilate e che l'eventuale configurazione delle route del server sia completa.+Se la tua app è elencata ma non è ancora presente nel marketplace, verifica che la sincronizzazione del catalogo sia stata completata, che tutte le variabili del server richieste siano compilate e che qualsiasi configurazione delle route del server sia completata.## Installazione delle appdiff --git a/packages/twenty-docs/it/developers/extend/apps/operations/sync-and-recovery.mdx b/packages/twenty-docs/it/developers/extend/apps/operations/sync-and-recovery.mdxindex 71a153a7046..341ad8ecdfc 100644--- a/packages/twenty-docs/it/developers/extend/apps/operations/sync-and-recovery.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/operations/sync-and-recovery.mdx@@ -23,7 +23,7 @@ Lo sviluppo di app in locale ruota attorno alla **sincronizzazione**: la CLI ric| Visualizzare in anteprima le modifiche **senza applicarle** | `twenty app plan` | Calcola e stampa il diff; non scrive nulla. || Sincronizza senza eliminare nulla | `twenty app apply --no-prune` | Crea e aggiorna soltanto: le entità presenti nello spazio di lavoro ma non nella sorgente vengono lasciate invariate. Accettato anche da `plan` e `dev`. || Ripulisci l'applicazione personalizzata dell'area di lavoro | `twenty app apply --prune` | Quell'applicazione mantiene le entità assenti dalla sorgente, a meno che non specifichi `--prune`. Accettato anche da `plan` e `dev`. |-| Rigenera l'origine locale dall'area di lavoro | `twenty app pull` | **Sperimentale.** Riscrive l'app installata nei file di definizione. Vedi sotto. |+| Rigenera l'origine locale dall'area di lavoro | `twenty app pull` | **Sperimentale.** Ripristina i file di definizione, le traduzioni e le dipendenze archiviate. Vedi sotto. || Rimuovere l'app dallo spazio di lavoro | `twenty app uninstall` | Aggiungi `--yes` per saltare il prompt. || Inviare un tarball a un server | `twenty app publish --private` | Richiede una versione di `package.json` **strettamente superiore** — vedi [Publishing](/it/developers/extend/apps/operations/publishing). || Pubblicare nel marketplace (npm) | `twenty app publish` | — |@@ -108,17 +108,23 @@ Un piano:prima di eseguirlo e controlla il diff.</Warning>-`twenty app pull` è l'inverso di `apply`: legge un'applicazione da un workspace e la riscrive come file define.+`twenty app pull` è l'inverso di `apply`: legge un'applicazione dall'area di lavoro e ripristina i relativi file di definizione, le traduzioni e i file delle dipendenze archiviate.```bash-twenty app pull --universal-identifier <universalIdentifier>+twenty app pull --remote dev+twenty app pull --path ./workspace-app --yes --no-input```-Pull richiede un progetto esistente — creane prima uno con `twenty app init`, quindi esegui pull al suo interno. Senza `--universal-identifier`, pull si rivolge all'applicazione dichiarata dal file locale `defineApplication()`. Se `--universal-identifier` indica un'applicazione diversa da quella dichiarata dal tuo progetto, pull si rifiuta di procedere anziché lasciare due applicazioni in un unico albero: estrai quell'applicazione nella propria directory. Se il progetto ha un file dell'applicazione il cui identificatore non può essere letto, di solito perché le dipendenze non sono installate, anche pull si rifiuta di procedere e chiede di eseguire prima `yarn install`. Aggiungi `--verbose` per espandere le sezioni di copertura del report, che indicheranno fino a 20 identificatori per tipo di metadati anziché solo i totali.+All'interno di un'app, pull legge il proprio identificatore `defineApplication()` locale e recupera quell'applicazione. All'esterno di un'app, richiede una directory e una conferma, crea un progetto locale per l'applicazione personalizzata dell'area di lavoro selezionata, installa le dipendenze con Yarn, quindi recupera le definizioni. Il nuovo progetto include file di pacchetto e configurazione, senza le entità demo dell'inizializzatore.++Usa `--path` per selezionare un'app esistente o una directory nuova o vuota. La creazione non interattiva richiede `--path` e `--yes`; pull si rifiuta di sovrascrivere una directory non vuota non correlata. La creazione di un progetto non registra un'applicazione né modifica l'area di lavoro. Un progetto SDK esistente senza una definizione dell'applicazione recupera anche l'applicazione personalizzata. Non esiste alcuna opzione `--universal-identifier`.++Se l'installazione delle dipendenze non riesce per un nuovo progetto, lo scaffold viene mantenuto. Esegui `yarn install` al suo interno, quindi riprova il pull. I progetti esistenti non installano automaticamente le dipendenze. Se non è possibile leggere il relativo identificatore dell'applicazione, pull segnala quell'errore invece di creare un'altra app. Aggiungi `--verbose` per espandere le sezioni di copertura del report, che indicheranno fino a 20 identificatori per tipo di metadati anziché solo i totali.**Cosa scrive:*** la configurazione dell'applicazione;+* file delle dipendenze `package.json` e `yarn.lock` archiviati, nella radice del progetto;* oggetti, con i relativi campi inclusi;* campi aggiunti dalla tua app a oggetti che non possiede;* indici creati;@@ -137,6 +143,10 @@ Pull richiede un progetto esistente — creane prima uno con `twenty app init`,Ogni entità viene inserita nel file che già la definisce, quindi un secondo pull riscrive solo ciò che è cambiato sul server. Un file viene riscritto anche quando utilizza una funzione di definizione diversa da quella che pull scriverebbe, ad esempio un ruolo che è diventato o ha smesso di essere il ruolo predefinito. Le nuove entità vengono collocate accanto ai file esistenti dello stesso tipo e un nome generato che finirebbe in un file non correlato viene qualificato anziché sovrascriverlo.+**File di dipendenza.** Quando il file `package.json` o `yarn.lock` archiviato cambia, pull sostituisce il file locale e segnala eventuali modifiche locali sovrascritte. Se il file remoto non è cambiato dall'ultimo pull, le modifiche locali vengono mantenute. L'assenza di un file remoto non elimina la sua controparte locale. Quando il pacchetto esportato omette `twenty-sdk`, come fa l'applicazione Custom dello spazio di lavoro, pull conserva la dipendenza SDK locale affinché i comandi CLI possano comunque caricare il progetto. I file di dipendenza, i metadati e la baseline vengono scritti e ripristinati insieme se una scrittura non riesce.++Esegui `yarn install` dopo aver scaricato le modifiche alle dipendenze. Pull non installa pacchetti, non esegue script di pacchetto né rigenera il client tipizzato.+**Cosa non scrive:*** **Non ancora esportati** — voci del menu dei comandi e del menu delle impostazioni, funzioni logiche e componenti front-end, provider di connessione, variabili dell'applicazione, risorse pubbliche, tipi di attività della timeline e il codice sorgente archiviato delle tue funzioni.@@ -145,15 +155,15 @@ Ogni entità viene inserita nel file che già la definisce, quindi un secondo pu* **Inseriti in un layout di pagina predefinito o esterno** — le schede e i widget aggiunti a un layout di pagina predefinito del motore, o a uno di proprietà di un'altra applicazione, vengono scritti come file `definePageLayoutTab()` e `definePageLayoutWidget()` autonomi, poiché l'identificatore a cui si collegano è noto.* **Widget che l'esportazione non può ancora includere** — in qualsiasi layout, incluso il tuo, viene segnalato un widget del tipo deprecato `VIEW`, un widget che mostra uno dei componenti front o delle voci del menu dei comandi della tua app, oppure un widget senza una posizione per la modalità di layout della relativa scheda, e il layout o la scheda viene scritto senza di esso.* **Workflows che l'esportazione non può ancora trasferire** — un workflow modificato nel builder dei workflow dall'ultima sincronizzazione, un workflow di sistema o privato, uno con un passaggio Code o messaggio di chat, che i workflow dell'applicazione non supportano, e uno che richiama l'azione del workflow di un'altra app vengono segnalati e lasciati invariati. L'applicazione Custom dell'area di lavoro è l'eccezione per il primo e l'ultimo caso: il builder pubblica anche i relativi workflow, che possono chiamare le azioni di qualsiasi app, quindi vengono recuperati. Uno dei relativi workflow viene invece segnalato quando non ha una versione attiva oppure quando la sua versione attiva utilizza impostazioni che una definizione non può esprimere. I passaggi email e calendario vengono acquisiti: un account condiviso con lo spazio di lavoro viene scritto come relativo `connectedAccountHandle`, mentre l'account privato di un membro e le variabili vengono mantenuti così come sono. Il workflow viene invece segnalato quando l'account di un passaggio è archiviato, non può più eseguire il passaggio o condivide il proprio indirizzo con un account meno recente, poiché l'applicazione dell'handle selezionerebbe un altro account.-* **Agenti e competenze che l'esportazione non può ancora includere** — una competenza disattivata e un agente con più di un ruolo o associato a un pull di ruolo non vengono scritti, vengono segnalati e lasciati invariati.-* **Stato di runtime dell'area di lavoro** — assegnazioni di ruoli a membri e chiavi API, webhook, navigazione per utente e voci di navigazione fissate a un record, tutte escluse per progettazione.+* **Agenti che l'esportazione non può ancora gestire** — un agente con più di un ruolo, o associato a un pull del ruolo su cui non scrive, viene segnalato e lasciato in posizione.+* **Stato di runtime dello spazio di lavoro**, allegati ai record, allegati email, assegnazioni di ruoli per membri e chiavi API, webhook, navigazione per utente ed elementi di navigazione fissati a un record, tutti esclusi per progettazione, inclusa l'applicazione Custom dello spazio di lavoro.* **Di proprietà di un'altra applicazione** — segnalati, mai estratti.Il report alla fine di un pull elenca tutto, raggruppato per tipo e motivo. Tutto ciò che indica come non scritto è ancora nell'area di lavoro, quindi reinvia con push un albero ottenuto con pull usando `twenty app apply --no-prune` finché non saranno supportati i tipi mancanti. L'applicazione personalizzata dell'area di lavoro viene già applicata in questo modo per impostazione predefinita. Un apply con pruning (l'impostazione predefinita per le altre app, `--prune` per l'applicazione personalizzata) li eliminerebbe, e `twenty app plan` elenca esattamente quali.**Stato locale dell'area di lavoro.** Un'entità disattivata nell'area di lavoro viene scritta come definizione attiva e le modifiche apportate dall'area di lavoro a un'entità, ad esempio un'etichetta rinominata, non vengono scritte. Il report elenca tali righe in "Scritte senza il relativo stato locale dell'area di lavoro". Riapplicare l'albero alla stessa area di lavoro lascia invariato tale stato; un'altra area di lavoro riceve l'entità attiva e senza le modifiche.-**Il file di base.** Pull registra ciò che ha estratto in `.twenty/pull-base.json`, che è ignorato da git e specifico per ogni checkout. Quel file è ciò con cui un pull successivo confronta per non modificare i file le cui entità non sono cambiate e per eliminare il file di un'entità che non è più nell'area di lavoro. Un checkout che ne è privo scrive semplicemente tutto e non elimina nulla.+**Il file di base.** Pull registra ciò che ha scaricato in `.twenty/cli/pull-base.json`, che è ignorato da git e specifico per ogni checkout. Quel file è ciò con cui un pull successivo confronta per non modificare i file le cui entità non sono cambiate e per eliminare il file di un'entità che non è più nell'area di lavoro. Un checkout che ne è privo scrive semplicemente tutto e non elimina nulla.## Scala di ripristinodiff --git a/packages/twenty-docs/ro/developers/extend/apps/config/application.mdx b/packages/twenty-docs/ro/developers/extend/apps/config/application.mdxindex a393ff41faa..3374d1b0e8d 100644--- a/packages/twenty-docs/ro/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/config/application.mdx@@ -55,7 +55,7 @@ Notițe:* O aplicație își poate raporta propria stare de configurare cu [`defineHealthCheck()`](/ro/developers/extend/apps/logic/logic-functions#health-check), pentru aspecte pe care numai aplicația le poate cunoaște — o cheie prezentă, dar revocată, un cont terț cu planul greșit. `isRequired` acoperă ceea ce Twenty poate vedea singur; verificarea stării de sănătate acoperă restul.* Ambele tipuri de variabile acceptă `isRequired: true`. O variabilă obligatorie pe care spațiul de lucru nu a completat-o încă lasă aplicația neconfigurată: pagina sa de setări afișează un banner care indică variabilele lipsă, cu un buton care duce la fila în care acestea sunt configurate. Marcați ca obligatoriu doar ceea ce aplicația chiar nu poate rula fără — o variabilă opțională cu o valoare implicită rezonabilă ar trebui să rămână opțională.* Ambele tipuri de variabile acceptă `isDeprecated: true`. Folosește-l pentru a retrage o variabilă în loc să o ștergi: păstrarea cheii declarate conservă valoarea stocată (ștergerea ei distruge valoarea introdusă de operator), iar variabila este în continuare injectată, astfel încât codul tău poate reveni la ea — `process.env.NEW_API_KEY ?? process.env.API_KEY`. O variabilă învechită dispare din setările aplicației odată ce nu mai are nicio valoare și nu este niciodată luată în calcul la verificarea configurației aplicației, astfel încât `isDeprecated` are prioritate față de `isRequired`.-* Twenty setează aceste nume pentru fiecare rulare a funcției logice, deci sunt rezervate: `TWENTY_API_URL`, `TWENTY_APP_ACCESS_TOKEN`, `TWENTY_APP_APPLICATION_ACCESS_TOKEN`, `TWENTY_API_KEY`, `TWENTY_FUNCTIONS_URL` și `APPLICATION_ID`. Un manifest care declară una dintre acestea ca variabilă de aplicație sau de server este respins atunci când aplicația este sincronizată sau publicată.+* Twenty setează aceste nume pentru fiecare rulare a funcției logice, așadar sunt rezervate: `TWENTY_API_URL`, `TWENTY_APP_ACCESS_TOKEN`, `TWENTY_APP_APPLICATION_ACCESS_TOKEN`, `TWENTY_API_KEY`, `TWENTY_FUNCTIONS_URL`, `TWENTY_SERVER_ROUTES_URL` și `APPLICATION_ID`. Toate celelalte nume care încep cu `TWENTY_` sunt, de asemenea, rezervate, pentru variabilele pe care Twenty le adaugă ulterior. Un manifest care declară un nume rezervat ca variabilă de aplicație sau de server este respins atunci când aplicația este sincronizată sau publicată.* Pentru a adăuga propriile intrări în meniul de setări al aplicației (în locul paginii generate **Variables**), declară o componentă front și direcționează un [`defineSettingsMenuItem()`](/ro/developers/extend/apps/layout/front-components#settings-menu-items) către aceasta, într-un fișier separat. Declară oricâte ai nevoie și ordonează-le cu `position`; `scope` plasează un element în setările spațiului de lucru sau în setările proprii ale fiecărui membru. Elementul **General** gestionat de sistem (actualizare automată, URL-ul aplicației, conexiuni) este întotdeauna primul, iar URL-ul aplicației se afișează numai când aplicația are funcții declanșate prin HTTP.## Capabilități media solicitate@@ -191,7 +191,7 @@ Valorile sunt șiruri, în același format ca `process.env` (consultați [Tipuri`updateMyUserApplicationVariable` salvează propria valoare a unui membru. Preia `applicationUniversalIdentifier` al aplicației tale și scrie valoarea persoanei din spatele tokenului: sesiunea proprie a membrului sau tokenul aplicației tale atunci când un membru se află în spatele acestuia, cum ar fi într-o componentă frontend sau într-o funcție logică executată pentru un membru. Tokenul aplicației dvs. poate indica doar propria aplicație, iar un token fără nicio persoană asociată, cum ar fi într-o sarcină cron sau într-un hook de instalare, este refuzat. O valoare goală elimină valoarea proprie a membrului, astfel încât acesta citește din nou valoarea implicită sau un șir gol pentru o variabilă fără valoare implicită.-Nu necesită permisiunea `APPLICATIONS`, dar necesită `CONNECTED_ACCOUNTS`: în rolul membrului și, atunci când tokenul aplicației tale efectuează apelul, și în rolul implicit al aplicației tale, dacă aceasta declară unul. Dacă aplicația ta salvează variabile de utilizator, adaugă `SystemPermissionFlag.CONNECTED_ACCOUNTS` la `permissionFlagUniversalIdentifiers` în [rol](/ro/developers/extend/apps/config/roles).+Nu necesită permisiunea Workspace Apps, dar necesită User Apps: în rolul membrului și, atunci când tokenul aplicației tale efectuează apelul, și în rolul implicit al aplicației tale, dacă aceasta declară unul. Dacă aplicația ta salvează variabile ale utilizatorului, adaugă `SystemPermissionFlag.USER_APPS` la `permissionFlagUniversalIdentifiers` din [rolul](/ro/developers/extend/apps/config/roles).## Rol implicit pentru funcțiidiff --git a/packages/twenty-docs/ro/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/ro/developers/extend/apps/config/roles.mdxindex 2e4f3d3f1db..e798b7e3feb 100644--- a/packages/twenty-docs/ro/developers/extend/apps/config/roles.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/config/roles.mdx@@ -50,10 +50,20 @@ export default defineRole({canUpdateFieldValue: false,},],- permissionFlagUniversalIdentifiers: [SystemPermissionFlag.APPLICATIONS],+ permissionFlagUniversalIdentifiers: [SystemPermissionFlag.WORKSPACE_APPS],});```+<Note>+ `SystemPermissionFlag.USER_APPS` și `SystemPermissionFlag.WORKSPACE_APPS`+ sunt disponibile începând cu versiunea 2.54 a `twenty-sdk`; versiunile anterioare le denumesc+ `CONNECTED_ACCOUNTS` și `APPLICATIONS`. Denumirile vechi sunt aliasuri depreciate+ pentru aceleași indicatori, iar un rol păstrează fiecare indicator o singură dată. Enumerarea+ `SystemPermissionFlag`, de exemplu cu `Object.keys`, încă afișează denumirile+ vechi. API-ul raportează, de asemenea, aceste indicatori sub cheile lor vechi, de exemplu în+ `currentUserWorkspace.permissionFlags`.+</Note>+## Securitate la nivel de rândPermisiunile la nivel de rând necesită **planul Organization sau unul superior** — consultațidiff --git a/packages/twenty-docs/ro/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/ro/developers/extend/apps/data/objects.mdxindex ccd30f022d9..a3de96e8237 100644--- a/packages/twenty-docs/ro/developers/extend/apps/data/objects.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/data/objects.mdx@@ -109,6 +109,7 @@ export default defineObject({* `isLabelSyncedWithName`, pe un obiect sau pe un câmp, menține numele API sincronizat cu eticheta atunci când eticheta este editată în Setări. Valoarea implicită este `false`, astfel încât o etichetă redenumită lasă numele neschimbat.* `isSearchable: true`, aplicat unui câmp, include valorile acestuia în căutarea text integrală a obiectului (căutarea globală și meniul de comenzi). Necesită ca obiectul în sine să fie căutabil și un tip de câmp compatibil cu textul. O valoare omisă înseamnă că nu poate fi căutat, cu excepția câmpului de identificare a etichetei obiectului, care poate fi căutat întotdeauna și nu poate fi exclus. Fiecare sincronizare impune starea declarată, astfel încât un câmp a cărui căutare este activată din Setări revine la starea anterioară la următoarea sincronizare a aplicației dvs., cu excepția cazului în care manifestul o declară.* `isAuditLogged: false`, pe un câmp, împiedică apariția modificărilor sale în cronologia înregistrării. Valoarea implicită este `true`, cu excepția unui câmp `POSITION`, ale cărui modificări sunt afișate necompletate în cronologie și nu sunt niciodată înregistrate în jurnal. Setați această opțiune pe câmpurile pe care aplicația dvs. le rescrie conform unui program, cum ar fi un marcaj temporal al ultimului contact sau o relație de agregare, astfel încât fiecare sincronizare să nu adauge un rând de activitate la fiecare înregistrare pe care o modifică. O actualizare al cărei diff complet este format din câmpuri neînregistrate în jurnalul de audit nu produce deloc activitate în cronologie. La fel ca `isSearchable`, fiecare sincronizare impune starea declarată.+* `disabledFieldPermissionActions`, pe un câmp, enumeră permisiunile de câmp care nu pot fi acordate pe acesta: `'canReadFieldValue'`, `'canUpdateFieldValue'` sau ambele, aceleași indicatori pe care îi setează un rol pentru fiecare câmp. Utilizatorii, cheile API, agenții și alte aplicații nu primesc niciodată aceste acțiuni pe câmp, indiferent ce acordă rolul lor, iar salvarea unei permisiuni de câmp care acordă una dintre ele eșuează. Funcțiile de logică proprii ale aplicației dvs. le păstrează. De exemplu, `['canUpdateFieldValue']` păstrează doar pentru citire pentru toți ceilalți o valoare pe care aplicația dvs. o calculează sau o sincronizează, cum ar fi o stare sau un scor. Funcționează și pe câmpurile pe care le adăugați la obiecte pe care nu le dețineți cu `defineField()`.* Câmpurile inline definite aici **nu** au nevoie de `objectUniversalIdentifier` — este moștenit de la obiectul părinte. Folosiți [`defineField()`](/ro/developers/extend/apps/data/extending-objects) pentru a adăuga câmpuri la obiecte care nu vă aparțin.* Puteți genera obiecte noi cu `twenty app add object`, care vă ghidează prin denumire, câmpuri și relații. Consultați [Arhitectură → Generarea entităților](/ro/developers/extend/apps/getting-started/scaffolding).diff --git a/packages/twenty-docs/ro/developers/extend/apps/getting-started/concepts.mdx b/packages/twenty-docs/ro/developers/extend/apps/getting-started/concepts.mdxindex b4b6f2e45a0..316d7c957d0 100644--- a/packages/twenty-docs/ro/developers/extend/apps/getting-started/concepts.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/getting-started/concepts.mdx@@ -22,6 +22,7 @@ your-app/│ ├── front-components/ ← defineFrontComponent│ ├── skills/ ← defineSkill│ ├── agents/ ← defineAgent+│ ├── mcp-servers/ ← defineMcpServer│ ├── views/ ← defineView│ ├── navigation-menu-items/ ← defineNavigationMenuItem│ ├── settings-menu-items/ ← defineSettingsMenuItem@@ -51,6 +52,7 @@ your-app/| **Flux de lucru** | Fluxuri de lucru gata făcute cu un declanșator și pași | [Workflows](/ro/developers/extend/apps/logic/workflows) || **Furnizor de conexiune** | OAuth sau conectare personalizată pentru conturi terțe | [Connections](/ro/developers/extend/apps/logic/connections) || **Furnizor de mesagerie** | Trimite răspunsuri de pe canalele de mesagerie ale unei aplicații printr-o conexiune | [Canale de mesagerie](/ro/developers/extend/apps/logic/messaging-channels#sending-replies) |+| **Server MCP** | Server MCP extern pe care AI-ul spațiului de lucru îl poate apela | [Abilități și agenți](/ro/developers/extend/apps/logic/skills-and-agents) || **Vizualizare** | Vizualizări preconfigurate ale listelor de înregistrări | [Views](/ro/developers/extend/apps/layout/views) || **Element de meniu de navigare** | Intrări personalizate în bara laterală | [Navigation Menu Items](/ro/developers/extend/apps/layout/navigation-menu-items) || **Layout pagină** | File și widgeturi pe pagina de detalii a unei înregistrări | [Page Layouts](/ro/developers/extend/apps/layout/page-layouts) |diff --git a/packages/twenty-docs/ro/developers/extend/apps/layout/front-components.mdx b/packages/twenty-docs/ro/developers/extend/apps/layout/front-components.mdxindex 70e45ad039e..f6531c1f958 100644--- a/packages/twenty-docs/ro/developers/extend/apps/layout/front-components.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/layout/front-components.mdx@@ -163,14 +163,14 @@ Declarați câte aveți nevoie. Propriul element **Generale** al Twenty — actu* **`USER`** — configurat de fiecare membru pentru sine, în propriile setări de utilizator.<Note>- Un element `USER` se afișează ca o filă pe pagina aplicației, în **Settings > App- preferences**, unde este văzut numai de membrul autentificat și numai atunci când- rolul acestuia acordă permisiunea `CONNECTED_ACCOUNTS`. Acea pagină nu este încă activată în+ Un element `USER` se redă ca o filă pe pagina aplicației, în **Setări > Preferințe+ aplicație**, unde doar membrul autentificat îl vede și doar atunci când rolul său+ acordă permisiunea Aplicații utilizator. Acea pagină nu este încă activată înfiecare spațiu de lucru: acolo unde nu este activată, un element `USER` este păstrat și sincronizat,dar nimic nu îl afișează.</Note>-Un element `USER` rulează ca membrul care îl vizualizează. Pentru a stoca ceva pentru fiecare persoană, declară variabila cu `scope: 'USER'`: `getApplicationVariable` returnează valoarea membrului care vizualizează, iar componenta ta o salvează cu `updateMyUserApplicationVariable`, care scrie numai valoarea acelui membru și necesită `SystemPermissionFlag.CONNECTED_ACCOUNTS` în rolul aplicației tale, dacă declară unul (consultă [Citirea și actualizarea variabilelor în timpul rulării](#reading-and-updating-variables-at-runtime)). La fel ca un element `WORKSPACE`, un element `USER` înlocuiește formularul **Variabile** generat, așa că ar trebui să permită membrului să seteze fiecare variabilă de utilizator de care are nevoie aplicația dvs. O variabilă de spațiu de lucru conține o singură valoare partajată de toată lumea, astfel încât salvarea unui membru ar suprascrie valoarea altuia.+Un element `USER` rulează ca membrul care îl vizualizează. Pentru a stoca ceva pentru fiecare persoană, declară variabila cu `scope: 'USER'`: `getApplicationVariable` returnează valoarea membrului care vizualizează, iar componenta dvs. o salvează cu `updateMyUserApplicationVariable`, care scrie doar valoarea acelui membru și necesită `SystemPermissionFlag.USER_APPS` în rolul aplicației dvs., dacă aceasta declară unul (consultați [Citirea și actualizarea variabilelor în timpul rulării](#reading-and-updating-variables-at-runtime)). La fel ca un element `WORKSPACE`, un element `USER` înlocuiește formularul **Variabile** generat, așa că ar trebui să permită membrului să seteze fiecare variabilă de utilizator de care are nevoie aplicația dvs. O variabilă de spațiu de lucru conține o singură valoare partajată de toată lumea, astfel încât salvarea unui membru ar suprascrie valoarea altuia.<Note>`defineSettingsFrontComponent()` este învechită în favoarea@@ -658,8 +658,8 @@ Notițe:* Tokenul componentei tale este asociat propriei tale aplicații. `updateOneApplicationVariable` o vizează, astfel încât `applicationId` este opțional, iar specificarea unei alte aplicații este refuzată. Citirea `applicationVariables` ale unei alte aplicații este refuzată în același mod, iar o aplicație care aparține unui alt spațiu de lucru este citită ca fiind negăsită.* Cheia trebuie să fie una pe care aplicația ta o declară în [`defineApplication()`](/ro/developers/extend/apps/config/application). Scrierea unei chei care nu este declarată returnează negăsit.* Variabilele secrete sunt citite înapoi mascate, niciodată ca valoarea stocată. Scrierea acestora funcționează normal.-* Citirea `value` al unei variabile și scrierea acestuia necesită permisiunea de setări `APPLICATIONS` atât pentru rolul aplicației tale, cât și pentru rolul persoanei autentificate, deoarece tokenul componentei este intersecția celor două. Adaugă `SystemPermissionFlag.APPLICATIONS` la `permissionFlagUniversalIdentifiers` în [rolul aplicației](/ro/developers/extend/apps/config/roles).-* O variabilă de utilizator (`scope: 'USER'`) este injectată cu valoarea membrului care vizualizează, cu excepția cazului în care este secretă. `updateOneApplicationVariable` o refuză: salvați-o cu `updateMyUserApplicationVariable`, așa cum face `saveMyLanguage` mai sus. Scrie numai valoarea membrului care vizualizează și refuză să numească o altă aplicație. Nu necesită permisiunea `APPLICATIONS`, dar necesită permisiunea `CONNECTED_ACCOUNTS` pentru rolul membrului care vizualizează și pentru rolul aplicației tale, dacă declară unul: adaugă `SystemPermissionFlag.CONNECTED_ACCOUNTS` la `permissionFlagUniversalIdentifiers` în [rolul aplicației](/ro/developers/extend/apps/config/roles). Consultați [Variabile de spațiu de lucru și de utilizator](/ro/developers/extend/apps/config/application#workspace-and-user-variables).+* Citirea `value` al unei variabile și scrierea acesteia necesită permisiunea de setări Workspace Apps atât pentru rolul aplicației dvs., cât și pentru rolul persoanei autentificate, deoarece tokenul componentei este intersecția celor două. Adăugați `SystemPermissionFlag.WORKSPACE_APPS` la `permissionFlagUniversalIdentifiers` în [rolul aplicației](/ro/developers/extend/apps/config/roles).+* O variabilă de utilizator (`scope: 'USER'`) este injectată cu valoarea membrului care vizualizează, cu excepția cazului în care este secretă. `updateOneApplicationVariable` o refuză: salvați-o cu `updateMyUserApplicationVariable`, așa cum face `saveMyLanguage` mai sus. Scrie numai valoarea membrului care vizualizează și refuză să numească o altă aplicație. Nu necesită nicio permisiune Workspace Apps, dar necesită permisiunea Aplicații utilizator pentru rolul membrului care vizualizează și pentru rolul aplicației dvs., dacă aplicația dvs. declară un astfel de rol: adăugați `SystemPermissionFlag.USER_APPS` la `permissionFlagUniversalIdentifiers` în [rolul aplicației](/ro/developers/extend/apps/config/roles). Consultați [Variabile de spațiu de lucru și de utilizator](/ro/developers/extend/apps/config/application#workspace-and-user-variables).### Variabile de sistem@@ -987,6 +987,8 @@ Componentele de control fundamentale sunt grupate în `twenty-ui/primitives/\<faFolosește [`MainButton`](/ro/ui/components/input/main-button) pentru acțiuni importante și [`LightButton`](/ro/ui/components/input/light-button) pentru acțiuni ușoare. Folosește `Button`, `Field`, `Input`, `Select` și alte primitive din `twenty-ui/primitives/input` pentru controale și formulare fundamentale. Respectă părțile documentate ale fiecărui control compus, cum ar fi `Field.Root`, `Field.Label` și `Field.Description`.+Transmiteți `alignItemWithTrigger={false}` către `Select.Positioner`. Alinierea elementului selectat cu elementul declanșator, comportamentul implicit al Base UI, necesită măsurători sincrone ale aspectului pe care sandboxul nu le poate furniza, astfel încât fereastra popup se restrânge când se redeschide.+Folosește [`Dropdown`](/ro/ui/components/navigation/dropdown) din `twenty-ui/components/navigation` pentru meniuri de acțiuni, selectoare de opțiuni și panouri de formulare nonmodale. Folosește `enqueueSnackbar` din `twenty-sdk/front-component` pentru notificările gazdei.API-urile independente `Dialog` și `AlertDialog` sunt, de asemenea, exportate de Twenty UI, dar utilizarea directă în componentele front-end este interzisă. Utilizați [API-ul de comunicare cu gazda](#host-communication-api) pentru casete de dialog.@@ -1151,13 +1153,13 @@ Mouse, pointer, touch, drag, tastatură, focus, `input`/`change`/`submit`, `scroHandler-ele primesc evenimente tipizate construite din evenimentul paginii, `PointerEvent`, `MouseEvent`, `KeyboardEvent`, `InputEvent`, `WheelEvent` sau `FocusEvent`, iar acei constructori există în sandbox pentru `dispatchEvent()`. Fiecare eveniment redirecționat include și suprafața de evenimente sintetice a React (`nativeEvent`, `isDefaultPrevented()`, `isPropagationStopped()`, `persist()`), astfel încât codul scris pentru evenimentele React continuă să funcționeze chiar dacă sandbox-ul transmite obiectul eveniment direct handler-ului tău.-Un eveniment al paginii traversează atunci când elementul cu care a interacționat utilizatorul sau unul dintre strămoșii săi din componenta ta are un handler pentru acel tip de eveniment. Traversează o singură dată, apoi se propagă în sandbox ca pe pagină: `event.target` este elementul cu care a interacționat utilizatorul, `currentTarget` este elementul al cărui handler rulează, `stopPropagation()` împiedică rularea handler-elor strămoșilor, iar `relatedTarget` indică elementul din sandbox către sau de la care s-a mutat focusul ori indicatorul sau este `null` atunci când acel element se află în afara componentei tale. Ca în React, `onFocus` și `onBlur` rulează și pentru modificările focusului din interiorul elementului, iar `onClickCapture` și celelalte handler-e de capturare rulează în timpul fazei de capturare.+Un eveniment de pagină trece atunci când elementul cu care a interacționat utilizatorul sau unul dintre strămoșii săi din componenta ta are un handler pentru acel tip de eveniment sau când este o apăsare pe care listener-ele tale `document` o așteaptă (vezi mai jos). Traversează o singură dată, apoi se propagă în sandbox ca pe pagină: `event.target` este elementul cu care a interacționat utilizatorul, `currentTarget` este elementul al cărui handler rulează, `stopPropagation()` împiedică rularea handler-elor strămoșilor, iar `relatedTarget` indică elementul din sandbox către sau de la care s-a mutat focusul ori indicatorul sau este `null` atunci când acel element se află în afara componentei tale. Ca în React, `onFocus` și `onBlur` rulează și pentru modificările focusului din interiorul elementului, iar `onClickCapture` și celelalte handler-e de capturare rulează în timpul fazei de capturare.Handler-ele pe care o bibliotecă le adaugă cu `React.cloneElement`, precum cele din spatele prop-ului `render` al Base UI, rulează după handler-ele proprii ale elementului, în loc să le înlocuiască, astfel încât transmiterea `onClick: undefined` către `cloneElement` nu elimină handler-ul elementului. Un handler de pe un element `render` al Base UI poate totuși apela `event.preventBaseUIHandler()` pentru a omite handler-ul propriu al Base UI.`event.target.value` și `checked` reflectă controlul după ce browserul a aplicat modificarea utilizatorului: în handler-ele `input`, `change`, `click`, `blur` și `focusout` și în handler-ele `keyup` pentru `value`. În handler-ele `keydown`, `beforeinput` și de indicator, acestea păstrează valoarea și starea bifată a controlului de la ultima sa modificare, indiferent ce ascultă componenta ta: un handler `Enter` citește textul introdus până atunci, însă un handler pentru o tastă imprimabilă nu vede încă acea tastă, așa că citește valorile în timp real dintr-o intrare controlată sau dintr-un handler `onChange`.-Listener-ele `document` primesc evenimentele care traversează din componenta ta, dar nu și nimic din ce se întâmplă în altă parte pe pagină, astfel că, pentru a intercepta scurtături cu `document.addEventListener('keydown', ...)`, pune un `onKeyDown` pe un element care înfășoară componenta ta. Listener-ele `window` primesc doar `error` și `unhandledrejection`. Mișcările indicatorului traversează doar peste elementele care au un handler de mișcare, iar capturarea indicatorului rămâne pe pagină, motiv pentru care o glisare se oprește imediat ce indicatorul părăsește acele elemente. `event.preventDefault()` nu trece nici el; trimiterea formularelor, `dragover`/`drop` și clicurile pe linkuri sunt deja protejate pentru tine.+Listener-ele `document` primesc evenimentele care trec din componenta ta, cu o excepție pentru apăsări. În timp ce componenta ta ascultă pentru `pointerdown`, `pointerup`, `pointercancel`, `mousedown`, `mouseup` sau `click` pe `document`, așa cum face un popup deschis pentru a se închide la apăsări în exterior, fiecare apăsare ajunge la acei listeneri: o apăsare în interiorul componentei tale este transmisă la elementul pe care utilizatorul a apăsat chiar și atunci când nimic nu o gestionează, iar o apăsare în altă parte a paginii este transmisă la `document.body` cu starea butonului, numărul de clicuri și tipul pointerului, dar fără coordonate sau taste modificatoare. Clicurile fără o apăsare, cum ar fi activarea prin tastatură a unui control din afara componentei tale, și apăsările pe barele de derulare ale paginii nu sunt trimise, iar o glisare tactilă din afara componentei tale ajunge doar ca `pointerdown` și `pointercancel`, astfel încât nu închide un popup deschis. Nimic altceva din restul paginii nu trece, așa că, pentru a capta scurtături cu `document.addEventListener('keydown', ...)`, pune un `onKeyDown` pe un element care înfășoară componenta ta. Listener-ele `window` primesc doar `error` și `unhandledrejection`. Mișcările indicatorului traversează doar peste elementele care au un handler de mișcare, iar capturarea indicatorului rămâne pe pagină, motiv pentru care o glisare se oprește imediat ce indicatorul părăsește acele elemente. `event.preventDefault()` nu trece nici el; trimiterea formularelor, `dragover`/`drop` și clicurile pe linkuri sunt deja protejate pentru tine.### Atribute și stilizarediff --git a/packages/twenty-docs/ro/developers/extend/apps/logic/connections.mdx b/packages/twenty-docs/ro/developers/extend/apps/logic/connections.mdxindex fb216e13611..d14edf617a5 100644--- a/packages/twenty-docs/ro/developers/extend/apps/logic/connections.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/logic/connections.mdx@@ -508,7 +508,7 @@ Fiecare conexiune are unul dintre două domenii de aplicare:`scope` al furnizorului stabilește pe care îl primesc noile sale conexiuni:* `scope: 'WORKSPACE'` (implicit) — aplicația funcționează cu conexiuni partajate cu spațiul de lucru. **Adăugare conexiune** în setările spațiului de lucru ale aplicației creează o conexiune partajată în spațiul de lucru.-* `scope: 'USER'` — fiecare membru își conectează propriul cont, creând conexiuni personale. Membrii le adaugă, le reconectează și le elimină din pagina aplicației, la **Setări > Utilizator > Preferințe aplicații**, ceea ce necesită permisiunea `CONNECTED_ACCOUNTS` (Aplicații utilizator). Setările spațiului de lucru ale aplicației nu au un buton **Adăugare conexiune** pentru un furnizor `USER`.+* `scope: 'USER'` — fiecare membru își conectează propriul cont, creând conexiuni personale. Membrii le adaugă, le reconectează și le elimină din pagina aplicației, în **Setări > Utilizator > Preferințe aplicații**, ceea ce necesită permisiunea Aplicații utilizator. Setările spațiului de lucru ale aplicației nu au un buton **Adăugare conexiune** pentru un furnizor `USER`.<Note>**Preferințe aplicații** nu este încă activată în fiecare spațiu de lucru: acolo unde nu este activată,@@ -520,7 +520,7 @@ Un furnizor are exact un domeniu de aplicare. Dacă aplicația ta are nevoie atO conexiune are întotdeauna scopul furnizorului său, iar scopul unui furnizor face parte din identitatea sa: o versiune ulterioară nu poate modifica `scope` al unui furnizor existent, iar actualizarea este refuzată dacă încearcă acest lucru. Pentru a muta un serviciu dintr-un scop în altul, declarați un furnizor nou cu un `universalIdentifier` nou și eliminați-l pe cel vechi. Actualizarea elimină apoi furnizorul vechi și fiecare conexiune realizată cu acesta prin fluxul obișnuit de deconectare (`onDisconnectLogicFunction`, revocarea tokenului, curățarea canalului), iar membrii se conectează din nou prin noul furnizor.-Adăugarea sau reconectarea unei conexiuni **Doar pentru mine** necesită permisiunea `CONNECTED_ACCOUNTS`, iar adăugarea sau reconectarea uneia **partajate în spațiul de lucru** necesită permisiunea `APPLICATIONS`.+Adăugarea sau reconectarea unei conexiuni **Doar pentru mine** necesită permisiunea Aplicații utilizator, iar adăugarea sau reconectarea uneia **Partajată în spațiul de lucru** necesită permisiunea Aplicații spațiu de lucru.Folosește conexiunea potrivită pentru fiecare handler:diff --git a/packages/twenty-docs/ro/developers/extend/apps/logic/inbox.mdx b/packages/twenty-docs/ro/developers/extend/apps/logic/inbox.mdxindex e511567e482..d8f2db43ef9 100644--- a/packages/twenty-docs/ro/developers/extend/apps/logic/inbox.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/logic/inbox.mdx@@ -92,4 +92,34 @@ await sendInboxMessage({* O mențiune doar de randare. Acesta nu adaugă membrul la conversație sau îi notifică, așa că listează pe toți cei care ar trebui să primească mesajul în `workspaceMemberIds`.* `INBOX_ASSISTANT_MENTION` este textul pe care îl scrie compozitorul atunci când un membru menționează asistentul (`@Ada`), așa că mesajele tale îl numesc în același mod.+## Atașarea înregistrărilor la o conversație++`attachRecordToInboxThread()` asociază o conversație cu o înregistrare, iar `detachRecordFromInboxThread()` elimină asocierea.++```ts src/logic-functions/file-call-recap.ts+import {+ attachRecordToInboxThread,+ sendInboxMessage,+} from 'twenty-sdk/logic-function';++const { threadId } = await sendInboxMessage({+ workspaceMemberIds: [owner.id],+ threadKey: `call-recap-${call.id}`,+ idempotencyKey: `call-recap-${call.id}`,+ title: `Recap of ${call.title}`,+ text: call.summary,+});++await attachRecordToInboxThread({+ threadId,+ objectNameSingular: 'company',+ recordId: company.id,+});+```++* Ambele folosesc `threadId` al conversației și înregistrarea ca `objectNameSingular` și `recordId`. O conversație poate fi asociată cu persoane, companii, oportunități și înregistrări de obiecte personalizate.+* Ambele sunt idempotente: asocierea aceleiași înregistrări de două ori păstrează o singură asociere, iar eliminarea asocierii unei înregistrări care nu este asociată nu modifică nimic.+* Apelul rulează cu același acces ca [trimiterea unui mesaj](#who-sends-the-message), care necesită permisiunea `AI`. Un membru trebuie să poată edita conversația, iar aplicația dvs. poate acționa asupra unei conversații pe care a scris-o ea însăși sau asupra uneia care a fost acordată rolului său implicit; în caz contrar, apelul eșuează cu `THREAD_NOT_FOUND`.+* Înregistrarea trebuie să poată fi citită cu acel acces, altfel apelul eșuează cu `RECORD_NOT_FOUND`.+<PageBanner illustration="card-page-inbox" />diff --git a/packages/twenty-docs/ro/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/ro/developers/extend/apps/logic/logic-functions.mdxindex b4803d1bb98..da440b00837 100644--- a/packages/twenty-docs/ro/developers/extend/apps/logic/logic-functions.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/logic/logic-functions.mdx@@ -294,28 +294,25 @@ export default defineLogicFunction({Endpoint-ul este accesibil la:```-POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionId+POST https://your-twenty-server.com/webhooks/server/:applicationRegistrationId/:resolverLogicFunctionUniversalIdentifier```-Identificatorul este `id` al resolverului: cheia primară pe care serverul o atribuie când aplicația este sincronizată pentru prima dată în spațiul de lucru al proprietarului, nu `universalIdentifier` din manifestul dvs. Citiți-l din API-ul `/metadata` al spațiului de lucru al proprietarului, apoi înregistrați acel URL la furnizor:+Primul segment este ID-ul înregistrării aplicației dvs., iar al doilea este `universalIdentifier` al resolver-ului din manifestul dvs. O rută se rezolvă doar către un resolver al acelei înregistrări, în spațiul de lucru al proprietarului. Când aplicația dvs. înregistrează webhook-ul propriu-zis, construiți URL-ul dintr-o funcție logică folosind `getServerRouteUrl`; Twenty injectează URL-ul de bază al rutelor de server ale aplicației dvs. ca `TWENTY_SERVER_ROUTES_URL`:-```graphql-query {- findManyLogicFunctions {- id- name- universalIdentifier- }-}+```ts+import { getServerRouteUrl } from 'twenty-sdk/utils';++const destinationUrl = getServerRouteUrl(+ INVOICE_PAID_RESOLVER_UNIVERSAL_IDENTIFIER,+);```<Note>- Un URL care conține `universalIdentifier` al resolver-ului încă se rezolvă,- deocamdată, iar răspunsul conține un header `Deprecation`. Un `universalIdentifier` este- unic pentru fiecare spațiu de lucru, nu la nivel global: dacă o altă înregistrare deținută de un- spațiu de lucru diferit declară același identificator, platforma răspunde cu `404` pentru acel- URL în loc să aleagă între ele. Mutați URL-urile înregistrate la- furnizorii dvs. în forma `id`.+ URL-urile care conțin doar `id` sau `universalIdentifier` ale resolverului+ (`/webhooks/server/:identifier`) sunt încă rezolvate deocamdată, iar ambele răspund cu+ un antet `Deprecation`. Forma `universalIdentifier` returnează `409` atunci când două+ înregistrări declară același identificator. Mutați URL-urile înregistrate la+ furnizorii dvs. în formularul de înregistrare.</Note>**Răspunsul la un GET de verificare.** Unii furnizori verifică un punct final înainte de a livra către acesta, trimițând un `GET` care conține o provocare la același URL către care vor trimite ulterior evenimente prin `POST` — WhatsApp Cloud API de la Meta este unul dintre aceștia. O rută de server răspunde numai la `POST`, cu excepția cazului în care specifici altfel, așa că declară ambele metode:diff --git a/packages/twenty-docs/ro/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/ro/developers/extend/apps/logic/skills-and-agents.mdxindex 7f3714da9b3..7da7c6bce73 100644--- a/packages/twenty-docs/ro/developers/extend/apps/logic/skills-and-agents.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/logic/skills-and-agents.mdx@@ -103,6 +103,39 @@ Note despre schemă:* `required` (opțional) enumeră proprietățile pe care modelul trebuie să le returneze întotdeauna.* `additionalProperties: false` (opțional) interzice orice proprietate care nu este declarată în `properties`.+</Accordion>+<Accordion title="defineMcpServer" description="Expuneți un server MCP extern către IA spațiului de lucru (beta)">++<Warning>+ Serverele MCP sunt în versiune beta și nu sunt încă active: le puteți declara, dar spațiile de lucru nu le pot folosi instrumentele până când funcționalitatea nu este lansată.+</Warning>++Utilizați `defineMcpServer()` pentru a livra un server MCP la distanță (HTTP streaming) împreună cu aplicația dvs., astfel încât IA spațiului de lucru să îi poată utiliza instrumentele fără a sincroniza datele respective în Twenty:++```ts src/mcp-servers/github.ts+import { defineMcpServer } from 'twenty-sdk/define';++import { GITHUB_CONNECTION_PROVIDER_UNIVERSAL_IDENTIFIER } from 'src/constants/universal-identifiers';++export default defineMcpServer({+ universalIdentifier: '0b6c4f7e-3d5a-4a8e-9a0d-6f1e2c3b4a01',+ name: 'github',+ label: 'GitHub',+ url: 'https://api.githubcopilot.com/mcp/',+ connectionProvider: {+ universalIdentifier: GITHUB_CONNECTION_PROVIDER_UNIVERSAL_IDENTIFIER,+ },+});+```++Puncte cheie:+* `name` este în snake_case (litere mici, cifre și caractere de subliniere, începe cu o literă, maximum 32 de caractere) și este unic în spațiul de lucru. Acesta este prefixul numelor instrumentelor serverului.+* `url` trebuie să fie un URL HTTP sau HTTPS.+* `connectionProvider` (opțional) face referire la un [furnizor de conexiune](/ro/developers/extend/apps/logic/connections) declarat de aceeași aplicație. Apelurile trimit tokenul de acces al conexiunii respective ca token Bearer. Omiteți-l pentru un server public.+* URL-ul nu se poate modifica într-o versiune ulterioară cât timp este asociat un furnizor de conexiune, astfel încât tokenurile să nu fie trimise niciodată către o altă gazdă.+* Spațiile de lucru pot dezactiva serverul; o versiune ulterioară a aplicației păstrează această opțiune.+* Necesită `"engines": { "twenty": ">=2.53.0" }`.+</Accordion><Accordion title="runAgent" description="Rulează un agent dintr-o funcție logică">diff --git a/packages/twenty-docs/ro/developers/extend/apps/logic/workflows.mdx b/packages/twenty-docs/ro/developers/extend/apps/logic/workflows.mdxindex 5c48071a5b9..928fa98d2af 100644--- a/packages/twenty-docs/ro/developers/extend/apps/logic/workflows.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/logic/workflows.mdx@@ -68,7 +68,7 @@ export default defineWorkflow({Puncte cheie:-* Fluxul de lucru, declanșatorul său și fiecare pas au nevoie de propriul `universalIdentifier`. Păstrați-le stabile între versiuni: astfel Twenty identifică fluxul de lucru instalat la următoarea instalare.+* Fluxul de lucru și fiecare pas au nevoie de propriul `universalIdentifier`, iar declanșatorul poate avea unul. Păstrați-le stabile între versiuni: astfel Twenty identifică fluxul de lucru instalat la următoarea instalare.* `nextStepIds` conectează graful. Declanșatorul indică spre primii pași, iar fiecare pas indică spre pașii care se execută după acesta.* Un pas citește rezultatul anterior cu `{{trigger.\<path>}}` sau `{{\<step universalIdentifier>.\<path>}}`.* Compilarea validează întreaga definiție: tipurile de declanșatoare sau pași neacceptate, legăturile de pași defecte și referințele la pași necunoscuți o fac să eșueze.@@ -95,6 +95,8 @@ O referință pe care Twenty nu o poate rezolva face instalarea să eșueze.Un flux de lucru manual fără `availability` nu primește nicio intrare în meniul de comenzi.+Fiecare declanșator acceptă, de asemenea, opțional `name`, `position` și `outputSchema`, care doar determină cum arată fluxul de lucru în editor. Fără acestea, Twenty folosește un nume precum `Manual trigger`, plasează declanșatorul în partea de sus a pânzei și calculează schema de ieșire din setări.+Un flux de lucru webhook ascultă la `https://\<your-twenty-domain>/webhooks/workflows/\<workspaceId>/\<workflowId>`, unde `workflowId` este id-ul fluxului de lucru instalat. Corpul cererii este disponibil ca `{{trigger.\<path>}}`.## Pași@@ -126,7 +128,8 @@ Intrările lor corespund pașilor din [constructorul de fluxuri de lucru](/ro/usAplicația personalizată a spațiului de lucru deține fluxurile de lucru create în constructorul de fluxuri de lucru, iar codul este la fel de autoritar pentru acestea ca și constructorul:-* `twenty app pull` scrie fiecare dintre acestea din versiunea sa activă, cea publicată ultima dată de constructor. Un flux de lucru a cărui versiune activă utilizează setări pe care un fișier `defineWorkflow()` nu le poate exprima, precum un pas Code sau un declanșator redenumit de constructor, este semnalat și lăsat pe loc.+* `twenty app pull` scrie fiecare dintre acestea din versiunea sa activă, cea publicată ultima dată de constructor. Un flux de lucru a cărui versiune activă folosește setări pe care un fișier `defineWorkflow()` nu le poate exprima, precum un pas Code, este raportat și lăsat pe loc.+* Un flux de lucru preluat păstrează ce a stocat editorul: un declanșator fără `universalIdentifier`, numele declanșatorului din editor, o `position` de `null` pentru un nod pe care editorul nu l-a plasat niciodată și un `outputSchema` care diferă de cel calculat. Aceste câmpuri necesită twenty-sdk 2.53.0 sau o versiune ulterioară, aplicate pe un server cu 2.53.0 sau o versiune ulterioară: versiunile mai vechi le resping ca chei necunoscute.* `twenty app apply` publică la fel ca constructorul. Un flux de lucru a cărui definiție corespunde versiunii sale active este lăsat neschimbat. În caz contrar, versiunea activă este arhivată, iar definiția devine o nouă versiune activă, astfel încât rulările anterioare păstrează versiunea pe care au rulat.* Utilizatorii continuă să editeze aceste fluxuri de lucru în editor, iar următorul pull readuce modificările lor.diff --git a/packages/twenty-docs/ro/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/ro/developers/extend/apps/operations/cli.mdxindex df87f875ef3..28a0de5e17b 100644--- a/packages/twenty-docs/ro/developers/extend/apps/operations/cli.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/operations/cli.mdx@@ -110,7 +110,7 @@ Alte comenzi pentru aplicații:| `app plan` | Previzualizați modificările de metadate pe care le-ar face o aplicare || `app apply` | Compilați, încărcați și sincronizați aplicația || `app generate-client` | Regenerați clientul API tipizat fără sincronizare |-| `app pull` | Scrieți metadatele aplicației instalate înapoi în sursa locală |+| `app pull` | Restaurează metadatele, traducerile și dependențele stocate || `app translations extract` | Extrage șirurile traducibile în cataloagele din `locales/` || `app publish` | Publicați aplicația pe npm sau într-un registru privat Twenty || `app install` | Instalați în spațiul de lucru un pachet de aplicație deja înregistrat |diff --git a/packages/twenty-docs/ro/developers/extend/apps/operations/marketplace-review.mdx b/packages/twenty-docs/ro/developers/extend/apps/operations/marketplace-review.mdxindex 7f407222695..3322c0aa2c2 100644--- a/packages/twenty-docs/ro/developers/extend/apps/operations/marketplace-review.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/operations/marketplace-review.mdx@@ -1,57 +1,54 @@----title: Verificarea marketplace-ului (în curs)-description: Cerințe propuse pentru ca aplicațiile terțe să primească o insignă Verificată.+title: Revizuirea marketplace-ului+description: Cerințe de securitate și calitate pe care trebuie să le îndeplinească fiecare aplicație pentru a fi listată în marketplace.---import { PageBanner } from "/snippets/page-banner.mdx"-## Cum funcţionează verificarea+## Cum funcționează revizuirea-<Warning>- **În curs de elaborare.** Această pagină și cerințele sale se pot schimba. Verificarea terților- nu este încă disponibilă. Consultați- [Publicare](/ro/developers/extend/apps/operations/publishing#marketplace-visibility-and-review)- pentru comportamentul actual al marketplace-ului.-</Warning>+Fiecare aplicație listată în marketplace a trecut de revizuirea de securitate și calitate a Twenty. Publicarea pe npm nu listează automat o aplicație: aceasta rămâne nelistată+până la finalizarea revizuirii. Consultați+[Publicare](/ro/developers/extend/apps/operations/publishing#marketplace-visibility-and-review)+pentru a afla cum funcționează listarea.-Verificarea se aplică unei versiuni și unui pachet exacte ale aplicației. Fiecare actualizare necesită revizuire și-aprobare din partea Twenty. Aplicațiile verificate pot fi reevaluate pe măsură ce dependențele sau serviciile-evoluează.+Aplicațiile listate pot fi reevaluate pe măsură ce ele, dependențele lor sau serviciile de care+se bazează evoluează și pot fi eliminate din listă dacă nu mai îndeplinesc lista de verificare.-## Listă de verificare pentru evaluare+## Listă de verificare pentru revizuire-Toate elementele aplicabile trebuie să fie aprobate. Recomandăm utilizarea unui agent pentru autoevaluarea-fiecărui criteriu cu dovezi și remedierile necesare înainte de trimitere.+Toate elementele aplicabile trebuie să treacă. Recomandăm utilizarea unui agent pentru a autoevalua+fiecare criteriu cu dovezi și corecțiile necesare înainte de trimitere.-* [ ] **Editor.** [Revendicați-vă aplicația](/ro/developers/extend/apps/operations/publishing#claiming-your-app)+* [ ] **Editor.** [Revendicați aplicația](/ro/developers/extend/apps/operations/publishing#claiming-your-app)și [publicați cu proveniență](/ro/developers/extend/apps/operations/publishing#ci-publishing).* [ ] **Securitate.** Treceți de revizuirea internă de securitate a Twenty și remediați- constatările blocante.-* [ ] **Permisiuni.** Solicitați doar+ constatările care blochează.+* [ ] **Permisiuni.** Solicitați numai[permisiunile](/ro/developers/extend/apps/config/roles) necesare pentru funcționalitățile aplicației.-* [ ] **Funcționalitate.** Configurarea și fluxurile de lucru principale sunt ușor de urmat și funcționează conform- descrierii, fără blocări, activitate pierdută sau înregistrări duplicate. Fără funcționalități de tip substituent- sau controale nefuncționale.-* [ ] **Performanță.** Respectați limitele de rată partajate pentru API-uri/sarcini, gestionați limitarea și+* [ ] **Funcționalitate.** Configurarea și fluxurile de lucru de bază sunt ușor de urmat și funcționează conform+ descrierii, fără blocări, muncă pierdută sau înregistrări duplicate. Fără funcționalități+ substitutive sau controale defecte.+* [ ] **Performanță.** Respectați limitele de frecvență partajate pentru API/joburi, gestionați limitarea șiurmați[bunele practici de dezvoltare a aplicațiilor](/ro/developers/extend/apps/getting-started/good-practices).-* [ ] **Utilitate.** Finalizați o sarcină CRM relevantă pentru un public mai larg decât- configurarea unui singur client. Conectorii mici și automatizările fără interfață sunt eligibile.-* [ ] **Experiență nativă.** Reutilizați obiectele, vizualizările și fluxurile de lucru native, după caz.- Dacă aplicația are o interfață cu utilizatorul, utilizați+* [ ] **Utilitate.** Finalizați o sarcină CRM semnificativă pentru un public mai larg decât+ configurarea unui singur client. Conectorii mici și automatizările fără interfață se califică.+* [ ] **Experiență nativă.** Reutilizați obiecte, vizualizări și fluxuri de lucru native, după caz.+ Dacă aplicația are o interfață UI, utilizați[`twenty-ui`](/ro/developers/extend/apps/layout/front-components#using-twenty-ui-components)- și respectați machetele, interacțiunile și convențiile de accesibilitate ale Twenty.+ și respectați aspectele, interacțiunile și convențiile de accesibilitate ale Twenty.* [ ] **Confidențialitate.** Explicați ce date părăsesc spațiul de lucru, unde ajung și de ce,inclusiv furnizorii de IA, cât timp sunt păstrate și cum pot fi șterse.-* [ ] **Întreținere și compatibilitate.** Declarați versiunile Twenty acceptate, mențineți- identificatorii entităților stabili și remediați în timp erorile critice și integrările nefuncționale.-* [ ] **Siglă și galerie.** Furnizați o siglă originală, ușor de recunoscut și imagini- finisate ale aplicației reale. Urmați- [regulile pentru imagini](/ro/developers/extend/apps/operations/publishing#marketplace-metadata).+* [ ] **Întreținere și compatibilitate.** Declarați versiunile Twenty acceptate, păstrați+ stabili identificatorii entităților și remediați în timp erorile critice și integrările defecte.+* [ ] **Siglă și galerie.** Furnizați o siglă originală, ușor de recunoscut, și imagini finisate+ ale aplicației reale. Urmați+ [ghidurile pentru imagini](/ro/developers/extend/apps/operations/publishing#marketplace-metadata).* [ ] **Listare și README.** Descrieți cu acuratețe funcționalitățile și afilierile în- nume, descriere și capturi de ecran. Păstrați README-ul concis, bine formatat+ nume, descriere și capturile de ecran. Păstrați README-ul scurt, bine formatatși axat pe valoarea aplicației.-* [ ] **Prețuri.** Specificați clar dacă aplicația este gratuită sau cu plată, prețurile planurilor,+* [ ] **Prețuri.** Indicați clar dacă aplicația este gratuită sau contra cost, prețurile planurilor,frecvența facturării și orice servicii terțe cu plată necesare.* [ ] **Documentație și asistență.** Furnizați instrucțiuni de configurare, un exemplu funcționalși un contact pentru asistență. Dacă utilizați rute partajate, finalizațidiff --git a/packages/twenty-docs/ro/developers/extend/apps/operations/overview.mdx b/packages/twenty-docs/ro/developers/extend/apps/operations/overview.mdxindex c9373409c31..c5e684f732b 100644--- a/packages/twenty-docs/ro/developers/extend/apps/operations/overview.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/operations/overview.mdx@@ -42,8 +42,8 @@ import { CardTitle } from "/snippets/card-title.mdx"Construiește, implementează un tarball, publică pe npm, instalează.</Card><Card href="/ro/developers/extend/apps/operations/marketplace-review" img="/images/documentation/banner-icons-v2/permissions.svg">- <CardTitle>Verificare Marketplace (WIP)</CardTitle>- Propune verificări de securitate, calitate și operaționale pentru versiunile de aplicații terțe.+ <CardTitle>Revizuire Marketplace</CardTitle>+ Verificări de securitate, calitate și operaționale pe care o aplicație trebuie să le treacă pentru a fi listată.</Card><Card href="/ro/developers/extend/apps/operations/monitoring" img="/images/user-guide/halftone/card-page-monitoring.svg"><CardTitle>Monitorizare</CardTitle>diff --git a/packages/twenty-docs/ro/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/ro/developers/extend/apps/operations/publishing.mdxindex 3dc0eaa8631..da69af41a0b 100644--- a/packages/twenty-docs/ro/developers/extend/apps/operations/publishing.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/operations/publishing.mdx@@ -223,7 +223,7 @@ Fluxurile de lucru `ci.yml` și `cd.yml` fac referire la acțiuni reutilizabile## Publicarea pe npm-Publicarea pe npm face ca aplicația ta să fie eligibilă pentru marketplace-ul Twenty. După sincronizarea catalogului și orice [configurare necesară a rutelor de server](#setting-up-server-routes), spațiile de lucru o pot răsfoi, instala și actualiza din interfața cu utilizatorul. Aplicațiile comunității apar când utilizatorii dezactivează filtrul **Doar verificate**.+Publicarea pe npm face ca aplicația ta să fie eligibilă pentru marketplace-ul Twenty. După sincronizarea catalogului și orice [setare necesară a rutelor de server](#setting-up-server-routes), spațiile de lucru o pot răsfoi, instala și actualiza din interfață după ce trece de [evaluarea Marketplace](/ro/developers/extend/apps/operations/marketplace-review).### Cerințe@@ -372,17 +372,13 @@ Dacă întâmpini probleme la revendicarea aplicației tale, contactează-ne peAceastă configurare este deja gestionată pentru tine pe Twenty Cloud.</Accordion>-## Vizibilitatea și verificarea în marketplace+## Vizibilitate și evaluare în Marketplace-Revendicarea stabilește proprietatea; nu acordă o insignă **Verificată**. Marketplace-ul afișează implicit **Doar verificate**. Pentru a găsi aplicații ale comunității, accesează **Setări > Aplicații > Marketplace**, deschide filtrul și debifează **Doar verificate**. De asemenea, poți partaja pagina de instalare directă a aplicației tale folosind **Aplicațiile mele > aplicația ta > Distribuire > Copiază linkul de partajare**.+Fiecare aplicație listată în Marketplace a trecut de evaluarea Twenty privind securitatea și calitatea. O aplicație publicată recent rămâne nelistată până trece de [evaluarea Marketplace](/ro/developers/extend/apps/operations/marketplace-review); revendicarea stabilește proprietatea, dar nu o listează.-Eticheta Verificată se aplică în prezent aplicațiilor întreținute de Twenty, pentru care echipa poate garanta securitatea și calitatea. Aplicațiile terților pot fi publicate și instalate fără această etichetă.+O aplicație nelistată poate fi totuși instalată. În **Setări > Aplicații > Marketplace**, deschideți filtrul și activați **Afișează aplicațiile nelistate** sau partajați pagina de instalare directă a aplicației folosind **Aplicațiile mele > aplicația dvs. > Distribuire > Copiere link de partajare**. Spațiile de lucru văd un avertisment că aplicația nu a fost evaluată de Twenty.-[Lista de verificare propusă pentru evaluarea marketplace-urilor terțe](/ro/developers/extend/apps/operations/marketplace-review)-este în curs de elaborare. Descrie criterii de evaluare și dovezi specifice versiunii,-nu un program de certificare disponibil.--Dacă aplicația ta încă lipsește cu **Doar verificate** dezactivat, confirmă că sincronizarea catalogului s-a finalizat, că toate variabilele de server necesare sunt completate și că orice configurare a rutelor de server este finalizată.+Dacă aplicația dvs. este listată, dar încă lipsește din Marketplace, confirmați că sincronizarea catalogului s-a finalizat, că toate variabilele de server necesare sunt completate și că orice setare a rutelor de server este finalizată.## Instalarea aplicațiilordiff --git a/packages/twenty-docs/ro/developers/extend/apps/operations/sync-and-recovery.mdx b/packages/twenty-docs/ro/developers/extend/apps/operations/sync-and-recovery.mdxindex 00f75337ea3..a531b443004 100644--- a/packages/twenty-docs/ro/developers/extend/apps/operations/sync-and-recovery.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/operations/sync-and-recovery.mdx@@ -23,7 +23,7 @@ Dezvoltarea locală de aplicații se învârte în jurul **sincronizării**: CLI| Previzualizează modificările **fără a le aplica** | `twenty app plan` | Calculează și afișează diff-ul; nu scrie nimic. || Sincronizare fără a șterge nimic | `twenty app apply --no-prune` | Creează și actualizează numai: entitățile care există în spațiul de lucru, dar nu și în sursa ta, sunt lăsate neatinse. Acceptat și de `plan` și `dev`. || Curățați aplicația Custom din spațiul de lucru | `twenty app apply --prune` | Acea aplicație păstrează entitățile care lipsesc din sursă, cu excepția cazului în care transmiteți `--prune`. Acceptat și de `plan` și `dev`. |-| Regenerați sursa locală din spațiul de lucru | `twenty app pull` | **Experimental.** Scrie aplicația instalată înapoi în fișierele de definire. Consultați mai jos. |+| Regenerați sursa locală din spațiul de lucru | `twenty app pull` | **Experimental.** Restaurează fișierele define, traducerile și dependențele stocate. Consultați mai jos. || Elimină aplicația din spațiul de lucru | `twenty app uninstall` | Adaugă `--yes` pentru a sări peste prompt. || Trimite un tarball către un server | `twenty app publish --private` | Necesită o versiune `package.json` **strict mai mare** — vezi [Publicare](/ro/developers/extend/apps/operations/publishing). || Publică în marketplace (npm) | `twenty app publish` | — |@@ -108,17 +108,23 @@ Un plan:înainte de a-l rula și verifică diferențele.</Warning>-`twenty app pull` este inversul lui `apply`: citește o aplicație din spațiul de lucru și o scrie înapoi ca fișiere de definire.+`twenty app pull` este inversul comenzii `apply`: citește o aplicație din spațiul de lucru și îi restaurează fișierele define, traducerile și fișierele de dependențe stocate.```bash-twenty app pull --universal-identifier <universalIdentifier>+twenty app pull --remote dev+twenty app pull --path ./workspace-app --yes --no-input```-Extragerea necesită un proiect existent — creează mai întâi unul cu `twenty app init`, apoi extrage în acesta. Fără `--universal-identifier`, extragerea vizează aplicația declarată de fișierul local `defineApplication()`. Dacă `--universal-identifier` denumește o aplicație diferită de cea declarată de proiectul tău, extragerea refuză să continue în loc să lase două aplicații într-un singur arbore: extrage-o pe aceea în propriul director. Dacă proiectul are un fișier de aplicație al cărui identificator nu poate fi citit, de obicei deoarece dependențele nu sunt instalate, comanda pull refuză și îți cere să rulezi mai întâi `yarn install`. Adaugă `--verbose` pentru a extinde secțiunile de acoperire ale raportului, care apoi denumesc până la 20 de identificatori per tip de metadate, în loc să afișeze doar totalurile.+În interiorul unei aplicații, pull citește identificatorul local `defineApplication()` și preia aplicația respectivă. În afara unei aplicații, solicită un director și confirmare, creează un proiect local pentru aplicația particularizată a spațiului de lucru selectat, instalează dependențele cu Yarn, apoi preia definițiile. Noul proiect include fișiere de pachet și de configurare, fără entitățile demonstrative ale inițializatorului.++Utilizați `--path` pentru a selecta o aplicație existentă sau un director nou ori gol. Crearea neinteractivă necesită `--path` și `--yes`; pull refuză să suprascrie un director nevid fără legătură. Crearea unui proiect nu înregistrează o aplicație și nu modifică spațiul de lucru. Un proiect SDK existent fără o definiție a aplicației preia, de asemenea, aplicația personalizată. Nu există nicio opțiune `--universal-identifier`.++Dacă instalarea dependențelor eșuează pentru un proiect nou, scaffold-ul este păstrat. Rulați `yarn install` în interiorul acestuia, apoi reîncercați pull. Proiectele existente nu instalează automat dependențele. Dacă identificatorul aplicației lor nu poate fi citit, pull raportează acea eroare în loc să creeze o altă aplicație. Adaugă `--verbose` pentru a extinde secțiunile de acoperire ale raportului, care apoi denumesc până la 20 de identificatori per tip de metadate, în loc să afișeze doar totalurile.**Ce scrie:*** configurația aplicației;+* fișierele de dependențe `package.json` și `yarn.lock` stocate, în rădăcina proiectului;* obiecte, cu câmpurile lor incluse;* câmpuri pe care aplicația ta le-a adăugat obiectelor pe care nu le deține;* indici creați;@@ -137,6 +143,10 @@ Extragerea necesită un proiect existent — creează mai întâi unul cu `twentFiecare entitate ajunge în fișierul care o definește deja, astfel încât o a doua extragere rescrie doar ce s-a schimbat pe server. Un fișier este, de asemenea, rescris atunci când folosește o funcție de definire diferită de cea pe care ar scrie-o pull, de exemplu un rol care a devenit sau a încetat să mai fie rolul implicit. Entitățile noi sunt plasate lângă fișierele existente de același tip, iar un nume generat care ar ajunge într-un fișier fără legătură este calificat în loc să îl suprascrie.+**Fișiere de dependențe.** Când `package.json` sau `yarn.lock` stocat se modifică, pull înlocuiește fișierul local și raportează orice modificări locale suprascrise. Dacă fișierul la distanță nu s-a modificat de la pull-ul anterior, modificările locale sunt păstrate. Lipsa unui fișier la distanță nu șterge fișierul local corespunzător. Când pachetul exportat omite `twenty-sdk`, așa cum face aplicația Custom a spațiului de lucru, pull păstrează dependența SDK locală, astfel încât comenzile CLI să poată încărca în continuare proiectul. Fișierele de dependențe, metadatele și baza de referință sunt scrise împreună și sunt anulate împreună dacă o scriere eșuează.++Rulați `yarn install` după preluarea modificărilor dependențelor. Pull nu instalează pachete, nu rulează scripturi de pachete și nu regenerează clientul tipizat.+**Ce nu scrie:*** **Neexportate încă** — elemente de meniu pentru comenzi și elemente de meniu pentru setări, funcții de logică și componente front-end, furnizori de conexiuni, variabile ale aplicației, active publice, tipuri de activitate în cronologie și sursa stocată a funcțiilor dvs.@@ -145,15 +155,15 @@ Fiecare entitate ajunge în fișierul care o definește deja, astfel încât o a* **Plasate într-un aspect de pagină implicit sau extern** — filele și widgeturile adăugate la un aspect de pagină implicit al motorului sau la unul deținut de altă aplicație sunt scrise ca fișiere autonome `definePageLayoutTab()` și `definePageLayoutWidget()`, deoarece este cunoscut identificatorul la care se atașează.* **Widgeturi pe care exportul nu le poate include încă** — în orice aspect, inclusiv în al dvs., este raportat un widget de tip `VIEW` depreciat, un widget care afișează una dintre propriile componente front-end ale aplicației dvs. sau elemente din meniul de comenzi, ori un widget fără poziție pentru modul de aspect al filei sale, iar aspectul sau fila sunt scrise fără acesta.* **Fluxuri de lucru pe care exportul nu le poate prelua încă** — un flux de lucru modificat în generatorul de fluxuri de lucru de la ultima sincronizare, un flux de lucru de sistem sau privat, unul cu un pas de Cod sau de mesaj de chat, pe care fluxurile de lucru ale aplicației nu îl acceptă, precum și unul care apelează acțiunea fluxului de lucru al unei alte aplicații sunt semnalate și lăsate pe loc. Aplicația Custom a spațiului de lucru este excepția pentru primul și ultimul caz: constructorul publică și fluxurile sale de lucru, iar acestea pot apela acțiunile oricărei aplicații, deci sunt extrase. În schimb, unul dintre fluxurile sale de lucru este raportat atunci când nu are o versiune activă sau când versiunea sa activă utilizează setări pe care o definiție nu le poate exprima. Pașii de e-mail și calendar sunt preluați: un cont partajat cu spațiul de lucru este scris ca `connectedAccountHandle`, în timp ce contul privat și variabilele unui membru sunt păstrate ca atare. În schimb, fluxul de lucru este semnalat atunci când contul unui pas este arhivat, nu mai poate executa pasul sau își partajează adresa cu un cont mai vechi, deoarece aplicarea identificatorului ar selecta un alt cont.-* **Agenți și competențe pe care exportul nu le poate include încă** — o competență dezactivată și un agent cu mai mult de un rol sau legat de o extragere de rol care nu scrie nu sunt scrise, sunt raportate și lăsate pe loc.-* **Starea de rulare a spațiului de lucru** — atribuiri de roluri pentru membri și chei API, webhook-uri, navigare per utilizator și elemente de navigare fixate la o înregistrare, toate excluse prin concepție.+* **Agenți pe care exportul nu îi poate prelua încă** — un agent cu mai mult de un rol sau asociat cu un rol pe care extragerea nu îl scrie este raportat și lăsat pe loc.+* **Starea de rulare a spațiului de lucru**, atașamentele înregistrărilor, atașamentele e-mailurilor, alocările de roluri pentru membri și chei API, webhookurile, navigarea per utilizator și elementele de navigare fixate la o înregistrare, toate excluse prin design, inclusiv pentru aplicația Custom a spațiului de lucru.* **Deținut de o altă aplicație** — raportat, dar niciodată extras.Raportul de la sfârșitul unui pull le listează pe toate, grupate după tip și motiv. Tot ce indică drept nescris există încă în spațiul dvs. de lucru, așa că împingeți înapoi un arbore extras cu `twenty app apply --no-prune` până când sunt acoperite tipurile lipsă. Aplicația Custom din spațiul de lucru aplică deja acest comportament în mod implicit. O aplicare cu curățare (cea implicită pentru celelalte aplicații, `--prune` pentru aplicația Custom) le-ar șterge, iar `twenty app plan` enumeră exact care sunt acestea.**Stare locală spațiului de lucru.** O entitate dezactivată în spațiul de lucru este scrisă ca definiție activă, iar suprascrierile pe care spațiul de lucru le-a efectuat asupra unei entități, cum ar fi o etichetă redenumită, nu sunt scrise. Raportul listează acele rânduri sub „Scrise fără starea lor locală spațiului de lucru”. Aplicarea arborelui înapoi în același spațiu de lucru lasă acea stare neatinsă; un alt spațiu de lucru primește entitatea activă și fără suprascrieri.-**Fișierul de bază.** Pull înregistrează ce a extras în `.twenty/pull-base.json`, care este ignorat de git și specific fiecărui checkout. Acest fișier este cel cu care compară o extragere ulterioară pentru a lăsa neatinse fișierele ale căror entități nu s-au schimbat și pentru a șterge fișierul unei entități care nu mai există în spațiul de lucru. Un checkout fără acesta scrie pur și simplu totul și nu șterge nimic.+**Fișierul de bază.** Pull înregistrează ceea ce a preluat în `.twenty/cli/pull-base.json`, care este ignorat de git și specific fiecărei copii de lucru. Acest fișier este cel cu care compară o extragere ulterioară pentru a lăsa neatinse fișierele ale căror entități nu s-au schimbat și pentru a șterge fișierul unei entități care nu mai există în spațiul de lucru. Un checkout fără acesta scrie pur și simplu totul și nu șterge nimic.## Plan de recuperare în treptediff --git a/packages/twenty-docs/ru/developers/extend/apps/config/application.mdx b/packages/twenty-docs/ru/developers/extend/apps/config/application.mdxindex 752fd5b1723..2deefe465a1 100644--- a/packages/twenty-docs/ru/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/config/application.mdx@@ -55,7 +55,7 @@ export default defineApplication({* Приложение может сообщать о собственном состоянии конфигурации с помощью [`defineHealthCheck()`](/ru/developers/extend/apps/logic/logic-functions#health-check) для того, о чём может знать только само приложение, — например, ключ присутствует, но отозван, или сторонняя учётная запись использует неподходящий тарифный план. `isRequired` охватывает то, что Twenty может увидеть самостоятельно; проверка работоспособности охватывает остальное.* Оба типа переменных принимают `isRequired: true`. Обязательная переменная, которую рабочая область ещё не заполнила, оставляет приложение ненастроенным: на странице его настроек отображается баннер с указанием отсутствующих переменных и кнопкой для перехода на вкладку, где они задаются. Отмечайте как обязательное только то, без чего приложение действительно не может работать — необязательная переменная с разумным значением по умолчанию должна оставаться необязательной.* Оба типа переменных принимают `isDeprecated: true`. Используйте это, чтобы вывести переменную из обращения вместо её удаления: сохранение объявленного ключа сохраняет хранимое значение (удаление уничтожает значение, введённое пользователем), а переменная по-прежнему внедряется, поэтому код сможет обратиться к ней — `process.env.NEW_API_KEY ?? process.env.API_KEY`. Устаревшая переменная исчезает из настроек приложения, как только у неё больше нет значения, и никогда не учитывается при проверке конфигурации приложения, поэтому `isDeprecated` имеет приоритет над `isRequired`.-* Twenty задаёт эти имена для каждого запуска логической функции, поэтому они зарезервированы: `TWENTY_API_URL`, `TWENTY_APP_ACCESS_TOKEN`, `TWENTY_APP_APPLICATION_ACCESS_TOKEN`, `TWENTY_API_KEY`, `TWENTY_FUNCTIONS_URL` и `APPLICATION_ID`. Манифест, объявляющий любое из них как переменную приложения или сервера, отклоняется при синхронизации или публикации приложения.+* Twenty задает эти имена для каждого запуска функции логики, поэтому они зарезервированы: `TWENTY_API_URL`, `TWENTY_APP_ACCESS_TOKEN`, `TWENTY_APP_APPLICATION_ACCESS_TOKEN`, `TWENTY_API_KEY`, `TWENTY_FUNCTIONS_URL`, `TWENTY_SERVER_ROUTES_URL` и `APPLICATION_ID`. Все остальные имена, начинающиеся с `TWENTY_`, также зарезервированы для переменных, которые Twenty добавит позже. Манифест, объявляющий зарезервированное имя в качестве переменной приложения или сервера, отклоняется при синхронизации или публикации приложения.* Чтобы добавить собственные элементы в меню настроек приложения (вместо созданной страницы **Variables**), объявите фронтенд-компонент и укажите его в [`defineSettingsMenuItem()`](/ru/developers/extend/apps/layout/front-components#settings-menu-items) в отдельном файле. Объявите столько элементов, сколько необходимо, и упорядочьте их с помощью `position`; `scope` размещает элемент в настройках рабочего пространства или в настройках каждого участника. Системный элемент **Общие** (автообновление, URL приложения, подключения) всегда отображается первым, а URL приложения показывается только если в приложении есть функции, запускаемые по HTTP.## Запрашиваемые возможности доступа к медиа@@ -191,7 +191,7 @@ const { myUserApplicationVariables } = await client.query({`updateMyUserApplicationVariable` сохраняет собственное значение участника. Он получает `applicationUniversalIdentifier` вашего приложения и записывает значение человека, стоящего за токеном: собственный сеанс участника или токен вашего приложения, когда за ним стоит участник, например во фронтенд-компоненте или логической функции, выполняемой для участника. Токен вашего приложения может указывать только ваше собственное приложение, а токен, за которым никто не стоит, например в задании cron или хуке установки, отклоняется. Пустое значение удаляет собственное значение участника, поэтому он снова получает значение по умолчанию или пустую строку для переменной без значения по умолчанию.-Ему не требуется разрешение `APPLICATIONS`, но требуется `CONNECTED_ACCOUNTS`: в роли участника, а также в роли по умолчанию вашего приложения, если она объявлена, когда вызов выполняется токеном вашего приложения. Если ваше приложение сохраняет пользовательские переменные, добавьте `SystemPermissionFlag.CONNECTED_ACCOUNTS` в `permissionFlagUniversalIdentifiers` его [роли](/ru/developers/extend/apps/config/roles).+Ему не требуется разрешение приложений рабочего пространства, но требуется разрешение пользовательских приложений: в роли участника и, когда вызов выполняется с токеном вашего приложения, также в роли вашего приложения по умолчанию, если она объявлена. Если ваше приложение сохраняет пользовательские переменные, добавьте `SystemPermissionFlag.USER_APPS` в `permissionFlagUniversalIdentifiers` его [роли](/ru/developers/extend/apps/config/roles).## Роль функции по умолчаниюdiff --git a/packages/twenty-docs/ru/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/ru/developers/extend/apps/config/roles.mdxindex 9007b1e622b..2220d30710b 100644--- a/packages/twenty-docs/ru/developers/extend/apps/config/roles.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/config/roles.mdx@@ -50,10 +50,20 @@ export default defineRole({canUpdateFieldValue: false,},],- permissionFlagUniversalIdentifiers: [SystemPermissionFlag.APPLICATIONS],+ permissionFlagUniversalIdentifiers: [SystemPermissionFlag.WORKSPACE_APPS],});```+<Note>+ `SystemPermissionFlag.USER_APPS` и `SystemPermissionFlag.WORKSPACE_APPS`+ доступны в `twenty-sdk` начиная с версии 2.54; в более ранних версиях они называются+ `CONNECTED_ACCOUNTS` и `APPLICATIONS`. Старые имена являются устаревшими псевдонимами+ для тех же флагов, и роль содержит каждый флаг только один раз. Перечисление+ `SystemPermissionFlag`, например с помощью `Object.keys`, по-прежнему включает старые+ имена. API также сообщает об этих флагах под их старыми ключами, например в+ `currentUserWorkspace.permissionFlags`.+</Note>+## Безопасность на уровне строкДля разрешений на уровне строк требуется **план Organization или выше** — см.diff --git a/packages/twenty-docs/ru/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/ru/developers/extend/apps/data/objects.mdxindex 26043219301..5a56b3fed53 100644--- a/packages/twenty-docs/ru/developers/extend/apps/data/objects.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/data/objects.mdx@@ -109,6 +109,7 @@ export default defineObject({* `isLabelSyncedWithName` для объекта или поля синхронизирует имя API с меткой при редактировании метки в настройках. По умолчанию используется значение `false`, поэтому переименование метки не изменяет имя.* `isSearchable: true` для поля включает его значения в полнотекстовый поиск объекта (глобальный поиск и меню команд). Для этого сам объект должен поддерживать поиск, а тип поля должен быть совместим с текстом. Отсутствующее значение означает, что поиск недоступен, за исключением поля идентификатора метки объекта, для которого поиск всегда доступен и которое нельзя исключить. Каждая синхронизация применяет объявленное состояние, поэтому поле, для которого в настройках включили поиск, вернётся к прежнему состоянию при следующей синхронизации приложения, если это не объявлено в манифесте.* `isAuditLogged: false` для поля исключает его изменения из хронологии записи. По умолчанию используется `true`, кроме поля `POSITION`, изменения которого отображаются в хронологии пустыми и никогда не регистрируются. Установите это для полей, которые ваше приложение переписывает по расписанию, например для метки времени последнего контакта или сводной связи, чтобы каждая синхронизация не добавляла строку активности в каждую затронутую запись. Обновление, вся разница которого состоит из не журналируемых для аудита полей, вообще не создаёт активности в хронологии. Как и `isSearchable`, каждая синхронизация обеспечивает объявленное состояние.+* `disabledFieldPermissionActions` в поле перечисляет разрешения поля, которые нельзя предоставить для него: `'canReadFieldValue'`, `'canUpdateFieldValue'` или оба — те же флаги, которые роль задаёт для каждого поля. Пользователи, ключи API, агенты и другие приложения никогда не получают эти действия для поля независимо от разрешений, предоставленных их ролью, а сохранение разрешения поля, предоставляющего одно из них, завершается ошибкой. Собственные логические функции вашего приложения сохраняют их. Например, `['canUpdateFieldValue']` сохраняет значение, которое ваше приложение вычисляет или синхронизирует, например статус или оценку, доступным только для чтения для всех остальных. Это также работает с полями, которые вы добавляете в объекты, не принадлежащие вам, с помощью `defineField()`.* Встроенным полям, определённым здесь, **не** нужен `objectUniversalIdentifier` — он наследуется от родительского объекта. Используйте [`defineField()`](/ru/developers/extend/apps/data/extending-objects), чтобы добавить поля к объектам, которые вам не принадлежат.* Вы можете сгенерировать заготовки новых объектов с помощью `twenty app add object`, который проведёт вас через настройку названий, полей и связей. См. [Architecture → Scaffolding entities](/ru/developers/extend/apps/getting-started/scaffolding).diff --git a/packages/twenty-docs/ru/developers/extend/apps/getting-started/concepts.mdx b/packages/twenty-docs/ru/developers/extend/apps/getting-started/concepts.mdxindex 3dd0497f847..d466101b22e 100644--- a/packages/twenty-docs/ru/developers/extend/apps/getting-started/concepts.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/getting-started/concepts.mdx@@ -22,6 +22,7 @@ your-app/│ ├── front-components/ ← defineFrontComponent│ ├── skills/ ← defineSkill│ ├── agents/ ← defineAgent+│ ├── mcp-servers/ ← defineMcpServer│ ├── views/ ← defineView│ ├── navigation-menu-items/ ← defineNavigationMenuItem│ ├── settings-menu-items/ ← defineSettingsMenuItem@@ -51,6 +52,7 @@ your-app/| **Рабочий процесс** | Готовые рабочие процессы с триггером и шагами | [Рабочие процессы](/ru/developers/extend/apps/logic/workflows) || **Провайдер подключения** | OAuth или пользовательский вход для сторонних учетных записей | [Подключения](/ru/developers/extend/apps/logic/connections) || **Поставщик сообщений** | Отправляет ответы из каналов сообщений приложения через подключение | [Каналы сообщений](/ru/developers/extend/apps/logic/messaging-channels#sending-replies) |+| **Сервер MCP** | Внешний сервер MCP, который может вызывать ИИ рабочего пространства | [Навыки и агенты](/ru/developers/extend/apps/logic/skills-and-agents) || **Представление** | Преднастроенные представления списков записей | [Представления](/ru/developers/extend/apps/layout/views) || **Пункт меню навигации** | Пользовательские элементы боковой панели | [Элементы меню навигации](/ru/developers/extend/apps/layout/navigation-menu-items) || **Макет страницы** | Вкладки и виджеты на странице сведений о записи | [Макеты страниц](/ru/developers/extend/apps/layout/page-layouts) |diff --git a/packages/twenty-docs/ru/developers/extend/apps/layout/front-components.mdx b/packages/twenty-docs/ru/developers/extend/apps/layout/front-components.mdxindex 1a8e45d9318..1b45bfa87d5 100644--- a/packages/twenty-docs/ru/developers/extend/apps/layout/front-components.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/layout/front-components.mdx@@ -164,13 +164,13 @@ export default defineSettingsMenuItem({<Note>Элемент `USER` отображается как вкладка на странице приложения в разделе **Настройки > Настройки- приложения**, где его видит только вошедший в систему участник и только если его- роль предоставляет разрешение `CONNECTED_ACCOUNTS`. Эта страница пока включена не в+ приложения**, где его видит только вошедший участник и только если его+ роль предоставляет разрешение Пользовательские приложения. Эта страница пока включена не вкаждой рабочей области: там, где она не включена, элемент `USER` сохраняется и синхронизируется,но ничто его не отображает.</Note>-Пункт `USER` выполняется от имени участника, который его просматривает. Чтобы хранить данные для каждого пользователя, объявите переменную с `scope: 'USER'`: `getApplicationVariable` возвращает значение просматривающего участника, а ваш компонент сохраняет его с помощью `updateMyUserApplicationVariable`, которая записывает только значение этого участника и требует `SystemPermissionFlag.CONNECTED_ACCOUNTS` в роли вашего приложения, если она объявлена (см. [Чтение и обновление переменных во время выполнения](#reading-and-updating-variables-at-runtime)). Как и элемент `WORKSPACE`, элемент `USER` заменяет созданную форму **Переменные**, поэтому он должен позволять участнику задавать все пользовательские переменные, необходимые вашему приложению. Переменная рабочей области хранит одно значение, общее для всех, поэтому сохранение одним участником перезапишет значение другого.+Пункт `USER` выполняется от имени участника, который его просматривает. Чтобы хранить данные для каждого пользователя, объявите переменную с `scope: 'USER'`: `getApplicationVariable` возвращает значение для просматривающего участника, а ваш компонент сохраняет его с помощью `updateMyUserApplicationVariable`, который записывает значение только этого участника и требует `SystemPermissionFlag.USER_APPS` в роли вашего приложения, если она объявлена (см. [Чтение и обновление переменных во время выполнения](#reading-and-updating-variables-at-runtime)). Как и элемент `WORKSPACE`, элемент `USER` заменяет созданную форму **Переменные**, поэтому он должен позволять участнику задавать все пользовательские переменные, необходимые вашему приложению. Переменная рабочей области хранит одно значение, общее для всех, поэтому сохранение одним участником перезапишет значение другого.<Note>`defineSettingsFrontComponent()` устарела в пользу@@ -658,8 +658,8 @@ const saveMyLanguage = async (language: string) => {* Токен вашего компонента привязан к вашему собственному приложению. `updateOneApplicationVariable` нацелен на него, поэтому `applicationId` необязателен, а указание другого приложения отклоняется. Чтение `applicationVariables` другого приложения отклоняется таким же образом, а приложение из другого рабочего пространства при чтении считается не найденным.* Ключ должен быть объявлен вашим приложением в [`defineApplication()`](/ru/developers/extend/apps/config/application). Запись необъявленного ключа приводит к ошибке «не найдено».* Секретные переменные при чтении возвращаются замаскированными, а не в виде сохранённого значения. Их запись работает как обычно.-* Для чтения `value` переменной и записи в неё требуется разрешение настроек `APPLICATIONS` как для роли вашего приложения, так и для роли вошедшего пользователя, поскольку токен компонента представляет собой пересечение этих двух разрешений. Добавьте `SystemPermissionFlag.APPLICATIONS` в `permissionFlagUniversalIdentifiers` вашей [роли приложения](/ru/developers/extend/apps/config/roles).-* В пользовательскую переменную (`scope: 'USER'`) подставляется значение просматривающего участника, если она не является секретной. `updateOneApplicationVariable` отклоняет её: сохраните её с помощью `updateMyUserApplicationVariable`, как это делает `saveMyLanguage` выше. Она записывает только значение просматривающего участника и не позволяет указать другое приложение. Для неё не требуется разрешение `APPLICATIONS`, но требуется разрешение `CONNECTED_ACCOUNTS` в роли просматривающего участника и в роли вашего приложения, если она объявлена: добавьте `SystemPermissionFlag.CONNECTED_ACCOUNTS` в `permissionFlagUniversalIdentifiers` в вашей [роли приложения](/ru/developers/extend/apps/config/roles). См. [Переменные рабочей области и пользователя](/ru/developers/extend/apps/config/application#workspace-and-user-variables).+* Для чтения и записи `value` переменной требуется разрешение настроек приложений рабочего пространства как для роли вашего приложения, так и для роли вошедшего пользователя, поскольку токен компонента является пересечением этих двух ролей. Добавьте `SystemPermissionFlag.WORKSPACE_APPS` в `permissionFlagUniversalIdentifiers` в вашей [роли приложения](/ru/developers/extend/apps/config/roles).+* В пользовательскую переменную (`scope: 'USER'`) подставляется значение просматривающего участника, если она не является секретной. `updateOneApplicationVariable` отклоняет её: сохраните её с помощью `updateMyUserApplicationVariable`, как это делает `saveMyLanguage` выше. Она записывает только значение просматривающего участника и не позволяет указать другое приложение. Разрешение Приложения рабочего пространства не требуется, но разрешение Пользовательские приложения требуется для роли просматривающего участника и для роли вашего приложения, если она объявлена: добавьте `SystemPermissionFlag.USER_APPS` в `permissionFlagUniversalIdentifiers` в вашей [роли приложения](/ru/developers/extend/apps/config/roles). См. [Переменные рабочей области и пользователя](/ru/developers/extend/apps/config/application#workspace-and-user-variables).### Системные переменные@@ -987,6 +987,8 @@ yarn add -D [email protected]Используйте [`MainButton`](/ru/ui/components/input/main-button) для основных действий и [`LightButton`](/ru/ui/components/input/light-button) для второстепенных действий. Используйте `Button`, `Field`, `Input`, `Select` и другие примитивы из `twenty-ui/primitives/input` для базовых элементов управления и форм. Следуйте документации по частям каждого составного элемента управления, таким как `Field.Root`, `Field.Label` и `Field.Description`.+Передайте `alignItemWithTrigger={false}` в `Select.Positioner`. Выравнивание выбранного элемента по триггеру, используемое в Base UI по умолчанию, требует синхронных измерений макета, которые песочница не может предоставить, поэтому всплывающее окно сворачивается при повторном открытии.+Используйте [`Dropdown`](/ru/ui/components/navigation/dropdown) из `twenty-ui/components/navigation` для меню действий, средств выбора параметров и немодальных панелей форм. Используйте `enqueueSnackbar` из `twenty-sdk/front-component` для уведомлений хоста.Автономные API `Dialog` и `AlertDialog` также экспортируются Twenty UI, но их прямое использование в компонентах фронтенда запрещено. Используйте [API связи с хостом](#host-communication-api) для диалогов.@@ -1151,13 +1153,13 @@ const Card = () => {Обработчики получают типизированные события, созданные на основе события страницы: `PointerEvent`, `MouseEvent`, `KeyboardEvent`, `InputEvent`, `WheelEvent` или `FocusEvent`; эти конструкторы доступны в песочнице для `dispatchEvent()`. Каждое перенаправленное событие также содержит интерфейс синтетического события React (`nativeEvent`, `isDefaultPrevented()`, `isPropagationStopped()`, `persist()`), поэтому код, написанный для событий React, продолжает работать, хотя песочница передаёт объект события непосредственно вашему обработчику.-Событие страницы передаётся, когда элемент, с которым взаимодействовал пользователь, или один из его предков в вашем компоненте имеет обработчик для этого типа события. Оно передаётся один раз, а затем распространяется внутри песочницы так же, как на странице: `event.target` — элемент, с которым взаимодействовал пользователь, `currentTarget` — элемент, обработчик которого выполняется, `stopPropagation()` предотвращает выполнение обработчиков предков, а `relatedTarget` указывает на элемент песочницы, с которого или на который переместился фокус либо указатель, или имеет значение `null`, если этот элемент находится вне вашего компонента. Как и в React, `onFocus` и `onBlur` также выполняются при изменениях фокуса внутри элемента, а `onClickCapture` и другие обработчики перехвата выполняются на фазе перехвата.+Событие страницы пересекает границу, когда элемент, с которым взаимодействовал пользователь, или один из его предков в вашем компоненте имеет обработчик для этого типа события, либо когда это нажатие, которого ожидают ваши слушатели `document` (см. ниже). Оно передаётся один раз, а затем распространяется внутри песочницы так же, как на странице: `event.target` — элемент, с которым взаимодействовал пользователь, `currentTarget` — элемент, обработчик которого выполняется, `stopPropagation()` предотвращает выполнение обработчиков предков, а `relatedTarget` указывает на элемент песочницы, с которого или на который переместился фокус либо указатель, или имеет значение `null`, если этот элемент находится вне вашего компонента. Как и в React, `onFocus` и `onBlur` также выполняются при изменениях фокуса внутри элемента, а `onClickCapture` и другие обработчики перехвата выполняются на фазе перехвата.Обработчики, которые библиотека добавляет с помощью `React.cloneElement`, например используемые свойством `render` Base UI, выполняются после собственных обработчиков элемента, а не заменяют их, поэтому передача `onClick: undefined` в `cloneElement` не удаляет обработчик элемента. Обработчик на элементе `render` Base UI всё ещё может вызвать `event.preventBaseUIHandler()`, чтобы пропустить собственный обработчик Base UI.`event.target.value` и `checked` отражают состояние контрола после того, как браузер применил изменение пользователя: в обработчиках `input`, `change`, `click`, `blur` и `focusout`, а также в обработчиках `keyup` для `value`. В обработчиках `keydown`, `beforeinput` и указателя они содержат значение и состояние checked контрола на момент его последнего изменения, независимо от того, что отслеживает ваш компонент: обработчик `Enter` считывает введённый к этому моменту текст, но обработчик для печатной клавиши ещё не видит эту клавишу, поэтому считывайте актуальные значения из контролируемого input или обработчика `onChange`.-Обработчики `document` получают события, переданные из вашего компонента, но не события, происходящие в других местах страницы, поэтому, чтобы перехватывать сочетания клавиш с помощью `document.addEventListener('keydown', ...)`, добавьте `onKeyDown` к элементу, который оборачивает ваш компонент. Обработчики `window` получают только `error` и `unhandledrejection`. Перемещения указателя передаются только над элементами, имеющими обработчик перемещения, а захват указателя остаётся на странице, поэтому перетаскивание прекращается, как только указатель покидает эти элементы. `event.preventDefault()` тоже не пересекается; форма представления, `dragover`/`drop` и ссылки уже охраняются для вас.+Слушатели `document` получают события, пересекающие границу из вашего компонента, за одним исключением для нажатий. Когда ваш компонент прослушивает `pointerdown`, `pointerup`, `pointercancel`, `mousedown`, `mouseup` или `click` в `document`, как это делает открытое всплывающее окно, чтобы закрываться при нажатиях снаружи, все нажатия достигают этих слушателей: нажатие внутри вашего компонента отправляется элементу, который нажал пользователь, даже если ничто его не обрабатывает, а нажатие в другом месте страницы отправляется в `document.body` со своим состоянием кнопки, числом кликов и типом указателя, но без координат или клавиш-модификаторов. Клики без нажатия, например при активации клавиатурой элемента управления вне вашего компонента, и нажатия на полосах прокрутки страницы не отправляются, а касательное движение за пределами вашего компонента приходит только как `pointerdown` и `pointercancel`, поэтому оно не закрывает открытое всплывающее окно. Ничто другое из остальной части страницы не пересекает границу, поэтому, чтобы перехватывать сочетания клавиш с помощью `document.addEventListener('keydown', ...)`, добавьте `onKeyDown` к элементу, который оборачивает ваш компонент. Обработчики `window` получают только `error` и `unhandledrejection`. Перемещения указателя передаются только над элементами, имеющими обработчик перемещения, а захват указателя остаётся на странице, поэтому перетаскивание прекращается, как только указатель покидает эти элементы. `event.preventDefault()` тоже не пересекается; форма представления, `dragover`/`drop` и ссылки уже охраняются для вас.### Атрибуты и стильdiff --git a/packages/twenty-docs/ru/developers/extend/apps/logic/connections.mdx b/packages/twenty-docs/ru/developers/extend/apps/logic/connections.mdxindex e2b4e8e40e4..91c250541d0 100644--- a/packages/twenty-docs/ru/developers/extend/apps/logic/connections.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/logic/connections.mdx@@ -508,7 +508,7 @@ await reportConnectionAuthFailure({`scope` провайдера определяет, какую область действия получат его новые подключения:* `scope: 'WORKSPACE'` (по умолчанию) — приложение работает с подключениями, общими для рабочего пространства. **Добавить подключение** в настройках рабочего пространства приложения создает общее для рабочего пространства подключение.-* `scope: 'USER'` — каждый участник подключает свою учетную запись, создавая личные подключения. Участники добавляют, повторно подключают и удаляют их на странице приложения **Настройки > Пользователь > Настройки приложений**, для которой требуется разрешение `CONNECTED_ACCOUNTS` (Пользовательские приложения). В настройках рабочего пространства приложения нет кнопки **Добавить подключение** для поставщика `USER`.+* `scope: 'USER'` — каждый участник подключает свою учетную запись, создавая личные подключения. Участники добавляют, повторно подключают и удаляют их на странице приложения в разделе **Settings > User > Apps preferences**, для чего требуется разрешение User Apps. В настройках рабочего пространства приложения нет кнопки **Добавить подключение** для поставщика `USER`.<Note>**Настройки приложений** пока включены не во всех рабочих пространствах: там, где они не включены,@@ -520,7 +520,7 @@ await reportConnectionAuthFailure({Подключение всегда имеет область действия своего поставщика, и область действия поставщика является частью его идентичности: более поздняя версия не может изменить `scope` существующего поставщика, и обновление отклоняется, если оно пытается это сделать. Чтобы переместить службу из одной области действия в другую, объявите нового поставщика с новым `universalIdentifier` и удалите старого. При обновлении старый поставщик и все подключения, созданные с его помощью, удаляются через обычный путь отключения (`onDisconnectLogicFunction`, отзыв токена, очистка канала), а участники снова подключаются через нового поставщика.-Добавление или повторное подключение соединения **Just for me** требует разрешения `CONNECTED_ACCOUNTS`, а добавление или повторное подключение соединения **Workspace shared** требует разрешения `APPLICATIONS`.+Для добавления или повторного подключения соединения **Just for me** требуется разрешение User Apps, а для добавления или повторного подключения соединения **Workspace shared** — разрешение Workspace Apps.Используйте подходящее подключение для каждого обработчика:diff --git a/packages/twenty-docs/ru/developers/extend/apps/logic/inbox.mdx b/packages/twenty-docs/ru/developers/extend/apps/logic/inbox.mdxindex ebbbc5cb323..d4f48557490 100644--- a/packages/twenty-docs/ru/developers/extend/apps/logic/inbox.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/logic/inbox.mdx@@ -92,4 +92,34 @@ await sendInboxMessage({* Упоминание только рендеров. Он не добавляет участника в разговор или не уведомляет их, поэтому перечислите всех, кто должен получить сообщение в разделе `workspaceMemberIds`.* `INBOX_ASSISTANT_MENTION` - это текст, в котором автор пишет, когда член упоминает помощника (`@Ada`), так что ваше имя сообщения совпадает.+## Прикрепление записей к беседе++`attachRecordToInboxThread()` связывает беседу с записью, а `detachRecordFromInboxThread()` удаляет эту связь.++```ts src/logic-functions/file-call-recap.ts+import {+ attachRecordToInboxThread,+ sendInboxMessage,+} from 'twenty-sdk/logic-function';++const { threadId } = await sendInboxMessage({+ workspaceMemberIds: [owner.id],+ threadKey: `call-recap-${call.id}`,+ idempotencyKey: `call-recap-${call.id}`,+ title: `Recap of ${call.title}`,+ text: call.summary,+});++await attachRecordToInboxThread({+ threadId,+ objectNameSingular: 'company',+ recordId: company.id,+});+```++* Обе функции принимают `threadId` беседы и запись в виде `objectNameSingular` и `recordId`. Беседу можно связать с записями «Люди», «Компании», «Сделки» и записями пользовательских объектов.+* Обе функции идемпотентны: повторное прикрепление записи сохраняет одну связь, а открепление неприкреплённой записи ничего не меняет.+* Вызов выполняется с теми же правами доступа, что и [отправка сообщения](#who-sends-the-message), для которой требуется разрешение `AI`. Участник должен иметь возможность редактировать обсуждение, а ваше приложение может работать с обсуждением, которое оно само создало, или с обсуждением, к которому был предоставлен доступ его роли по умолчанию; в противном случае вызов завершается ошибкой `THREAD_NOT_FOUND`.+* Запись должна быть доступна для чтения с такими правами доступа, иначе вызов завершается ошибкой `RECORD_NOT_FOUND`.+<PageBanner illustration="card-page-inbox" />diff --git a/packages/twenty-docs/ru/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/ru/developers/extend/apps/logic/logic-functions.mdxindex 5cbbc6ac5b8..baab99021dc 100644--- a/packages/twenty-docs/ru/developers/extend/apps/logic/logic-functions.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/logic/logic-functions.mdx@@ -293,28 +293,25 @@ export default defineLogicFunction({Конечная точка доступна по адресу:```-POST https://your-twenty-server.com/webhooks/server/:resolverLogicFunctionId+POST https://your-twenty-server.com/webhooks/server/:applicationRegistrationId/:resolverLogicFunctionUniversalIdentifier```-Идентификатор — это `id` резолвера: первичный ключ, который сервер назначает при первой синхронизации приложения с рабочим пространством владельца, а не `universalIdentifier` из вашего манифеста. Получите его из API `/metadata` рабочего пространства владельца, затем зарегистрируйте этот URL у провайдера:+Первый сегмент — это идентификатор регистрации вашего приложения, второй — `universalIdentifier` резолвера из вашего манифеста. Маршрут разрешается только в резолвер этой регистрации в рабочем пространстве её владельца. Когда ваше приложение само регистрирует вебхук, сформируйте URL внутри логической функции с помощью `getServerRouteUrl`; Twenty внедряет базовый URL серверных маршрутов вашего приложения как `TWENTY_SERVER_ROUTES_URL`:-```graphql-query {- findManyLogicFunctions {- id- name- universalIdentifier- }-}+```ts+import { getServerRouteUrl } from 'twenty-sdk/utils';++const destinationUrl = getServerRouteUrl(+ INVOICE_PAID_RESOLVER_UNIVERSAL_IDENTIFIER,+);```<Note>- URL-адрес с `universalIdentifier` резолвера пока всё ещё разрешается,- а ответ содержит заголовок `Deprecation`. `universalIdentifier` является- уникальным для каждого рабочего пространства, а не глобально: если другая регистрация,- принадлежащая другому рабочему пространству, объявляет такой же идентификатор, платформа возвращает `404` для этого- URL-адреса вместо выбора между ними. Переведите URL-адреса, зарегистрированные у ваших- провайдеров, в форму `id`.+ URL-адреса, содержащие только `id` или `universalIdentifier` резолвера+ (`/webhooks/server/:identifier`), пока всё ещё разрешаются, и оба возвращают+ заголовок `Deprecation`. Форма `universalIdentifier` возвращает `409`, когда две+ регистрации объявляют один и тот же идентификатор. Переместите URL-адреса, зарегистрированные у ваших+ провайдеров, в форму регистрации.</Note>**Ответ на проверочный `GET`.** Некоторые поставщики проверяют конечную точку перед отправкой данных на неё: они отправляют `GET` с проверочным запросом на тот же URL, на который позднее будут `POST` события. Meta's WhatsApp Cloud API — один из них. Маршрут сервера отвечает только на `POST`, если не указано иное, поэтому объявите оба метода:diff --git a/packages/twenty-docs/ru/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/ru/developers/extend/apps/logic/skills-and-agents.mdxindex 8392b54c041..1894791d41d 100644--- a/packages/twenty-docs/ru/developers/extend/apps/logic/skills-and-agents.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/logic/skills-and-agents.mdx@@ -103,6 +103,39 @@ export default defineAgent({* `required` (необязательно) перечисляет свойства, которые модель всегда должна возвращать.* `additionalProperties: false` (необязательно) запрещает любые свойства, не объявленные в `properties`.+</Accordion>+<Accordion title="defineMcpServer" description="Предоставьте внешний MCP-сервер ИИ рабочего пространства (бета-версия)">++<Warning>+ MCP-серверы находятся на стадии бета-тестирования и ещё не запущены: вы можете объявить их, но рабочие пространства не смогут использовать их инструменты, пока эта функция не будет выпущена.+</Warning>++Используйте `defineMcpServer()` для развертывания удалённого MCP-сервера (Streamable HTTP) вместе с вашим приложением, чтобы ИИ рабочего пространства мог использовать его инструменты без синхронизации этих данных с Twenty:++```ts src/mcp-servers/github.ts+import { defineMcpServer } from 'twenty-sdk/define';++import { GITHUB_CONNECTION_PROVIDER_UNIVERSAL_IDENTIFIER } from 'src/constants/universal-identifiers';++export default defineMcpServer({+ universalIdentifier: '0b6c4f7e-3d5a-4a8e-9a0d-6f1e2c3b4a01',+ name: 'github',+ label: 'GitHub',+ url: 'https://api.githubcopilot.com/mcp/',+ connectionProvider: {+ universalIdentifier: GITHUB_CONNECTION_PROVIDER_UNIVERSAL_IDENTIFIER,+ },+});+```++Основные моменты:+* `name` имеет формат snake_case (строчные буквы, цифры и символы подчёркивания, начинается с буквы, не более 32 символов) и уникален в рабочем пространстве. Он добавляется в начало имён инструментов сервера.+* `url` должен быть URL-адресом HTTP или HTTPS.+* `connectionProvider` (необязательно) ссылается на [поставщика подключения](/ru/developers/extend/apps/logic/connections), объявленного тем же приложением. Запросы отправляют токен доступа этого подключения в качестве токена Bearer. Не указывайте его для общедоступного сервера.+* URL-адрес нельзя изменить в более поздней версии, пока подключён поставщик подключения, поэтому токены никогда не отправляются на другой хост.+* Рабочие пространства могут деактивировать сервер; более поздняя версия приложения сохранит этот выбор.+* Требуется `"engines": { "twenty": ">=2.53.0" }`.+</Accordion><Accordion title="runAgent" description="Запуск агента из логической функции">diff --git a/packages/twenty-docs/ru/developers/extend/apps/logic/workflows.mdx b/packages/twenty-docs/ru/developers/extend/apps/logic/workflows.mdxindex 060ecfd39bf..1c8f0192f42 100644--- a/packages/twenty-docs/ru/developers/extend/apps/logic/workflows.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/logic/workflows.mdx@@ -68,7 +68,7 @@ export default defineWorkflow({Основные моменты:-* Рабочий процесс, его триггер и каждый шаг должны иметь собственный `universalIdentifier`. Сохраняйте их неизменными между релизами: по ним Twenty сопоставляет установленный рабочий процесс при следующей установке.+* Рабочему процессу и каждому шагу нужен собственный `universalIdentifier`, а у триггера он может быть. Сохраняйте их неизменными между релизами: по ним Twenty сопоставляет установленный рабочий процесс при следующей установке.* `nextStepIds` связывает граф. Триггер указывает на первые шаги, а каждый шаг указывает на шаги, выполняемые после него.* Шаг считывает предыдущий вывод с помощью `{{trigger.\<path>}}` или `{{\<step universalIdentifier>.\<path>}}`.* Сборка проверяет всё определение: неподдерживаемые типы триггеров или шагов, повреждённые связи между шагами и ссылки на неизвестные шаги приводят к её сбою.@@ -95,6 +95,8 @@ export default defineWorkflow({Ручной рабочий процесс без `availability` не получает пункта меню команд.+Каждый триггер также принимает необязательные `name`, `position` и `outputSchema`, которые влияют только на то, как рабочий процесс выглядит в конструкторе. Без них Twenty использует имя вроде `Manual trigger`, размещает триггер в верхней части холста и вычисляет выходную схему на основе настроек.+Рабочий процесс webhook прослушивает `https://\<your-twenty-domain>/webhooks/workflows/\<workspaceId>/\<workflowId>`, где `workflowId` — это id установленного рабочего процесса. Тело запроса доступно как `{{trigger.\<path>}}`.## Шаги@@ -126,7 +128,8 @@ export default defineWorkflow({Пользовательское приложение рабочего пространства является владельцем рабочих процессов, созданных в конструкторе рабочих процессов, и код имеет для них такой же авторитет, как и конструктор:-* `twenty app pull` записывает каждый из них из его активной версии, последней опубликованной конструктором. Рабочий процесс, активная версия которого использует настройки, которые файл `defineWorkflow()` не может выразить, например шаг Code или триггер, переименованный в конструкторе, отмечается в отчёте и остаётся без изменений.+* `twenty app pull` записывает каждый из них из его активной версии, последней опубликованной конструктором. Рабочий процесс, активная версия которого использует настройки, невыразимые в файле `defineWorkflow()`, например шаг кода, отмечается в отчёте и остаётся на месте.+* Загруженный рабочий процесс сохраняет то, что сохранил конструктор: триггер без `universalIdentifier`, имя триггера из конструктора, `position` со значением `null` для узла, который конструктор никогда не размещал, и `outputSchema`, отличающуюся от вычисленной. Для этих полей требуются twenty-sdk 2.53.0 или новее, применённые к серверу версии 2.53.0 или новее: более старые версии отклоняют их как неизвестные ключи.* `twenty app apply` публикует так же, как конструктор. Рабочий процесс, определение которого совпадает с его активной версией, остаётся без изменений. В противном случае активная версия архивируется, а определение становится новой активной версией, поэтому прошлые запуски сохраняют версию, с которой они выполнялись.* Пользователи продолжают редактировать эти рабочие процессы в конструкторе, и следующая выгрузка возвращает их изменения.diff --git a/packages/twenty-docs/ru/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/ru/developers/extend/apps/operations/cli.mdxindex 1b3b37bdbe7..bd0f155b29e 100644--- a/packages/twenty-docs/ru/developers/extend/apps/operations/cli.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/operations/cli.mdx@@ -103,18 +103,18 @@ npx twenty@latest app devДругие команды приложения:-| Команда | Что делает |-| ----------------------------- | ------------------------------------------------------------------------------ |-| `app add` | Создайте заготовку объекта, поля, логической функции или другой сущности |-| `app build` / `app typecheck` | Соберите приложение или проверьте типы локально |-| `app plan` | Предварительно просмотрите изменения метаданных, которые внесёт применение |-| `app apply` | Соберите, загрузите и синхронизируйте приложение |-| `app generate-client` | Повторно сгенерируйте типизированный API-клиент без синхронизации |-| `app pull` | Запишите метаданные установленного приложения обратно в локальный исходный код |-| `app translations extract` | Извлечь переводимые строки в каталоги `locales/` |-| `app publish` | Опубликуйте приложение в npm или в частном реестре Twenty |-| `app install` | Установите в рабочее пространство уже зарегистрированный пакет приложения |-| `app uninstall` | Удалите из рабочего пространства приложение и всё, чем оно владеет |+| Команда | Что делает |+| ----------------------------- | -------------------------------------------------------------------------- |+| `app add` | Создайте заготовку объекта, поля, логической функции или другой сущности |+| `app build` / `app typecheck` | Соберите приложение или проверьте типы локально |+| `app plan` | Предварительно просмотрите изменения метаданных, которые внесёт применение |+| `app apply` | Соберите, загрузите и синхронизируйте приложение |+| `app generate-client` | Повторно сгенерируйте типизированный API-клиент без синхронизации |+| `app pull` | Восстановить метаданные, переводы и сохранённые зависимости |+| `app translations extract` | Извлечь переводимые строки в каталоги `locales/` |+| `app publish` | Опубликуйте приложение в npm или в частном реестре Twenty |+| `app install` | Установите в рабочее пространство уже зарегистрированный пакет приложения |+| `app uninstall` | Удалите из рабочего пространства приложение и всё, чем оно владеет |Определения, отсутствующие в исходном коде, по умолчанию удаляются из рабочего пространства. Передайте `--no-prune`, чтобы сохранить их. Пользовательское приложение рабочей области сохраняет их, если не передать `--prune`. Удаление объектов или полей также удаляет их данные, поэтому требуется подтверждение. Подробнее см. в разделе [Синхронизация и восстановление](/ru/developers/extend/apps/operations/sync-and-recovery).diff --git a/packages/twenty-docs/ru/developers/extend/apps/operations/marketplace-review.mdx b/packages/twenty-docs/ru/developers/extend/apps/operations/marketplace-review.mdxindex 7d7246581ac..475ddee913e 100644--- a/packages/twenty-docs/ru/developers/extend/apps/operations/marketplace-review.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/operations/marketplace-review.mdx@@ -1,60 +1,54 @@----title: Проверка маркетплейса (WIP)-description: Предлагаемые требования к сторонним приложениям для получения значка «Проверено».+title: Проверка в маркетплейсе+description: Требования к безопасности и качеству, которым должно соответствовать каждое приложение для размещения в маркетплейсе.---import { PageBanner } from "/snippets/page-banner.mdx"-## Как работает проверка+## Как проходит проверка-<Warning>- **В разработке.** Эта страница и её требования могут меняться. Проверка сторонних- приложений пока недоступна. Актуальную информацию о работе маркетплейса см. в разделе- [Публикация](/ru/developers/extend/apps/operations/publishing#marketplace-visibility-and-review).-</Warning>+Каждое приложение, размещённое в маркетплейсе, прошло проверку безопасности и качества Twenty. Публикация в npm сама по себе не размещает приложение: оно остаётся неразмещённым, пока проверка не будет завершена. Информацию о том, как работает размещение, см. в разделе+[Публикация](/ru/developers/extend/apps/operations/publishing#marketplace-visibility-and-review).-Проверка применяется к конкретной версии и пакету приложения. Каждое обновление требует проверки и-одобрения от Twenty. Проверенные приложения могут быть повторно оценены по мере развития-зависимостей или сервисов.+Размещённые приложения могут проходить повторную оценку по мере развития самих приложений, их зависимостей или сервисов, от которых они зависят, и могут быть сняты с публикации, если перестанут соответствовать контрольному списку.## Контрольный список проверки-Все применимые пункты должны быть пройдены. Перед отправкой рекомендуем использовать агента для самостоятельной оценки-каждого критерия с доказательствами и необходимыми исправлениями.+Все применимые пункты должны быть пройдены. Перед отправкой рекомендуем использовать агента для самостоятельной оценки каждого критерия с подтверждениями и необходимыми исправлениями.-* [ ] **Издатель.** [Заявите права на своё приложение](/ru/developers/extend/apps/operations/publishing#claiming-your-app)+* [ ] **Издатель.** [Подтвердите своё приложение](/ru/developers/extend/apps/operations/publishing#claiming-your-app)и [публикуйте с подтверждением происхождения](/ru/developers/extend/apps/operations/publishing#ci-publishing).-* [ ] **Безопасность.** Пройдите внутреннюю проверку безопасности Twenty и устраните- блокирующие проблемы.+* [ ] **Безопасность.** Пройдите внутреннюю проверку безопасности Twenty и устраните блокирующие+ проблемы.* [ ] **Разрешения.** Запрашивайте только те[разрешения](/ru/developers/extend/apps/config/roles), которые необходимы для функций приложения.-* [ ] **Функциональность.** Настройка и основные рабочие процессы понятны и работают- как заявлено, без сбоев, потери работы или дублирования записей. Без функций-заглушек+* [ ] **Функциональность.** Настройка и основные рабочие процессы просты для понимания и работают так,+ как заявлено, без сбоев, потери данных или дублирования записей. Без функций-заглушекили неработающих элементов управления.-* [ ] **Производительность.** Соблюдайте общие ограничения частоты запросов API/задач, обрабатывайте ограничение запросов и+* [ ] **Производительность.** Соблюдайте общие ограничения частоты запросов API/задач, обрабатывайте ограничение скорости иследуйте[рекомендациям по разработке приложений](/ru/developers/extend/apps/getting-started/good-practices).-* [ ] **Полезность.** Выполняйте значимую задачу CRM для более широкой аудитории, чем- настройка одного клиента. Небольшие коннекторы и автоматизации без интерфейса соответствуют требованиям.+* [ ] **Полезность.** Выполняйте значимую задачу CRM для более широкой аудитории,+ чем настройка одного клиента. Небольшие коннекторы и автоматизации без интерфейса подходят.* [ ] **Нативный интерфейс.** При необходимости повторно используйте нативные объекты, представления и рабочие процессы.- Если у приложения есть UI, используйте+ Если у приложения есть интерфейс, используйте[`twenty-ui`](/ru/developers/extend/apps/layout/front-components#using-twenty-ui-components)- и следуйте макетам, взаимодействиям и правилам доступности Twenty.-* [ ] **Конфиденциальность.** Объясните, какие данные покидают рабочее пространство, куда и зачем они передаются,+ и соблюдайте соглашения Twenty по макетам, взаимодействиям и доступности.+* [ ] **Конфиденциальность.** Объясните, какие данные покидают рабочее пространство, куда и почему они отправляются,включая поставщиков ИИ, как долго они хранятся и как их можно удалить.-* [ ] **Поддержка и совместимость.** Укажите поддерживаемые версии Twenty, сохраняйте+* [ ] **Поддержка и совместимость.** Укажите поддерживаемые версии Twenty, поддерживайтестабильность идентификаторов сущностей и со временем исправляйте критические ошибки и неработающие интеграции.* [ ] **Логотип и галерея.** Предоставьте оригинальный, узнаваемый логотип и качественные- изображения реального приложения. Следуйте+ изображения самого приложения. Следуйте[рекомендациям по изображениям](/ru/developers/extend/apps/operations/publishing#marketplace-metadata).-* [ ] **Карточка и README.** Точно опишите функции и аффилированность в- названии, описании и скриншотах. README должен быть кратким, хорошо отформатированным+* [ ] **Публикация и README.** Точно описывайте функции и связи+ в названии, описании и снимках экрана. README должен быть кратким, хорошо отформатированными сосредоточенным на ценности приложения.-* [ ] **Цены.** Чётко укажите, является ли приложение бесплатным или платным, цены планов,- периодичность оплаты и все обязательные платные сторонние сервисы.+* [ ] **Цены.** Чётко укажите, является ли приложение бесплатным или платным, цены тарифов,+ периодичность выставления счетов и все необходимые платные сторонние сервисы.* [ ] **Документация и поддержка.** Предоставьте инструкции по настройке, рабочий пример- и контакт для поддержки. При использовании общих маршрутов выполните+ и контакт для поддержки. При использовании общих маршрутов завершите[настройку](/ru/developers/extend/apps/operations/publishing#setting-up-server-routes)- и убедитесь, что события поступают в нужное рабочее пространство.+ и убедитесь, что события поступают в правильное рабочее пространство.<PageBanner illustration="card-page-marketplace-review" />diff --git a/packages/twenty-docs/ru/developers/extend/apps/operations/overview.mdx b/packages/twenty-docs/ru/developers/extend/apps/operations/overview.mdxindex d169a639605..fc76fcf253f 100644--- a/packages/twenty-docs/ru/developers/extend/apps/operations/overview.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/operations/overview.mdx@@ -42,8 +42,8 @@ import { CardTitle } from "/snippets/card-title.mdx"Создан, развертывание архива, публикация в npm, установка.</Card><Card href="/ru/developers/extend/apps/operations/marketplace-review" img="/images/documentation/banner-icons-v2/permissions.svg">- <CardTitle>Проверка на рынок (WIP)</CardTitle>- Предлагаемая безопасность, качество и оперативная проверка сторонних версий приложений.+ <CardTitle>Проверка Marketplace</CardTitle>+ Проверки безопасности, качества и эксплуатации, которые приложение должно пройти, чтобы быть опубликованным.</Card><Card href="/ru/developers/extend/apps/operations/monitoring" img="/images/user-guide/halftone/card-page-monitoring.svg"><CardTitle>Мониторинг</CardTitle>diff --git a/packages/twenty-docs/ru/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/ru/developers/extend/apps/operations/publishing.mdxindex 4eca177adc9..ff82eafcc73 100644--- a/packages/twenty-docs/ru/developers/extend/apps/operations/publishing.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/operations/publishing.mdx@@ -222,7 +222,7 @@ npm принимает подтверждение происхождения т## Публикация в npm-Публикация в npm позволяет разместить ваше приложение на маркетплейсе Twenty. После синхронизации каталога и необходимой [настройки серверных маршрутов](#setting-up-server-routes) рабочие пространства смогут просматривать, устанавливать и обновлять его через интерфейс. Приложения сообщества отображаются, когда пользователи отключают фильтр **Только проверенные**.+Публикация в npm позволяет разместить ваше приложение на маркетплейсе Twenty. После синхронизации каталога и любой необходимой [настройки серверных маршрутов](#setting-up-server-routes) рабочие пространства смогут просматривать, устанавливать и обновлять его через интерфейс после прохождения [проверки Marketplace](/ru/developers/extend/apps/operations/marketplace-review).### Требования@@ -372,17 +372,13 @@ twenty app publish --tag betaВ Twenty Cloud эта конфигурация уже управляется для вас.</Accordion>-## Видимость на маркетплейсе и проверка+## Видимость и проверка в Marketplace-Заявление прав устанавливает владение; оно не присваивает значок **Проверено**. По умолчанию на маркетплейсе включён фильтр **Только проверенные**. Чтобы найти приложения сообщества, перейдите в **Настройки > Приложения > Маркетплейс**, откройте фильтр и снимите флажок **Только проверенные**. Вы также можете поделиться прямой страницей установки приложения через **Мои приложения > ваше приложение > Распространение > Копировать ссылку для общего доступа**.+Все приложения, представленные в Marketplace, прошли проверку безопасности и качества Twenty. Недавно опубликованное приложение остаётся скрытым, пока не пройдёт [проверку Marketplace](/ru/developers/extend/apps/operations/marketplace-review); подтверждение прав устанавливает владение, но не делает его доступным в списке.-Метка «Проверено» сейчас применяется к приложениям, поддерживаемым Twenty, за безопасность и качество которых команда может поручиться. Сторонние приложения можно публиковать и устанавливать без этой метки.+Скрытое приложение всё ещё можно установить. В разделе **Настройки > Приложения > Marketplace** откройте фильтр и включите **Показывать скрытые приложения** или поделитесь страницей прямой установки приложения через **Мои приложения > ваше приложение > Распространение > Копировать ссылку для общего доступа**. Рабочие пространства увидят предупреждение о том, что приложение не прошло проверку Twenty.-Предложенный [контрольный список проверки сторонних маркетплейсов](/ru/developers/extend/apps/operations/marketplace-review)-находится в разработке. В нём описаны критерии проверки и доказательства для конкретных версий,-а не доступная программа сертификации.--Если ваше приложение по-прежнему отсутствует при отключённом фильтре **Только проверенные**, убедитесь, что синхронизация каталога завершена, все обязательные серверные переменные заполнены и настройка серверных маршрутов завершена.+Если ваше приложение представлено в списке, но всё ещё отсутствует в Marketplace, убедитесь, что синхронизация каталога завершена, все обязательные переменные сервера заполнены и любая настройка серверных маршрутов завершена.## Установка приложенийdiff --git a/packages/twenty-docs/ru/developers/extend/apps/operations/sync-and-recovery.mdx b/packages/twenty-docs/ru/developers/extend/apps/operations/sync-and-recovery.mdxindex dc591cc8280..b368e486fd9 100644--- a/packages/twenty-docs/ru/developers/extend/apps/operations/sync-and-recovery.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/operations/sync-and-recovery.mdx@@ -24,7 +24,7 @@ import { PageBanner } from "/snippets/page-banner.mdx"| Предпросмотр изменений **без их применения** | `twenty app plan` | Вычисляет и выводит diff; ничего не записывает. || Синхронизировать без удаления чего-либо | `twenty app apply --no-prune` | Только создаёт и обновляет: сущности, существующие в рабочей области, но отсутствующие в исходном коде, остаются без изменений. Также поддерживается командами `plan` и `dev`. || Очистить пользовательское приложение рабочей области | `twenty app apply --prune` | Это приложение сохраняет сущности, отсутствующие в источнике, если не указать `--prune`. Также принимается командами `plan` и `dev`. |-| Повторно создать локальный исходный код из рабочей области | `twenty app pull` | **Экспериментальная функция.** Записывает установленное приложение обратно в файлы определения. См. ниже. |+| Повторно создать локальный исходный код из рабочей области | `twenty app pull` | **Экспериментальная функция.** Восстанавливает файлы определения, переводы и сохраненные зависимости. См. ниже. || Удалить приложение из рабочего пространства | `twenty app uninstall` | Добавьте `--yes`, чтобы пропустить запрос подтверждения. || Отправить на сервер tar-архив | `twenty app publish --private` | Требуется **строго более высокая** версия в `package.json` — см. [Публикация](/ru/developers/extend/apps/operations/publishing). || Опубликовать на маркетплейсе (npm) | `twenty app publish` | — |@@ -109,17 +109,23 @@ Plan: 1 to add, 1 to change, 0 to destroy.перед её запуском и просмотрите diff.</Warning>-`twenty app pull` — это операция, обратная `apply`: она считывает приложение из рабочего пространства и записывает его обратно в виде файлов определений.+`twenty app pull` является обратной операцией для `apply`: она считывает приложение из рабочего пространства и восстанавливает его файлы определения, переводы и сохраненные файлы зависимостей.```bash-twenty app pull --universal-identifier <universalIdentifier>+twenty app pull --remote dev+twenty app pull --path ./workspace-app --yes --no-input```-Для pull нужен существующий проект — сначала создайте его каркас с помощью `twenty app init`, затем выполните pull в него. Без `--universal-identifier` pull выбирает приложение, объявленное в вашем локальном файле `defineApplication()`. Если `--universal-identifier` указывает другое приложение, а не то, которое объявлено в вашем проекте, pull откажется от выполнения, вместо того чтобы оставить два приложения в одном дереве: выполните pull этого приложения в отдельный каталог. Если в проекте есть файл приложения, идентификатор которого невозможно прочитать, обычно потому, что зависимости не установлены, pull также отказывается выполнять операцию и просит сначала запустить `yarn install`. Добавьте `--verbose`, чтобы развернуть разделы охвата в отчёте: тогда в них будет указано до 20 идентификаторов для каждого типа метаданных, а не только итоговые значения.+Внутри приложения pull считывает его локальный идентификатор `defineApplication()` и получает это приложение. Вне приложения команда запрашивает каталог и подтверждение, создаёт локальный проект для пользовательского приложения выбранного рабочего пространства, устанавливает зависимости с помощью Yarn, а затем получает определения. Новый проект включает файлы пакета и конфигурации без демонстрационных сущностей инициализатора.++Используйте `--path`, чтобы выбрать существующее приложение или новый либо пустой каталог. Для неинтерактивного создания требуются `--path` и `--yes`; pull отказывается перезаписывать несвязанный непустой каталог. Создание проекта не регистрирует приложение и не изменяет рабочее пространство. Существующий проект SDK без определения приложения также получает пользовательское приложение. Параметр `--universal-identifier` отсутствует.++Если установка зависимостей для нового проекта завершается ошибкой, каркас сохраняется. Выполните `yarn install` в нём, затем повторите pull. В существующих проектах зависимости не устанавливаются автоматически. Если не удаётся прочитать идентификатор их приложения, pull сообщает об этой ошибке вместо создания другого приложения. Добавьте `--verbose`, чтобы развернуть разделы охвата в отчёте: тогда в них будет указано до 20 идентификаторов для каждого типа метаданных, а не только итоговые значения.**Что записывается:*** конфигурация приложения;+* сохраненные файлы зависимостей `package.json` и `yarn.lock` в корне проекта;* объекты со встроенными полями;* поля, добавленные вашим приложением к объектам, которыми оно не владеет;* авторские индексы;@@ -138,6 +144,10 @@ twenty app pull --universal-identifier <universalIdentifier>Каждая сущность помещается в файл, который уже её определяет, поэтому повторный pull перезаписывает только то, что изменилось на сервере. Файл также перезаписывается, если в нем используется другая функция define, чем та, которую записала бы команда pull, например роль, которая стала или перестала быть ролью по умолчанию. Новые сущности размещаются рядом с существующими файлами того же типа, а сгенерированное имя, которое совпало бы с несвязанным файлом, уточняется вместо его перезаписи.+**Файлы зависимостей.** Когда сохранённый `package.json` или `yarn.lock` изменяется, pull заменяет локальный файл и сообщает о перезаписанных локальных изменениях. Если удалённый файл не изменился с момента предыдущего pull, локальные изменения сохраняются. Отсутствующий удалённый файл не удаляет соответствующий локальный файл. Когда экспортированный пакет не включает `twenty-sdk`, как это делает пользовательское приложение рабочего пространства, pull сохраняет вашу локальную зависимость SDK, чтобы команды CLI по-прежнему могли загрузить проект. Файлы зависимостей, метаданные и базовая версия записываются вместе и вместе откатываются при ошибке записи.++После получения изменений зависимостей выполните `yarn install`. Pull не устанавливает пакеты, не запускает скрипты пакетов и не повторно генерирует типизированный клиент.+**Что не записывается:*** **Еще не экспортировано** — элементы меню команд и меню настроек, функции логики и фронтенд-компоненты, поставщики подключений, переменные приложения, общедоступные ресурсы, типы активности временной шкалы и сохраненный исходный код ваших функций.@@ -146,15 +156,15 @@ twenty app pull --universal-identifier <universalIdentifier>* **Размещённые в макете страницы по умолчанию или чужом макете страницы** — вкладки и виджеты, добавленные в макет страницы по умолчанию механизма или в макет, принадлежащий другому приложению, записываются как отдельные файлы `definePageLayoutTab()` и `definePageLayoutWidget()`, поскольку идентификатор, к которому они привязываются, известен.* **Виджеты, которые экспорт пока не может включить** — в любом макете, включая ваш собственный, виджет устаревшего типа `VIEW`, виджет, отображающий один из собственных компонентов фронтенда или элементов меню команд вашего приложения, либо виджет без позиции для режима макета его вкладки отображается в отчёте, а макет или вкладка записывается без него.* **Рабочие процессы, которые экспорт пока не может перенести** — рабочий процесс, изменённый в конструкторе рабочих процессов с момента последней синхронизации, системный или частный рабочий процесс, рабочий процесс с шагом Code или сообщением чата, которые рабочие процессы приложения не поддерживают, а также рабочий процесс, вызывающий действие рабочего процесса другого приложения, отмечаются в отчёте и остаются на месте. Пользовательское приложение рабочей области является исключением для первого и последнего случаев: конструктор также публикует его рабочие процессы, и они могут вызывать действия любого приложения, поэтому они извлекаются. Вместо этого в отчёте отмечается один из его рабочих процессов, если у него нет активной версии или если его активная версия использует параметры, которые невозможно выразить в определении. Шаги электронной почты и календаря переносятся: учётная запись, предоставленная рабочему пространству, записывается как её `connectedAccountHandle`, тогда как личная учётная запись участника и переменные сохраняются без изменений. Вместо этого рабочий процесс отмечается в отчёте, если учётная запись шага архивирована, больше не может выполнять шаг или использует тот же адрес, что и более старая учётная запись, поскольку применение дескриптора выбрало бы другую учётную запись.-* **Агенты и навыки, которые экспорт пока не может перенести** — деактивированный навык и агент с несколькими ролями или привязанный к получению роли не записываются, о них сообщается, и они остаются на месте.-* **Состояние среды выполнения рабочего пространства** — назначения ролей участникам и API-ключам, вебхуки, навигация для каждого пользователя и элементы навигации, закрепленные за записью; все это намеренно исключено.+* **Агенты, которых экспорт пока не может перенести** — агент с несколькими ролями или привязанный к извлечению роли, в которое он не записывает, отмечается и остается на месте.+* **Состояние среды выполнения рабочего пространства**, вложения записей, вложения электронных писем, назначения ролей участникам и API-ключам, вебхуки, пользовательская навигация и элементы навигации, закреплённые за записью, — всё это намеренно исключено, в том числе для пользовательского приложения рабочего пространства.* **Принадлежит другому приложению** — указывается в отчёте, но не извлекается.В отчёте по завершении операции извлечения всё это перечислено, сгруппированное по типу и причине. Все, что оно обозначает как незаписанное, по-прежнему находится в вашей рабочей области, поэтому отправляйте извлеченное дерево обратно с помощью `twenty app apply --no-prune`, пока не будут поддерживаться отсутствующие типы. Пользовательское приложение рабочей области уже применяется таким образом по умолчанию. Применение с очисткой (по умолчанию для других приложений, `--prune` для пользовательского приложения) удалило бы их, а `twenty app plan` точно указывает, какие именно.**Локальное для рабочей области состояние.** Сущность, деактивированная в рабочей области, записывается как активное определение, а переопределения, применённые рабочей областью к сущности, например переименованная метка, не записываются. В отчёте эти строки перечислены в разделе «Записано без локального состояния рабочей области». Повторное применение дерева к той же рабочей области не изменяет это состояние; в другой рабочей области сущность будет активной и без переопределений.-**Базовый файл.** Pull записывает извлечённые данные в `.twenty/pull-base.json`, который игнорируется Git и создаётся отдельно для каждой рабочей копии. Именно с этим файлом последующий pull сравнивает данные, чтобы не изменять файлы сущностей, которые не изменились, и удалить файл сущности, исчезнувшей из рабочего пространства. Рабочая копия без него просто записывает всё и ничего не удаляет.+**Базовый файл.** Pull записывает полученные данные в `.twenty/cli/pull-base.json`, который игнорируется Git и является отдельным для каждой рабочей копии. Именно с этим файлом последующий pull сравнивает данные, чтобы не изменять файлы сущностей, которые не изменились, и удалить файл сущности, исчезнувшей из рабочего пространства. Рабочая копия без него просто записывает всё и ничего не удаляет.## Лестница восстановления