The open alternative to Salesforce, designed for AI.
TypeScript crmcrm-systemcustomergood-first-issuegraphqlhacktoberfestjavascriptmarketingmonoreponestjsopen-sourcepostgresqlreactreactjssalestypescriptweb
i18n - docs translations (#29542)
twenty-pr[bot]70bc5d5a3c82
diff --git a/packages/twenty-docs/ar/developers/extend/apps/config/application.mdx b/packages/twenty-docs/ar/developers/extend/apps/config/application.mdxindex 8296871d9b3..a8484770cda 100644--- a/packages/twenty-docs/ar/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/config/application.mdx@@ -79,6 +79,29 @@ export default defineApplication({راجع [التقاط الوسائط](/ar/developers/extend/apps/layout/front-components#media-capture) لمعرفة سلوك الالتقاط ومؤشرات التسجيل.+## الوصول إلى وسائط موقع الويب المضمّن++عيّن `requestedIframeMediaPermissions` عندما يضمّن مكوّن أمامي أو عنصر واجهة مستخدم لتخطيط صفحة `IFRAME` موقع ويب يحتاج إلى الميكروفون أو الكاميرا، مثل أداة هاتف أو فيديو. أدرج ما يصل إلى 20 موقع ويب، يكون كل منها مصدر HTTPS مطابقًا تمامًا، مع تعيين الوصول إلى الميكروفون والكاميرا بشكل منفصل. يجب أن تكون المصادر فريدة، وألا تحتوي على مسار أو رمز بديل، وأن تطلب الوصول إلى واحد على الأقل من الميكروفون أو الكاميرا.++```ts+import { defineApplication } from 'twenty-sdk/define';++export default defineApplication({+ universalIdentifier: '39783023-bcac-41e3-b0d2-ff1944d8465d',+ displayName: 'Phone',+ description: 'Call your contacts from Twenty',+ requestedIframeMediaPermissions: [+ { origin: 'https://workspace.aircall.io', microphone: true, camera: false },+ ],+});+```++تظهر مواقع الويب المُعلنة أثناء التثبيت. تتطلب الموافقة عضوًا في مساحة العمل يمكنه إدارة التطبيقات، وتنطبق على مساحة العمل بأكملها، للمكوّنات الأمامية الخاصة بالتطبيق وعناصر واجهة iframe الخاصة به. تنطبق موافقات أمان مساحة العمل فقط على عناصر الواجهة التي أُنشئت في مساحة العمل. تتلقى تطبيقات التطوير المتزامنة محليًا مواقع الويب المُعلنة في بيانها. لا تحل هذه المنح محل أذونات المتصفح أو نظام التشغيل. لرؤوس المتصفح حد للحجم، لذا إذا تجاوزت مواقع الويب الخاصة بمساحة العمل هذا الحد، تأتي مواقع الويب المعتمدة من مساحة العمل أولًا ولا تتلقى مواقع الويب المتبقية الوصول إلى الوسائط.++تحافظ تحديثات التطبيقات المنشورة على المنح الحالية ولا تمنح تلقائيًا وصولًا إضافيًا إلى الوسائط. للموافقة على الطلبات الجديدة، يفتح عضو يمكنه إدارة التطبيقات علامة التبويب **عام** للتطبيق المثبّت ويحدد **مراجعة الوصول إلى الوسائط** ضمن **الوصول إلى وسائط موقع الويب المضمّن**. تستخدم هذه الموافقة تأكيدًا أصليًا من المتصفح يعرض التطبيق ومصادر مواقع الويب والوصول المطلوب إلى الميكروفون أو الكاميرا. بعد الموافقة، أعد تحميل علامات تبويب Twenty المفتوحة لتطبيق الأذونات المحدّثة.++راجع [مواقع الويب المضمّنة مع الوصول إلى الوسائط](/ar/developers/extend/apps/layout/front-components#embedded-websites-with-media-access) لمعرفة متطلبات iframe.+## أنواع المتغيراتكل من `applicationVariables` و`serverVariables` يقبلان حقل `type` اختياريًا (ولـ `SELECT` / `MULTI_SELECT`، قائمة `options`). الأنواع المدعومة: `TEXT` (افتراضي)، `BOOLEAN`، `NUMBER`، `NUMERIC`، `DATE`، `DATE_TIME`، `SELECT`، `MULTI_SELECT`، `ARRAY`، `RAW_JSON`، `RICH_TEXT`.diff --git a/packages/twenty-docs/ar/developers/extend/apps/data/overview.mdx b/packages/twenty-docs/ar/developers/extend/apps/data/overview.mdxindex f543fe83443..352561679d5 100644--- a/packages/twenty-docs/ar/developers/extend/apps/data/overview.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/data/overview.mdx@@ -46,6 +46,10 @@ import { CardTitle } from "/snippets/card-title.mdx"<CardTitle>النشاط من النوع</CardTitle>حدد أحداث المراجعة التلقائية وأحداث التطبيق الصريحة لجداول زمنية للتسجيل.</Card>+ <Card href="/ar/developers/extend/apps/data/objects" img="/images/user-guide/halftone/card-page-objects.svg">+ <CardTitle>قواعد التحقق</CardTitle>+ `defineValidationRule` — أعلن الشروط التي يجب أن يستوفيها السجل قبل أن يمكن حفظه.+ </Card></CardGroup>## الكيانات بنظرة سريعة@@ -58,8 +62,9 @@ import { CardTitle } from "/snippets/card-title.mdx"| **الفهرس** | فهرس قاعدة بيانات لتسريع استعلام متكرر على أحد الكائنات لديك | `defineIndex()` || **نوع نشاط الجدول الزمني** | حدث تدقيق تلقائي أو حدث مجال صريح يظهر في المخططات الزمنية للسجلات | `defineTimelineActivityType()` || **مسار السجل المرتبط** | سلسلة تضم ما يصل إلى ثلاث علاقات يمتد عبرها الوصول إلى سجل ليشمل سجلاته المرتبطة | `defineRelatedRecordPath()` |+| **قاعدة التحقق** | شرط يجب أن يستوفيه السجل قبل أن يمكن حفظه | `defineValidationRule()` |-تكتشف واجهة سطر الأوامر هذه العناصر عبر تحليل AST أثناء وقت البناء، لذا تنظيم الملفات يعود إليك — القاعدة المتّبعة هي `src/objects/` و `src/fields/` و `src/indexes/` و `src/timeline-activity-types/` و `src/related-record-paths/`. معرّفات UUID ثابتة من نوع `universalIdentifier` تربط كل شيء معًا عبر عمليات النشر.+تكتشف واجهة سطر الأوامر هذه العناصر عبر تحليل AST أثناء وقت البناء، لذا فإن تنظيم الملفات يعود إليك — القاعدة المتّبعة هي `src/objects/` و `src/validation-rules/` و `src/fields/` و `src/indexes/` و `src/timeline-activity-types/` و `src/related-record-paths/`. معرّفات UUID ثابتة من نوع `universalIdentifier` تربط كل شيء معًا عبر عمليات النشر.## الفهارس (اختياري)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 b82d9e36801..55e23d2417b 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@@ -18,6 +18,7 @@ your-app/│ ├── roles/ ← defineRole│ ├── objects/ ← defineObject│ ├── fields/ ← defineField+│ ├── validation-rules/ ← defineValidationRule│ ├── logic-functions/ ← defineLogicFunction│ ├── front-components/ ← defineFrontComponent│ ├── skills/ ← defineSkill@@ -46,6 +47,7 @@ your-app/| **الكائن** | أنواع سجلات مخصّصة مع حقول | [الكائنات](/ar/developers/extend/apps/data/objects) || **الحقل** | إضافة حقول إلى الكائنات من تطبيقات أخرى | [توسيع الكائنات](/ar/developers/extend/apps/data/extending-objects) || **علاقة** | روابط ثنائية الاتجاه بين الكائنات | [العلاقات](/ar/developers/extend/apps/data/relations) |+| **Validation Rule** | Conditions a record must meet before it can be saved | [Validation Rules](/ar/developers/extend/apps/data/validation-rules) || **دالة منطقية** | TypeScript على جانب الخادم مع مشغّلات | [الوظائف المنطقية](/ar/developers/extend/apps/logic/logic-functions) || **مهارة** | تعليمات قابلة لإعادة الاستخدام لوكلاء الذكاء الاصطناعي | [المهارات والوكلاء](/ar/developers/extend/apps/logic/skills-and-agents) || **وكيل** | مساعدو الذكاء الاصطناعي بموجهات مخصّصة | [المهارات والوكلاء](/ar/developers/extend/apps/logic/skills-and-agents) |@@ -86,7 +88,7 @@ your-app/└─────────────────────────────────────────────────────────┘```-* **`20 تطبيق dev`** - يشاهد الملفات المصدرية الخاصة بك والمزامنة المباشرة التغييرات على خادم عشرين متصل. يُعاد توليد عميل API مضبوط الأنواع تلقائيًا عند تغيّر المخطط.+* **`20 تطبيق dev`** - يشاهد الملفات المصدرية الخاصة بك والمزامنة المباشرة التغييرات على خادم عشرين متصل. بعد مزامنة ناجحة، يعيد إنشاء عميل API مضبوط الأنواع عند تغيير المخطط أو حزمة المُولِّد المثبّتة، أو عند فقدان ملفات العميل المُنشأة أو تغييرها. لتحديث الأنواع بعد تغيير مساحة العمل في واجهة المستخدم، شغّل `twenty app generate-client`.* **`بناء عشرين تطبيق`** - تجميع TypeScript، وحزم الدوال المنطقية والمكونات الأمامية مع esbuild، وإنتاج بيان بياني.* **خطّافات ما قبل/ما بعد التثبيت وإلغاء التثبيت** — دوال اختيارية تعمل أثناء التثبيت أو مباشرة قبل الإزالة. راجع [خطّافات التثبيت](/ar/developers/extend/apps/config/install-hooks) للتفاصيل.diff --git a/packages/twenty-docs/ar/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/ar/developers/extend/apps/getting-started/local-server.mdxindex 18568e9be3b..ac92be42700 100644--- a/packages/twenty-docs/ar/developers/extend/apps/getting-started/local-server.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/getting-started/local-server.mdx@@ -85,7 +85,7 @@ TWENTY_API_URL=http://localhost:2021 yarn test```bashbash packages/twenty-utils/setup-dev-env.shyarn start-twenty auth login --url http://localhost:3000 --name local+twenty auth login --url http://localhost:3000 --name local --use```استخدم عنوان URL والمنفذ الفعليين لخادمك. بالنسبة إلى مساحات العمل ذات النطاقات الفرعية، استخدم@@ -94,8 +94,8 @@ twenty auth login --url http://localhost:3000 --name local## تبعيّات المشروع-ثبّت `twenty-sdk` و`twenty-client-sdk` كتبعيّات للمشروع. ثبّت واجهة سطر الأوامر-`twenty` على مستوى النظام، ثم شغّل `twenty app typecheck` و`twenty app build` و-`twenty app apply` من دليل التطبيق.+يُعلن `twenty app init` عن `twenty-sdk` و`twenty-client-sdk` و`twenty-ui` في+`devDependencies`، لكنه لا يثبّتها. بعد تثبيت واجهة سطر الأوامر `twenty` على مستوى النظام، شغّل `yarn install` من دليل التطبيق المُنشأ قبل تشغيل+`twenty app typecheck` أو `twenty app build` أو `twenty app apply`.<PageBanner illustration="dev-self-host" />diff --git a/packages/twenty-docs/ar/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/ar/developers/extend/apps/getting-started/project-structure.mdxindex 0be64be0ab6..1850d8d4c49 100644--- a/packages/twenty-docs/ar/developers/extend/apps/getting-started/project-structure.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/getting-started/project-structure.mdx@@ -12,6 +12,7 @@ import { PageBanner } from "/snippets/page-banner.mdx"```text filename="my-twenty-app/"my-twenty-app/package.json+ yarn.lock # Created by app init; used by yarn installsrc/application-config.ts # Required — your app's entry pointdefault-role.ts # Permissions for logic functions@@ -28,6 +29,7 @@ my-twenty-app/__tests__/application-config.test.ts # Unit testglobal-setup.ts # Integration test setup (sync + uninstall)+ run-twenty.ts # CLI subprocess helper for testsschema.integration-test.ts # Integration test against a live server.github/workflows/ci.yml # Lint, typecheck, unit + integration tests@@ -67,20 +69,9 @@ my-twenty-app/## التبعيات-تنتمي حزم Twenty SDK وUI ضمن `devDependencies`:+يضع `twenty app init` الحزم `twenty-sdk` و`twenty-client-sdk` و`twenty-ui` ضمن `devDependencies`، مع تثبيتها على إصدار SDK الذي يحدده إصدار CLI ذلك. احتفظ بالإصدارات المُنشأة لتطبيق جديد، وحافظ على تزامن الحزم الثلاث جميعًا عند الترقية. يمكن أن يتلقى CLI إصدارات تصحيحية بشكل مستقل، لذا لا يلزم أن يتطابق إصداره مع هذه الحزم.-```json filename="package.json"-{- "dependencies": {},- "devDependencies": {- "twenty-client-sdk": "2.40.0",- "twenty-sdk": "2.40.0",- "twenty-ui": "2.40.0"- }-}-```--يثبّت `twenty app init` الحزم `twenty-sdk` و`twenty-client-sdk` و`twenty-ui` على إصداره الخاص. أبقِ الحزم الثلاث متزامنة عند الترقية.+يضبط `engines.twenty` المُنشأ الحد الأدنى لإصدار الخادم على الإصدار الرئيسي والفرعي الخاصين بـ SDK تلك. تُثبّت مهام سير عمل GitHub Actions المُنشأة إصدار CLI بشكل منفصل.* يوفّر **`twenty-sdk`** تعريفات التطبيقات، ومساعدات وقت التشغيل، والتكامل مع العارض. استخدم حزمة **`twenty`** المثبّتة بشكل منفصل لأوامر CLI وأدوات البناء وإنشاء الهياكل.* يتم استيراد **`twenty-client-sdk`** بواسطة كود تطبيقك (`CoreApiClient`، `MetadataApiClient`، `RestApiClient`)؛ لكن Twenty توفّره في وقت التشغيل — حيث تحصل عليه دوال المنطق من طبقة SDK مُولَّدة، وتحصل عليه مكوّنات الواجهة من وحدات يتم تقديمها من الخادم. يُستخدَم الإصدار المثبّت لديك فقط لفحص الأنواع (typechecking) ولبناء النشر (deploy-time build)، لذا لا يلزم أبدًا أن يتم تضمينه في حزمة النشر.diff --git a/packages/twenty-docs/ar/developers/extend/apps/getting-started/quick-start.mdx b/packages/twenty-docs/ar/developers/extend/apps/getting-started/quick-start.mdxindex 52ba9b0826c..9e95c6ab396 100644--- a/packages/twenty-docs/ar/developers/extend/apps/getting-started/quick-start.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/getting-started/quick-start.mdx@@ -8,7 +8,7 @@ import { CardTitle } from "/snippets/card-title.mdx"## قبل أن تبدأ-استخدم Node.js 24.5+ أو 26.5+ وYarn 4 (عبر Corepack: `corepack enable`؛ في Node 26، ثبّته أولاً باستخدام `npm install -g corepack`). ثبّت واجهة سطر الأوامر بشكل عام؛ يحتفظ تطبيقك بتبعيات SDK الخاصة به.+استخدم Node.js 24 (24.5+) أو 26 (26.5.1+) وYarn 4 (عبر Corepack: `corepack enable`؛ في Node 26، ثبّته أولاً باستخدام `npm install -g corepack`). ثبّت واجهة سطر الأوامر بشكل عام؛ يحتفظ تطبيقك بتبعيات SDK الخاصة به.<Note>يُدعم رسميًا إنشاء تطبيقات Twenty على أنظمة Unix (macOS وLinux) فقط. على Windows، اعمل ضمن WSL 2.@@ -30,9 +30,12 @@ yarn installاستخدم مساحة عمل موجودة، أو ابدأ [خادماً محلياً](/ar/developers/extend/apps/getting-started/local-server)، ثم سجّل الدخول:```bash-twenty auth login --url https://your-workspace.twenty.com --name dev+twenty auth login --url https://your-workspace.twenty.com --name dev --use+twenty auth status --remote dev```+يحفظ `--name dev` الاتصال باسم `dev`؛ ويجعله `--use` الافتراضي للأوامر أدناه. لاستهدافه صراحةً، أضف `--remote dev`. يمكن لمتغيرات البيئة تجاوز الإعداد الافتراضي، راجع [اختيار مساحة العمل](/ar/developers/extend/apps/operations/cli#connecting-to-a-workspace).+## زامن تغييراتكللمزامنة الأولى، اسمح صراحةً بالتسجيل والتثبيت:diff --git a/packages/twenty-docs/ar/developers/extend/apps/getting-started/scaffolding.mdx b/packages/twenty-docs/ar/developers/extend/apps/getting-started/scaffolding.mdxindex 021591d35e0..68b87bfcb94 100644--- a/packages/twenty-docs/ar/developers/extend/apps/getting-started/scaffolding.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/getting-started/scaffolding.mdx@@ -7,12 +7,13 @@ import { PageBanner } from "/snippets/page-banner.mdx"## نظرة عامة-استخدم واجهة CLI المستقلة لإنشاء كائن أو حقل أو دالة منطقية أو مكوّن أمامي:+استخدم واجهة سطر الأوامر المستقلة لإنشاء كائن أو حقل أو قاعدة تحقق أو دالة منطق أو مكوّن أمامي:```bashtwenty app addtwenty app add object --name invoice --name-plural invoices --no-inputtwenty app add field --name amount --type NUMBER --object <object-uuid> --no-input+twenty app add validation-rule --name invoice-has-amount --object <object-uuid> --no-inputtwenty app add logic-function --name send-invoice --no-inputtwenty app add front-component --name invoice-panel --no-input```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 c65175abc86..9c715ae8805 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@@ -1200,10 +1200,31 @@ const Card = () => {يعمل `getUserMedia()` و`MediaRecorder` عبر بدائل متعددة للساحة المعزولة، لذا يعمل رمز التسجيل القياسي و`MediaRecorder.isTypeSupported()` دون تغيير بعد الموافقة. يتم قبول كائنات القيود التفصيلية، ولكن لا تتم إعادة توجيهها. يلتقط المضيف باستخدام إعداداته الافتراضية للأنواع المطلوبة. يمكن لتطبيقات مختلفة الالتقاط بالتزامن، ولا يؤثر إيقاف تطبيق إلا في جلساته الخاصة. يدعم كل مكون أمامي عملية التقاط واحدة معلقة أو نشطة في كل مرة. خزِّن كائن `Blob` المسجَّل باستخدام دالة المضيف `uploadFile`.+### مواقع ويب مضمنة مع إمكانية الوصول إلى الوسائط++لتضمين أداة هاتف أو فيديو، صرّح عن أصل HTTPS الخاص بها في [`requestedIframeMediaPermissions`](/ar/developers/extend/apps/config/application#embedded-website-media-access) لتطبيقك، مع ضبط الوصول إلى الميكروفون والكاميرا بشكل منفصل. يمنح تثبيت التطبيق هذه المواقع صلاحية الوصول إلى مساحة العمل. تحافظ تحديثات التطبيقات المنشورة على الصلاحيات الحالية ولا تمنح تلقائيًا إمكانية وصول إضافية إلى الوسائط. تتلقى تطبيقات التطوير المتزامنة محليًا تلقائيًا المواقع المُصرّح بها في ملف البيان الخاص بها. يمكن لعضو لديه صلاحية إدارة التطبيقات الموافقة على الطلبات الجديدة من علامة التبويب **عام** للتطبيق المثبّت، ضمن **الوصول إلى وسائط موقع الويب المضمن** > **مراجعة الوصول إلى الوسائط**. تستخدم هذه الموافقة تأكيدًا أصليًا من المتصفح يعرض التطبيق وأصول مواقع الويب والوصول المطلوب إلى الميكروفون أو الكاميرا. يقرأ Twenty المواقع الممنوحة عند تحميل علامة تبويب، لذا أعد تحميل علامات تبويب Twenty المفتوحة بعد التثبيت أو الموافقة.++اطلب الميزات المقابلة على iframe:++```tsx+<iframe+ title="Aircall phone"+ src="https://workspace.aircall.io?integration=generic"+ allow="microphone"+ width={376}+ height={666}+/>+```++للفيديو، استخدم `allow="microphone; camera"` وصرّح بكليهما للأصل. يفوّض Twenty فقط الوسائط التي مُنح تطبيقك حق الوصول إليها لذلك الأصل. يجب على الأعضاء تحديد عنصر التحكم **تمكين** الخاص بالتضمين والموافقة على تأكيد أصلي من المتصفح يعرض التطبيق وأصل موقع الويب والوصول المطلوب إلى الميكروفون أو الكاميرا قبل أن يتلقى إمكانية الوصول إلى الوسائط. تظل أذونات المتصفح ونظام التشغيل سارية. لا يمكن لـ `srcDoc` والتضمينات الموجودة على أصل Twenty نفسه تلقي هذا التفويض. تستخدم عناصر واجهة تخطيط صفحة `IFRAME` المحددة من التطبيق الأصول الممنوحة للتطبيق المالك لها والتدفق نفسه للتأكيد.++تظهر التضمينات الممكّنة في مؤشر الرأس نفسه المستخدم للالتقاط الأصلي، مع **تم تمكين الوصول إلى الميكروفون** أو **تم تمكين الوصول إلى الكاميرا** بدلًا من الادعاء بأن التسجيل نشط. يبقى المؤشر مرئيًا ما دام الوصول مُمكّنًا، حتى إذا كان التضمين مخفيًا. يؤدي **تعطيل** إلى إلغاء تحميل iframe وإعادة تحميله مع حظر الوسائط. يستمر التقاط التطبيق عبر `getUserMedia()` في الإبلاغ عن الالتقاط الفعلي ويحتفظ بعنصر التحكم **إيقاف** الخاص به.++يبقى محتوى iframe في بيئة معزولة. تحتفظ تضمينات الوسائط الخارجية المعتمدة بأصلها الخاص بعد أن يفعّل العضو الوصول، مما يسمح لموقع الويب باستخدام جلسته وطلب أذونات وسائط المتصفح. تحتفظ إطارات iframe الأخرى لمكوّنات الواجهة بأصل بيئة معزولة معتم.+### فجوات أخرى* **حمولات السحب والإفلات.** أحداث السحب تُطلق، لكن `event.dataTransfer` هي `undefined`.* **الوحدات المدمجة في Node.** `fs` و`path` و`node:crypto` تفشل في عملية البناء، لذا انقل ذلك العمل إلى [دالة منطقية](/ar/developers/extend/apps/logic/logic-functions). تحل Web Crypto محل `node:crypto`، ويتوفر أيضًا كل من `fetch` و`TextEncoder` و`URL`، راجع [النطاق العام](#global-scope) — لكن لا شيء يحل محل `fs`: لا تحتوي البيئة المعزولة على نظام ملفات.-* يتم دائمًا إعادة عزل **`iframe`** دون `allow-same-origin`، لذلك يعمل التضمين الذي يعتمد على جلسته الخاصة في وضع "تسجيل الخروج". ليس لديه `onLoad` أيضًا.<PageBanner illustration="card-page-front-components" />diff --git a/packages/twenty-docs/ar/developers/extend/apps/layout/page-layouts.mdx b/packages/twenty-docs/ar/developers/extend/apps/layout/page-layouts.mdxindex fc59f85cbbb..1bad4fe8139 100644--- a/packages/twenty-docs/ar/developers/extend/apps/layout/page-layouts.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/layout/page-layouts.mdx@@ -65,6 +65,7 @@ export default definePageLayout({* عيِّن `layoutMode` بشكل صريح. إغفاله يمنحك `VERTICAL_LIST` على `STANDALONE_PAGE` و`GRID` في كل مكان آخر، وهو أمر نادرًا ما تريده في صفحة سجل.* يمكن لكل `widget` داخل لسان أن يعرض [front component](/ar/developers/extend/apps/layout/front-components)، أو قائمة علاقات، أو أنواعًا أخرى من عناصر الواجهة (widgets) المدمجة.* يمكن لأداة `FRONT_COMPONENT` تعيين `headerCommandMenuItemUniversalIdentifiers` إلى مصفوفة مرتبة من المعرّفات العامة لعناصر قائمة الأوامر من التطبيق نفسه. تظهر هذه الإجراءات كأزرار أيقونات في رأس بطاقة الأداة، وتحتفظ بفحوصات التوفر والأذونات على مستوى الأمر. يجب أن تكون المعرّفات فريدة، ويجب أن تُحل عند تثبيت التطبيق.+* يمكن لعنصر واجهة المستخدم `IFRAME` استخدام الميكروفون أو الكاميرا لمواقع الويب المعتمدة من خلال الخاصية [`requestedIframeMediaPermissions`](/ar/developers/extend/apps/config/application#embedded-website-media-access) لتطبيقه المالك. يختار الأعضاء **تمكين** ويوافقون على تأكيد أصلي من المتصفح يعرض التطبيق، وأصل موقع الويب، والوصول المطلوب إلى الميكروفون أو الكاميرا قبل بدء الوصول. لا تنطبق موافقات أمان مساحة العمل ومنح التطبيقات الأخرى على عناصر واجهة المستخدم المحددة من التطبيق.* `position` على الألسنة يتحكّم في ترتيبها. استخدم قيمًا أعلى (مثل 50) لوضع الألسنة المخصّصة بعد الألسنة المدمجة.* يكتب `twenty app pull` تخطيطات الصفحات مرة أخرى مع علامات التبويب والأدوات الخاصة بها مضمنة. تُبلّغ عملية pull عن أداة لا يمكن للتصدير نقلها بعد، مثل أداة تعرض المكوّن الأمامي الخاص بتطبيقك أو أداة من النوع `VIEW` المتوقَّف، بدلاً من كتابتها؛ راجع [ما لا تكتبه عملية pull](/ar/developers/extend/apps/operations/sync-and-recovery#pulling-an-installed-app-back-to-source).diff --git a/packages/twenty-docs/ar/developers/extend/apps/layout/views.mdx b/packages/twenty-docs/ar/developers/extend/apps/layout/views.mdxindex 793523e3fed..6d6aadf2c45 100644--- a/packages/twenty-docs/ar/developers/extend/apps/layout/views.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/layout/views.mdx@@ -87,21 +87,22 @@ filters: [### المعاملات المدعومة حسب نوع الحقل-| نوع الحقل | العوامل المدعومة |-| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |-| `TEXT`, `EMAILS`, `FULL_NAME`, `ADDRESS`, `LINKS`, `PHONES`, `RAW_JSON`, `FILES`, `ACTOR`, `ARRAY` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `ACTOR.source`, `ACTOR.workspaceMemberId` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `SELECT` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `MULTI_SELECT` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `RELATION` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `NUMBER` | `IS`, `IS_NOT`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `RATING` | `IS`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `CURRENCY`, `CURRENCY.amountMicros` | `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `CURRENCY.currencyCode` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `DATE`, `DATE_TIME` | `IS`, `IS_RELATIVE`, `IS_IN_PAST`, `IS_IN_FUTURE`, `IS_TODAY`, `IS_BEFORE`, `IS_AFTER`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `BOOLEAN` | `IS` |-| `UUID` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `TS_VECTOR` | `VECTOR_SEARCH` |+| نوع الحقل | العوامل المدعومة |+| ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |+| `TEXT` | `CONTAINS`، `DOES_NOT_CONTAIN`، `IS`، `IS_NOT`، `IS_EMPTY`، `IS_NOT_EMPTY` |+| `EMAILS`، `FUL_NAME`، `ADDRESS`، `LINKS`، `PHONES`، `RAW_JSON`، `FILES`، `ACTOR`، `ARRAY` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `ACTOR.source`, `ACTOR.workspaceMemberId` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `SELECT` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `MULTI_SELECT` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `RELATION` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `NUMBER` | `IS`, `IS_NOT`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `RATING` | `IS`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `CURRENCY`, `CURRENCY.amountMicros` | `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `CURRENCY.currencyCode` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `DATE`, `DATE_TIME` | `IS`, `IS_RELATIVE`, `IS_IN_PAST`, `IS_IN_FUTURE`, `IS_TODAY`, `IS_BEFORE`, `IS_AFTER`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `BOOLEAN` | `IS` |+| `UUID` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `TS_VECTOR` | `VECTOR_SEARCH` |> يمكن لأنواع الحقول ذات الأسماء المتشابهة أن تستخدم عوامل مختلفة تمامًا — حيث يُعد `SELECT` و`MULTI_SELECT` حالة شائعة.@@ -115,6 +116,7 @@ filters: [| `CONTAINS`, `DOES_NOT_CONTAIN` على `MULTI_SELECT` | مصفوفة من مفاتيح الخيارات (سلاسل نصية) | `['TAG_A']` || `IS`, `IS_NOT` على `RELATION` | مصفوفة من معرّفات السجلات (uuids) | `['c5a1...']` || `CONTAINS`, `DOES_NOT_CONTAIN` على الحقول المشابهة للنص | سلسلة نصية | `'acme'` |+| `IS`, `IS_NOT` في `TEXT` | سلسلة (دقيقة، حساسة لحالة الأحرف) | `Acme'` || `IS`, `IS_NOT` على `NUMBER` | سلسلة نصية (القيمة) | `'5'` || `IS` على `RATING` / `UUID` | سلسلة نصية (القيمة) | `'5'` || `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL` | سلسلة نصية (الحد) | `'10'` |diff --git a/packages/twenty-docs/ar/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/ar/developers/extend/apps/operations/cli.mdxindex 0151706d301..7f3e9f98b8c 100644--- a/packages/twenty-docs/ar/developers/extend/apps/operations/cli.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/operations/cli.mdx@@ -7,9 +7,9 @@ import { PageBanner } from "/snippets/page-banner.mdx"## تشغيل واجهة سطر الأوامر-تتصل واجهة سطر الأوامر `twenty` بمساحات عمل Twenty من طرفيتك. استخدمها لفحص البيانات الوصفية، وقراءة السجلات، وإرسال طلبات API، وإنشاء التطبيقات ومزامنتها وتصحيح أخطائها. يتطلب **Node.js 24.5+ أو 26.5+**.+تتصل واجهة سطر الأوامر `twenty` بمساحات عمل Twenty من طرفيتك. استخدمها لفحص البيانات الوصفية، وقراءة السجلات، وإرسال طلبات API، وإنشاء التطبيقات ومزامنتها وتصحيح أخطائها. تتطلب واجهة سطر الأوامر نفسها **Node.js 24.5+**. يتطلب تطوير التطبيقات أيضًا إصدار Node تدعمه SDK المثبتة، راجع [البدء السريع](/ar/developers/extend/apps/getting-started/quick-start#before-you-start).-شغّل أي أمر عبر `npx`، من دون تثبيت أي شيء:+شغّل أي أمر عبر `npx`، من دون تثبيت عام:```bash filename="Terminal"npx twenty@latest --version@@ -22,7 +22,7 @@ npm install -g twentytwenty --version```-تستخدم الأمثلة أدناه `twenty`. أضف `npx twenty@latest` كبادئة لها إذا لم تثبّتها على مستوى النظام. شغّل `twenty commands` للاطلاع على قائمة الأوامر الكاملة، و`twenty \<command> --help` للاطلاع على خيارات أمر واحد.+تستخدم الأمثلة أدناه `twenty`. استبدل `twenty` بـ `npx twenty@latest` إذا لم تثبّته بشكل عام. شغّل `twenty commands` للاطلاع على قائمة الأوامر الكاملة، و`twenty \<command> --help` للاطلاع على خيارات أمر واحد.| أمر | ماذا يفعل || ------------------ | ------------------------------------------------------------------- |@@ -65,6 +65,14 @@ printf '%s' "$TWENTY_API_KEY" | twenty auth login --with-token --url https://acmيمكنك أيضًا تعيين `TWENTY_API_URL` و`TWENTY_API_KEY` لتشغيل واحد دون حفظ أي شيء. توجد الاتصالات المحفوظة في `~/.twenty/config.json`.+تختار الأوامر مساحة عمل بهذا الترتيب:++1. `--remote \<name>` صريح، يتجاوز متغيرات بيئة الهدف.+2. `TWENTY_REMOTE`، أو الزوج `TWENTY_API_URL` و`TWENTY_API_KEY`. لا تجمع بين هاتين الطريقتين.+3. الاتصال البعيد الافتراضي المحفوظ.++يحفظ `auth login --name \<name>` اتصالًا، لكنه يحتفظ بالاتصال الافتراضي الحالي. أضف `--use`، أو شغّل `twenty remote use \<name>`، لتغيير الإعداد الافتراضي.+## استكشاف بياناتك```bash filename="Terminal"diff --git a/packages/twenty-docs/ar/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/ar/developers/extend/apps/operations/publishing.mdxindex 2db96c30001..aaf79c02910 100644--- a/packages/twenty-docs/ar/developers/extend/apps/operations/publishing.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/operations/publishing.mdx@@ -61,11 +61,11 @@ twenty auth login --url https://your-twenty-server.com --name productionبناء تطبيقك ورفعه إلى الخادم في خطوة واحدة:```bash filename="Terminal"-twenty app publish --private-# To deploy to a specific remote:-# twenty app publish --private --remote production+twenty app publish --private --remote production```+يختار الخيار الصريح `--remote production` الاتصال المحفوظ أعلاه، حتى إذا كان جهاز تحكم عن بُعد آخر هو الافتراضي لديك. لا يؤدي حفظ جهاز تحكم عن بُعد مُسمّى إلى تبديل الإعداد الافتراضي الحالي.+### مشاركة تطبيق منشورتطبيقات tarball لا تُدرَج في السوق العامة، لذا لن تكتشفها مساحات العمل الأخرى على الخادم نفسه عبر الاستعراض. لمشاركة تطبيق منشور:@@ -83,7 +83,7 @@ twenty app publish --privateلطرح تحديث:1. قم بزيادة الحقل `version` في ملف `package.json` (مثلًا: `1.2.3` → `1.2.4`، `1.3.0`، أو `2.0.0`)-2. شغّل `twenty app publish --private` (أو `twenty app publish --private --remote production`)+2. شغّل `twenty app publish --private --remote production`3. مساحات العمل التي تم تثبيت التطبيق فيها وتم تفعيل الترقية التلقائية له (في علامة التبويب «عام» الخاصة بالتطبيق) ستتم ترقيتها تلقائيًا في الخلفية؛ أما المساحات الأخرى فسترى أن الترقية متاحة في إعداداتها<Note>@@ -386,19 +386,21 @@ twenty app publish --tag beta{/* TODO: add screenshot of the UI when the app is registered */}-يمكنك أيضًا تثبيت التطبيقات من سطر الأوامر:+من دليل التطبيق، ثبّت إصداره المنشور في مساحة العمل المستهدفة:```bash filename="Terminal"-twenty app install+twenty app install --remote production```+استخدم اسم جهاز التحكم عن بُعد لمساحة العمل التي تريد تثبيت التطبيق فيها. للتثبيت دون مشروع محلي، مرّر `--universal-identifier \<id>`.+<Note>يفرض الخادم اعتماد إصدارات semver عند التثبيت، بما يعكس القواعد المطبّقة عند النشر:* تثبيت الإصدار نفسه المثبّت بالفعل في مساحة عملك يُرفَض بخطأ `APP_ALREADY_INSTALLED`.* تثبيت إصدار أدنى من الإصدار المثبّت حاليًا يُرفَض بخطأ `CANNOT_DOWNGRADE_APPLICATION`.-لتثبيت إصدار أحدث، انشره أو أصدِره أولًا، ثم أعد تشغيل `twenty app install`.+لتثبيت إصدار أحدث، انشره أو انشره أولًا، ثم أعد تشغيل `twenty app install --remote production`.</Note>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 d5e000e7ce4..2e1ac7b1f90 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@@ -21,7 +21,7 @@ import { PageBanner } from "/snippets/page-banner.mdx"| ------------------------------------------------ | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------- || التكرار محليًا مع المزامنة الحية | `twenty app dev` | يراقب ملفاتك ويجري مزامنة عند كل تغيير. || مزامنة واحدة ثم إنهاء (CI، السكربتات، الخطّافات) | `twenty app apply` | عملية إنشاء واحدة + مزامنة، ثم إنهاء. أضف `--yes` لتخطي تأكيد التغيير التدميري. |-| معاينة التغييرات **بدون تطبيقها** | `twenty app plan` | يحتسب الفرق ويطبعه؛ ولا يكتب أي شيء. |+| معاينة التغييرات **بدون تطبيقها** | `twenty app plan` | يبني محليًا ويطبع الفرق؛ ولا يغيّر مساحة العمل. || المزامنة دون حذف أي شيء | `twenty app apply --no-prune` | ينشئ ويحدّث فقط: تُترك الكيانات الموجودة في مساحة العمل ولكنها غير موجودة في مصدرك كما هي. تقبله أيضًا `plan` و`dev`. || تقليم التطبيق المخصص لمساحة العمل | `twenty app apply --prune` | يحتفظ ذلك التطبيق بالكيانات غير الموجودة في المصدر ما لم تمرر `--prune`. مقبول أيضًا بواسطة `plan` و`dev`. || إعادة إنشاء المصدر المحلي من مساحة العمل | `twenty app pull` | **تجريبي.** يستعيد ملفات التعريف والترجمات والتبعيات المخزنة. انظر أدناه. |@@ -88,7 +88,7 @@ Plan: 1 to add, 1 to change, 0 to destroy.خطة:-* **لا يكتب أي شيء** — لا ترحيل لبيانات وصفية، ولا تحديث لسجل التطبيق، ولا تغييرات في الأدوار/التبويبات الافتراضية، ولا توليد لعميل API.+* **لا يغيّر مساحة العمل**، ولا يُجري ترحيلًا للبيانات الوصفية أو تحديثًا لسجل التطبيق أو تغييرات على الدور/علامة التبويب الافتراضية. ينشئ لقطة محلية، لكنه لا يعيد إنشاء عميل API.* يُرجع **نفس الفرق** الذي ستُطبِّقه مزامنة حقيقية، حتى تتمكن من مراجعة الكيانات التي سيتم إنشاؤها/تحديثها/حذفها مسبقًا.* يكون مفيدًا قبل إجراء تغيير محفوف بالمخاطر، أو عند مراجعة تغيير تم إنشاؤه بواسطة الذكاء الاصطناعي، أو في سكربت يجب أن يفشل إذا كان تغيير غير متوقَّع على وشك الحدوث.@@ -140,13 +140,14 @@ twenty app pull --path ./workspace-app --yes --no-input* سير العمل، كملفات `defineWorkflow()`، عندما تكون نسختها المخزنة هي النسخة التي كتبتها آخر مزامنة. بالنسبة إلى التطبيق المخصص لمساحة العمل، فهي النسخة النشطة، سواء نشرتها مزامنة أو منشئ سير العمل، ويقوم التطبيق بنشر تعريف تم تغييره كنسخة جديدة، كما هو موضح في [Workflows](/ar/developers/extend/apps/logic/workflows#workflows-of-the-workspace-custom-application)؛* المهارات، كملفات `defineSkill()`؛* الوكلاء، كملفات `defineAgent()`، مع مشغلاتهم والدور الذي يربطهم به تطبيقك؛+* validation rules, as `defineValidationRule()` files with their expression as a string;* الترجمات المنشورة، بصيغة `locales/\<locale>.json` لكي يتمكن strings pull من قراءتها مجددًا من البيانات الوصفية والمصدر المسحوبين، وبصيغة `locales/compiled/\<locale>.json` للبقية.يذهب كل كيان إلى الملف الذي يعرّفه بالفعل، لذا لا يعيد السحب الثاني كتابة سوى ما تغيّر على الخادم. يُعاد أيضًا كتابة ملف عندما يستخدم دالة تعريف مختلفة عما ستكتبه عملية السحب، على سبيل المثال، دور أصبح الدور الافتراضي أو لم يعد كذلك. توضع الكيانات الجديدة بجانب الملفات الموجودة من نوعها، ويكون الاسم المُولَّد الذي قد يقع على ملف غير ذي صلة مؤهَّلًا بدلًا من استبداله.**ملفات التبعيات.** عند تغيير `package.json` أو `yarn.lock` المخزَّن، يستبدل السحب الملف المحلي ويبلّغ عن أي تعديلات محلية تمت الكتابة فوقها. إذا لم يتغير الملف البعيد منذ السحب السابق، تُحتفَظ بالتعديلات المحلية. لا يؤدي غياب ملف بعيد إلى حذف نظيره المحلي. عندما لا تتضمن الحزمة المُصدَّرة `twenty-sdk`، كما يفعل تطبيق Custom لمساحة العمل، يحتفظ السحب بتبعية SDK المحلية لكي تظل أوامر CLI قادرة على تحميل المشروع. تُكتب ملفات التبعيات والبيانات الوصفية والخط الأساسي معًا، ويُتراجع عنها معًا إذا فشلت عملية كتابة.-شغّل `yarn install` بعد سحب تغييرات التبعيات. لا يثبّت السحب الحزم، ولا يشغّل نصوص الحزم، ولا يعيد إنشاء العميل مكتوب الأنواع.+شغّل `yarn install` بعد سحب تغييرات التبعيات. يقوم Pull بتثبيت التبعيات فقط عند إنشاء مشروع جديد، قبل استعادة الملفات البعيدة؛ ولا يعيد تثبيتها بعد استبدال `package.json` أو `yarn.lock`. لا يعيد Pull إنشاء العميل محدد الأنواع. شغّل `twenty app generate-client` عندما تحتاج إلى أنواع محدّثة لمساحة العمل.**ما الذي لا يكتبه:**@@ -157,6 +158,7 @@ twenty app pull --path ./workspace-app --yes --no-input* **أدوات لا يمكن للتصدير حملها بعد** — في أي تخطيط، بما في ذلك تخطيطك الخاص، يتم الإبلاغ عن أداة من النوع المهمل `VIEW`، أو أداة تعرض أحد المكوّنات الأمامية الخاصة بتطبيقك أو عناصر قائمة الأوامر، أو أداة بلا موضع لوضع تخطيط علامة التبويب الخاصة بها، ويُكتب التخطيط أو علامة التبويب بدونها.* **سير العمل التي لا يمكن للتصدير نقلها بعد** — يُبلّغ عن سير عمل تم تغييره في منشئ سير العمل منذ آخر مزامنة، أو سير عمل للنظام أو خاص، أو سير عمل يتضمن خطوة Code أو رسالة دردشة، وهي أمور لا يدعمها سير عمل التطبيق، وكذلك سير عمل يستدعي إجراء سير عمل لتطبيق آخر، ويُترك في مكانه. يُعد التطبيق المخصص لمساحة العمل الاستثناء للحالتين الأولى والأخيرة: إذ ينشر المنشئ سير العمل الخاص به أيضًا، وقد يستدعي إجراءات أي تطبيق، لذا يتم جلبه. يتم الإبلاغ عن أحد مهام سير العمل الخاصة به بدلًا من ذلك عندما لا تكون له نسخة نشطة، أو عندما تستخدم نسخته النشطة إعدادات لا يمكن للتعريف التعبير عنها. تُستخرج خطوات البريد الإلكتروني والتقويم: يُكتب الحساب المشترك مع مساحة العمل بوصفه `connectedAccountHandle` الخاص به، بينما يُحتفظ بالحساب الخاص بالعضو والمتغيرات كما هي. يُبلّغ عن سير العمل بدلاً من ذلك عندما يكون حساب إحدى الخطوات مؤرشفًا، أو لم يعد بإمكانه تنفيذ الخطوة، أو يشارك عنوانه مع حساب أقدم، لأن تطبيق المعرّف سيختار حسابًا آخر.* **الوكلاء الذين لا يمكن للتصدير نقلهم بعد** — يُبلّغ عن الوكيل الذي له أكثر من دور واحد، أو المرتبط بدور لا تكتب إليه عملية السحب، ويُترك في مكانه.+* **Validation rules the export cannot carry yet** — a rule with no expression or message, such as an unfinished draft from Settings, or one that reads a field deleted from the workspace, is reported and left in place.* **حالة وقت التشغيل لمساحة العمل**، ومرفقات السجلات، ومرفقات البريد الإلكتروني، وتعيينات أدوار الأعضاء ومفاتيح API، وخطافات الويب، والتنقل لكل مستخدم، وعناصر التنقل المثبتة في سجل، كلها مستبعدة حسب التصميم، بما في ذلك لتطبيق Custom لمساحة العمل.* **مملوك لتطبيق آخر** — يُبلَّغ عنه، ولا يُسحب مطلقًا.@@ -174,12 +176,12 @@ twenty app pull --path ./workspace-app --yes --no-input2. **عاين الخطة.** شغّل `twenty app plan` لمعرفة ما الذي تنوي المزامنة التالية تغييره بالضبط، دون تطبيقه.3. **اقرأ الخطأ المسمّى.** إذا فشلت المزامنة، لاحظ نوع البيانات الوصفية و`universalIdentifier` في الرسالة (انظر أعلاه) وحدّد ذلك الكيان في ملف manifest الخاص بك. يشير التعارض عادةً إلى معرّف مكرر أو مُعاد استخدامه.4. **ألغِ التثبيت وأعِد التثبيت.** شغّل `twenty app uninstall`، ثم أجرِ المزامنة مرة أخرى (`twenty app dev`). هذا يعيد بناء بيانات التطبيق الوصفية من نقطة بداية نظيفة مع إبقاء باقي مساحة العمل سليمة.-5. **إعادة تعيين كاملة (الملاذ الأخير).** أعِد تعيين قاعدة بيانات التطوير في Docker أو المستودع، ثم أعد التهيئة والمزامنة.+5. **إعادة ضبط كاملة (كحل أخير).** لبيئة محلية تُدار عبر CLI، شغّل `twenty local reset`، ثم `twenty local start` وأعِد الاتصال قبل المزامنة مجددًا. بالنسبة إلى نسخة مصدر تم سحبها، أعِد ضبط قاعدة بيانات التطوير الخاصة بها وأعِد ملأها بالبيانات الأولية بدلًا من ذلك.<Warning>- تؤدي إعادة تعيين قاعدة بيانات التطوير في Docker أو المستودع إلى حذف **كل** البيانات- في نسختك المحلية — كل مساحة عمل وسجل وتطبيق. استخدمها فقط بعد- فشل الخطوات السابقة.+ تؤدي إعادة ضبط بيئتك المحلية أو قاعدة بيانات التطوير للمستودع إلى حذف+ **كل** البيانات في النسخة المحلية لديك، وكل مساحة عمل، وكل سجل، وكل تطبيق. استخدمه فقط+ بعد فشل الخطوات السابقة.</Warning><Note>diff --git a/packages/twenty-docs/ar/developers/extend/apps/operations/testing.mdx b/packages/twenty-docs/ar/developers/extend/apps/operations/testing.mdxindex cc172b36f23..ff7d660faad 100644--- a/packages/twenty-docs/ar/developers/extend/apps/operations/testing.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/operations/testing.mdx@@ -176,7 +176,7 @@ yarn test:watchtwenty app typecheck```-يشغِّل هذا الأمر `tsc --noEmit` على ملف `tsconfig.json` الخاص بتطبيقك ويبلغ عن أي أخطاء في الأنواع. كما تتضمن التطبيقات المُنشأة بالهيكل برنامج نصي `yarn typecheck` يشمل ملفات الاختبار (`tsconfig.spec.json`) أيضًا.+يتحقق هذا من `tsconfig.json` الخاص بتطبيقك باستخدام مترجم TypeScript المثبت لديه، دون إنشاء ملفات، ويبلّغ عن أي أخطاء في الأنواع. كما تتضمن التطبيقات المُنشأة بالهيكل برنامج نصي `yarn typecheck` يشمل ملفات الاختبار (`tsconfig.spec.json`) أيضًا.## التكامل المستمر (CI) باستخدام GitHub Actionsdiff --git a/packages/twenty-docs/ar/user-guide/calendar-emails/capabilities/calendar.mdx b/packages/twenty-docs/ar/user-guide/calendar-emails/capabilities/calendar.mdxindex 060262aac84..bb62b055a69 100644--- a/packages/twenty-docs/ar/user-guide/calendar-emails/capabilities/calendar.mdx+++ b/packages/twenty-docs/ar/user-guide/calendar-emails/capabilities/calendar.mdx@@ -15,7 +15,7 @@ import { PageBanner } from "/snippets/page-banner.mdx"## علامة تبويب التقويم-بجانب علامة تبويب البريد الإلكتروني في السجلات، ستجد علامة تبويب `التقويم` التي تحتوي على سجلّ الاجتماعات المجدولة المرتبطة بذلك السجل.+بجانب علامة تبويب الرسائل في السجلات، ستجد علامة تبويب `Calendar` التي تحتوي على سجل الاجتماعات المجدولة مع السجل.### متاح لـ@@ -26,7 +26,7 @@ import { PageBanner } from "/snippets/page-banner.mdx"### عرض تاريخ الاجتماعات1. **انتقل إلى سجل**: انتقل إلى أي سجل لشخص، شركة، أو فرصة-2. **اختر علامة تبويب التقويم**: انقر على علامة التبويب `التقويم` بجانب علامة البريد الإلكتروني+2. **اختر علامة تبويب التقويم**: انقر على علامة التبويب `Calendar` بجانب علامة تبويب الرسائل3. **تصفح تاريخ الاجتماعات**: عرض جميع الاجتماعات المجدولة وتفاصيلها4. **الوصول إلى سياق الاجتماع**: شاهد المشاركين في الاجتماع، الأوقات، والمعلومات ذات الصلةdiff --git a/packages/twenty-docs/ar/user-guide/calendar-emails/capabilities/mailbox.mdx b/packages/twenty-docs/ar/user-guide/calendar-emails/capabilities/mailbox.mdxindex 8ff71fca681..9764553cc6f 100644--- a/packages/twenty-docs/ar/user-guide/calendar-emails/capabilities/mailbox.mdx+++ b/packages/twenty-docs/ar/user-guide/calendar-emails/capabilities/mailbox.mdx@@ -24,7 +24,7 @@ import { PageBanner } from "/snippets/page-banner.mdx"### عرض سلاسل البريد الإلكتروني1. **انتقل إلى سجل**: انتقل إلى أي سجل لشخص، شركة، أو فرصة-2. **اختر علامة تبويب البريد الإلكتروني**: انقر على علامة التبويب `البريد الإلكتروني` لعرض الرسائل المتزامنة+2. **اختر علامة تبويب الرسائل**: انقر على علامة التبويب `Messages` لعرض رسائل البريد الإلكتروني المتزامنة3. **افتح سلسلة رسائل البريد الإلكتروني**: انقر على أي رسالة بريد إلكتروني لفتحها وقراءة المحادثة بالكامل4. **تصفح التاريخ**: انتقل عبر السجل الكامل للبريد الإلكتروني مع تلك الجهةdiff --git a/packages/twenty-docs/ar/user-guide/dashboards/capabilities/widgets.mdx b/packages/twenty-docs/ar/user-guide/dashboards/capabilities/widgets.mdxindex 5c9bad3c672..59fd9fa6cf3 100644--- a/packages/twenty-docs/ar/user-guide/dashboards/capabilities/widgets.mdx+++ b/packages/twenty-docs/ar/user-guide/dashboards/capabilities/widgets.mdx@@ -104,11 +104,13 @@ import { ChartIcon } from '/snippets/chart-icon.mdx';ضمّن الأدوات والمحتوى الخارجي مباشرةً في لوحة المعلومات الخاصة بك.-بالنسبة إلى الهواتف المضمنة أو أدوات الفيديو، يمكن لعضو لديه إذن إدارة الأمان تكوين **الإعدادات ← عام ← الأمان ← الوصول إلى وسائط الموقع الإلكتروني المضمنة**. أضف مصدر HTTPS الدقيق للموقع الإلكتروني، مثل `https://workspace.aircall.io`، وفعّل **الميكروفون** أو **الكاميرا** أو كليهما. لا تُقبل المسارات وأحرف البدل. وافق فقط على المواقع الإلكترونية التي تثق بها.+بالنسبة إلى عناصر iframe المضافة في مساحة العمل، يمكن لعضو لديه إذن إدارة الأمان تهيئة **الإعدادات → عام → الأمان → الوصول إلى وسائط موقع الويب المضمّنة**. أضف مصدر HTTPS الدقيق للموقع الإلكتروني، مثل `https://workspace.aircall.io`، وفعّل **الميكروفون** أو **الكاميرا** أو كليهما. لا تُقبل المسارات وأحرف البدل. وافق فقط على المواقع الإلكترونية التي تثق بها.-أعد تحميل علامات تبويب Twenty المفتوحة بعد تغيير هذه الأذونات. تؤدي إعادة التحميل إلى إنهاء المكالمات والتسجيلات النشطة. يختار كل عضو بعد ذلك **تمكين الميكروفون** أو **تمكين الكاميرا** أو **تمكين الميكروفون والكاميرا** في التضمين ويوافق على إذن المتصفح عند المطالبة بذلك.+تستخدم تضمينات الوسائط التي يوفرها تطبيق مثبّت موافقة منفصلة: يعلن التطبيق عن موقع الويب في [`requestedIframeMediaPermissions`](/ar/developers/extend/apps/config/application#embedded-website-media-access)، ويوافق عليها عضو يمكنه إدارة التطبيقات أثناء التثبيت. تنطبق هذه الأذونات على مكوّنات الواجهة الأمامية الخاصة بالتطبيق وعناصر iframe الخاصة به. لا تنطبق موافقات أمان مساحة العمل وأذونات التطبيقات الأخرى على العناصر التي يعرّفها التطبيق.-يعرض مؤشر الرأس **تم تمكين الوصول إلى الوسائط** بينما يكون لدى تضمين إمكانية وصول، بما في ذلك عندما يكون مخفيًا. لا يعني هذا أن موقع الويب يسجل حاليًا: لا يمكن لـ Twenty فحص نشاط الميكروفون أو الكاميرا داخل موقع ويب آخر. حدد المؤشر واختر **تعطيل** لإلغاء تحميل التضمين وإعادة تحميله مع حظر الوصول إلى الوسائط. يتطلب تمكين الوصول مرة أخرى نقرة أخرى.+أعد تحميل علامات تبويب Twenty المفتوحة بعد تغيير هذه الأذونات. تؤدي إعادة التحميل إلى إنهاء المكالمات والتسجيلات النشطة. في كل مرة يختار فيها عضو **Enable microphone** أو **Enable camera** أو **Enable microphone and camera** على تضمين، يظهر تأكيد أصلي من المتصفح يعرض الأداة أو التطبيق المالك، وأصل موقع الويب، وإمكانية الوصول المطلوبة إلى الميكروفون أو الكاميرا. بعد التأكيد، وافق على إذن الوسائط الخاص بالمتصفح عندما يُطلب منك ذلك. ينطبق هذا التأكيد على كل من أدوات مساحة العمل والتضمينات التي توفرها التطبيقات.++يعرض مؤشر الرأس **تم تمكين الوصول إلى الوسائط** بينما يكون لدى تضمين إمكانية وصول، بما في ذلك عندما يكون مخفيًا. لا يعني هذا أن موقع الويب يسجل حاليًا: لا يمكن لـ Twenty فحص نشاط الميكروفون أو الكاميرا داخل موقع ويب آخر. حدد المؤشر واختر **تعطيل** لإلغاء تحميل التضمين وإعادة تحميله مع حظر الوصول إلى الوسائط. اختر **Enable** مرة أخرى لاستعادة إمكانية الوصول.<Frame><img src="/images/user-guide/dashboard/dashboard-widget-table.png" alt="الجدول البياني" />diff --git a/packages/twenty-docs/es/developers/extend/apps/config/application.mdx b/packages/twenty-docs/es/developers/extend/apps/config/application.mdxindex 0311c95ae67..b013c2728ea 100644--- a/packages/twenty-docs/es/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/config/application.mdx@@ -79,6 +79,29 @@ Una aplicación instalada sin la concesión requerida pausa la captura y muestraConsulta [Captura multimedia](/es/developers/extend/apps/layout/front-components#media-capture) para conocer el comportamiento de la captura y los indicadores de grabación.+## Acceso a medios de sitios web incrustados++Establezca `requestedIframeMediaPermissions` cuando un componente frontal o un widget de diseño de página `IFRAME` incruste un sitio web que necesite el micrófono o la cámara, como una herramienta de teléfono o vídeo. Enumere hasta 20 sitios web, cada uno como un origen HTTPS exacto, con el acceso al micrófono y a la cámara configurado por separado. Los orígenes deben ser únicos, no contener rutas ni comodines y solicitar acceso al menos al micrófono o a la cámara.++```ts+import { defineApplication } from 'twenty-sdk/define';++export default defineApplication({+ universalIdentifier: '39783023-bcac-41e3-b0d2-ff1944d8465d',+ displayName: 'Phone',+ description: 'Call your contacts from Twenty',+ requestedIframeMediaPermissions: [+ { origin: 'https://workspace.aircall.io', microphone: true, camera: false },+ ],+});+```++Los sitios web declarados aparecen durante la instalación. La aprobación requiere un miembro del espacio de trabajo que pueda administrar aplicaciones y se aplica a todo el espacio de trabajo, para los propios componentes frontales y widgets iframe de la aplicación. Las aprobaciones de seguridad del espacio de trabajo se aplican solo a los widgets creados en el espacio de trabajo. Las aplicaciones de desarrollo sincronizadas localmente reciben los sitios web declarados en su manifiesto. Estas autorizaciones no sustituyen los permisos del navegador ni del sistema operativo. Las cabeceras del navegador tienen un límite de tamaño, por lo que, si los sitios web de un espacio de trabajo lo superan, los sitios web aprobados por el espacio de trabajo tienen prioridad y los sitios web restantes no reciben acceso a medios.++Las actualizaciones de las aplicaciones publicadas conservan las autorizaciones existentes y no conceden automáticamente acceso adicional a medios. Para aprobar nuevas solicitudes, un miembro que pueda administrar aplicaciones abre la pestaña **General** de la aplicación instalada y selecciona **Revisar acceso a medios** en **Acceso a medios de sitios web incrustados**. Esta aprobación utiliza una confirmación nativa del navegador que muestra la aplicación, los orígenes de los sitios web y el acceso solicitado al micrófono o a la cámara. Después de aprobar, vuelva a cargar las pestañas abiertas de Twenty para aplicar los permisos actualizados.++Consulte [Sitios web incrustados con acceso a medios](/es/developers/extend/apps/layout/front-components#embedded-websites-with-media-access) para conocer los requisitos de iframe.+## Tipos de variablesTanto `applicationVariables` como `serverVariables` aceptan un `type` opcional (y, para `SELECT` / `MULTI_SELECT`, una lista de `options`). Tipos admitidos: `TEXT` (predeterminado), `BOOLEAN`, `NUMBER`, `NUMERIC`, `DATE`, `DATE_TIME`, `SELECT`, `MULTI_SELECT`, `ARRAY`, `RAW_JSON`, `RICH_TEXT`.diff --git a/packages/twenty-docs/es/developers/extend/apps/data/overview.mdx b/packages/twenty-docs/es/developers/extend/apps/data/overview.mdxindex 1cbd2c0fa18..4393fe24dbc 100644--- a/packages/twenty-docs/es/developers/extend/apps/data/overview.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/data/overview.mdx@@ -46,6 +46,10 @@ La **capa de datos** de una aplicación de Twenty es el conjunto de datos que tu<CardTitle>Tipos de actividad de línea de tiempo</CardTitle>Definir eventos de auditoría automática y eventos explícitos de la aplicación para grabar cronología.</Card>+ <Card href="/es/developers/extend/apps/data/objects" img="/images/user-guide/halftone/card-page-objects.svg">+ <CardTitle>Reglas de validación</CardTitle>+ `defineValidationRule` — declara las condiciones que un registro debe cumplir antes de poder guardarse.+ </Card></CardGroup>## Entidades de un vistazo@@ -58,8 +62,9 @@ La **capa de datos** de una aplicación de Twenty es el conjunto de datos que tu| **Índice** | Un índice de base de datos para acelerar una consulta recurrente sobre uno de tus objetos | `defineIndex()` || **Tipo de actividad de la cronología** | Un evento de auditoría automático o un evento de dominio explícito mostrado en las líneas de tiempo de los registros | `defineTimelineActivityType()` || **Ruta de registros relacionados** | Una cadena de hasta tres relaciones a través de las cuales el acceso a un registro se extiende a sus registros relacionados | `defineRelatedRecordPath()` |+| **Regla de validación** | Una condición que un registro debe cumplir antes de poder guardarse | `defineValidationRule()` |-El CLI detecta estas mediante análisis AST en tiempo de compilación, por lo que la organización de archivos depende de ti; la convención es `src/objects/`, `src/fields/`, `src/indexes/`, `src/timeline-activity-types/` y `src/related-record-paths/`. Los UUID `universalIdentifier` estables vinculan todo a través de los despliegues.+La CLI detecta estos mediante análisis AST en tiempo de compilación, por lo que la organización de los archivos depende de ti; la convención es `src/objects/`, `src/validation-rules/`, `src/fields/`, `src/indexes/`, `src/timeline-activity-types/` y `src/related-record-paths/`. Los UUID `universalIdentifier` estables vinculan todo a través de los despliegues.## Índices (opcional)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 3efaf0052ae..91d2b0b1c1a 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@@ -18,6 +18,7 @@ your-app/│ ├── roles/ ← defineRole│ ├── objects/ ← defineObject│ ├── fields/ ← defineField+│ ├── validation-rules/ ← defineValidationRule│ ├── logic-functions/ ← defineLogicFunction│ ├── front-components/ ← defineFrontComponent│ ├── skills/ ← defineSkill@@ -46,6 +47,7 @@ your-app/| **Object** | Tipos de registros personalizados con campos | [Objetos](/es/developers/extend/apps/data/objects) || **Campo** | Agregar campos a objetos de otras aplicaciones | [Ampliar objetos](/es/developers/extend/apps/data/extending-objects) || **Relación** | Vínculos bidireccionales entre objetos | [Relaciones](/es/developers/extend/apps/data/relations) |+| **Regla de validación** | Condiciones que debe cumplir un registro antes de poder guardarse | [Reglas de validación](/es/developers/extend/apps/data/validation-rules) || **Función de lógica** | TypeScript del lado del servidor con activadores | [Funciones de lógica](/es/developers/extend/apps/logic/logic-functions) || **Habilidad** | Instrucciones reutilizables para agentes de IA | [Habilidades y agentes](/es/developers/extend/apps/logic/skills-and-agents) || **Agente** | Asistentes de IA con prompts personalizados | [Habilidades y agentes](/es/developers/extend/apps/logic/skills-and-agents) |@@ -86,7 +88,7 @@ your-app/└─────────────────────────────────────────────────────────┘```-* **`veinte aplicaciones dev`** — observa tus archivos de origen y los cambios en live-syncs a un servidor conectado Veenty . El cliente de API tipado se regenera automáticamente cuando cambia el esquema.+* **`veinte aplicaciones dev`** — observa tus archivos de origen y los cambios en live-syncs a un servidor conectado Veenty . Tras una sincronización correcta, regenera el cliente de API tipado cuando el esquema o el paquete del generador instalado han cambiado, o cuando faltan archivos del cliente generado o han cambiado. Para actualizar los tipos después de cambiar el espacio de trabajo en la interfaz de usuario, ejecuta `twenty app generate-client`.* **`veinte apps build`** — compila TypeScript, agrupa funciones lógicas y componentes frontales con esbuild, y produce un manifiesto.* **Hooks de pre/post-instalación y desinstalación** — funciones opcionales que se ejecutan durante la instalación o justo antes de la desinstalación. Consulta [Hooks de instalación](/es/developers/extend/apps/config/install-hooks) para más detalles.diff --git a/packages/twenty-docs/es/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/es/developers/extend/apps/getting-started/local-server.mdxindex 878eda9e4cf..663e5c52b8e 100644--- a/packages/twenty-docs/es/developers/extend/apps/getting-started/local-server.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/getting-started/local-server.mdx@@ -93,7 +93,7 @@ Para una copia del código fuente de Twenty, el entorno de desarrollo existente```bashbash packages/twenty-utils/setup-dev-env.shyarn start-twenty auth login --url http://localhost:3000 --name local+twenty auth login --url http://localhost:3000 --name local --use```Usa la URL y el puerto reales de tu servidor. Para espacios de trabajo con subdominios, usa el@@ -102,8 +102,9 @@ nombre de host del espacio de trabajo. Para la implementación en producción, s## Dependencias del proyecto-Instala `twenty-sdk` y `twenty-client-sdk` como dependencias del proyecto. Instala la-CLI de `twenty` globalmente y, a continuación, ejecuta `twenty app typecheck`, `twenty app build` y-`twenty app apply` desde el directorio de la aplicación.+`twenty app init` declara `twenty-sdk`, `twenty-client-sdk` y `twenty-ui` en+`devDependencies`, pero no los instala. Con la CLI `twenty` instalada+globalmente, ejecuta `yarn install` desde el directorio de la aplicación generada antes de ejecutar+`twenty app typecheck`, `twenty app build` o `twenty app apply`.<PageBanner illustration="dev-self-host" />diff --git a/packages/twenty-docs/es/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/es/developers/extend/apps/getting-started/project-structure.mdxindex c0659542cb9..75b5c5a309a 100644--- a/packages/twenty-docs/es/developers/extend/apps/getting-started/project-structure.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/getting-started/project-structure.mdx@@ -12,6 +12,7 @@ Una nueva app generada por `twenty app init` se ve así:```text filename="my-twenty-app/"my-twenty-app/package.json+ yarn.lock # Created by app init; used by yarn installsrc/application-config.ts # Required — your app's entry pointdefault-role.ts # Permissions for logic functions@@ -28,6 +29,7 @@ my-twenty-app/__tests__/application-config.test.ts # Unit testglobal-setup.ts # Integration test setup (sync + uninstall)+ run-twenty.ts # CLI subprocess helper for testsschema.integration-test.ts # Integration test against a live server.github/workflows/ci.yml # Lint, typecheck, unit + integration tests@@ -67,20 +69,9 @@ my-twenty-app/## Dependencias-Los paquetes de SDK y UI de Twenty deben incluirse en `devDependencies`:+`twenty app init` coloca `twenty-sdk`, `twenty-client-sdk` y `twenty-ui` en `devDependencies`, fijados a la versión del SDK seleccionada por esa versión de la CLI. Conserva las versiones generadas para una aplicación nueva y mantén los tres paquetes sincronizados al actualizar. La CLI puede recibir versiones de parche de forma independiente, por lo que su versión no tiene por qué coincidir con la de estos paquetes.-```json filename="package.json"-{- "dependencies": {},- "devDependencies": {- "twenty-client-sdk": "2.40.0",- "twenty-sdk": "2.40.0",- "twenty-ui": "2.40.0"- }-}-```--`twenty app init` fija `twenty-sdk`, `twenty-client-sdk` y `twenty-ui` a su propia versión. Mantén los tres sincronizados al actualizar.+El `engines.twenty` generado establece la versión mínima del servidor en la versión principal y secundaria de ese SDK. Los Workflows generados de GitHub Actions fijan la CLI por separado.* **`twenty-sdk`** proporciona definiciones de apps, asistentes de tiempo de ejecución e integración del renderizador. Usa el paquete **`twenty`** instalado por separado para los comandos de CLI y las herramientas de compilación/generación de estructura.* **`twenty-client-sdk`** *sí* es importado por el código de tu app (`CoreApiClient`, `MetadataApiClient`, `RestApiClient`), pero Twenty lo proporciona en tiempo de ejecución: las funciones lógicas lo obtienen de una capa SDK generada y los componentes de front lo resuelven desde módulos servidos por el servidor. Tu copia instalada solo se utiliza para la comprobación de tipos y el build en tiempo de despliegue, por lo que nunca necesita incluirse en el bundle desplegado.diff --git a/packages/twenty-docs/es/developers/extend/apps/getting-started/quick-start.mdx b/packages/twenty-docs/es/developers/extend/apps/getting-started/quick-start.mdxindex 2b3f663c562..c072a4576b7 100644--- a/packages/twenty-docs/es/developers/extend/apps/getting-started/quick-start.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/getting-started/quick-start.mdx@@ -8,7 +8,7 @@ import { CardTitle } from "/snippets/card-title.mdx"## Antes de empezar-Usa Node.js 24.5+ o 26.5+ y Yarn 4 (mediante Corepack: `corepack enable`; en Node 26, instálalo primero con `npm install -g corepack`). Instala la CLI globalmente; tu aplicación conserva sus propias dependencias del SDK.+Use Node.js 24 (24.5+) o 26 (26.5.1+) y Yarn 4 (mediante Corepack: `corepack enable`; en Node 26, instálelo primero con `npm install -g corepack`). Instala la CLI globalmente; tu aplicación conserva sus propias dependencias del SDK.<Note>La compilación de aplicaciones Twenty solo es compatible oficialmente con sistemas Unix (macOS y Linux). En Windows, trabaja dentro de WSL 2.@@ -30,9 +30,12 @@ yarn installUsa un espacio de trabajo existente o inicia un [servidor local](/es/developers/extend/apps/getting-started/local-server) y, a continuación, inicia sesión:```bash-twenty auth login --url https://your-workspace.twenty.com --name dev+twenty auth login --url https://your-workspace.twenty.com --name dev --use+twenty auth status --remote dev```+`--name dev` guarda la conexión como `dev`; `--use` la establece como predeterminada para los comandos siguientes. Para dirigirse a ella explícitamente, agregue `--remote dev`. Las variables de entorno pueden anular el valor predeterminado; consulte la [selección del espacio de trabajo](/es/developers/extend/apps/operations/cli#connecting-to-a-workspace).+## Sincroniza tus cambiosPara la primera sincronización, permite explícitamente el registro y la instalación:diff --git a/packages/twenty-docs/es/developers/extend/apps/getting-started/scaffolding.mdx b/packages/twenty-docs/es/developers/extend/apps/getting-started/scaffolding.mdxindex baaecb416eb..7994d301e34 100644--- a/packages/twenty-docs/es/developers/extend/apps/getting-started/scaffolding.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/getting-started/scaffolding.mdx@@ -7,12 +7,13 @@ import { PageBanner } from "/snippets/page-banner.mdx"## Resumen-Use la CLI independiente para generar un objeto, campo, función lógica o componente front-end:+Utiliza la CLI independiente para generar un objeto, campo, regla de validación, función lógica o componente de front:```bashtwenty app addtwenty app add object --name invoice --name-plural invoices --no-inputtwenty app add field --name amount --type NUMBER --object <object-uuid> --no-input+twenty app add validation-rule --name invoice-has-amount --object <object-uuid> --no-inputtwenty app add logic-function --name send-invoice --no-inputtwenty app add front-component --name invoice-panel --no-input```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 37332d53ec9..45366f47c4b 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@@ -1203,10 +1203,31 @@ Un punto naranja en la cabecera del espacio de trabajo indica una captura activa`getUserMedia()` y `MediaRecorder` se ejecutan mediante polyfills de sandbox, por lo que el código de grabación estándar y `MediaRecorder.isTypeSupported()` funcionan sin cambios tras la aprobación. Se aceptan objetos de restricciones detallados, pero no se reenvían. El anfitrión captura con sus valores predeterminados para los tipos solicitados. Distintas aplicaciones pueden capturar simultáneamente, y detener una aplicación afecta solo a sus propias sesiones. Cada componente frontal admite una captura pendiente o activa a la vez. Almacena un `Blob` grabado con la función host `uploadFile`.+### Sitios web incrustados con acceso a medios++Para incrustar una herramienta de teléfono o video, declare su origen HTTPS en [`requestedIframeMediaPermissions`](/es/developers/extend/apps/config/application#embedded-website-media-access) de su aplicación, con el acceso al micrófono y a la cámara configurados por separado. La instalación de la aplicación concede estos sitios web al espacio de trabajo. Las actualizaciones de las aplicaciones publicadas conservan las concesiones existentes y no conceden automáticamente acceso adicional a medios. Las aplicaciones de desarrollo sincronizadas localmente reciben automáticamente los sitios web declarados en su manifiesto. Un miembro que puede administrar aplicaciones puede aprobar nuevas solicitudes desde la pestaña **General** de la aplicación instalada, en **Acceso a medios de sitios web incrustados** > **Revisar acceso a medios**. Esta aprobación utiliza una confirmación nativa del navegador que muestra la aplicación, los orígenes de los sitios web y el acceso solicitado al micrófono o la cámara. Twenty lee los sitios web autorizados cuando se carga una pestaña, por lo que debe recargar las pestañas abiertas de Twenty después de la instalación o aprobación.++Solicite las funciones correspondientes en el iframe:++```tsx+<iframe+ title="Aircall phone"+ src="https://workspace.aircall.io?integration=generic"+ allow="microphone"+ width={376}+ height={666}+/>+```++Para video, use `allow="microphone; camera"` y declare ambos para el origen. Twenty solo delega los medios concedidos a su aplicación para ese origen. Los miembros deben seleccionar el control **Habilitar** de la incrustación y aprobar una confirmación nativa del navegador que muestre la aplicación, el origen del sitio web y el acceso solicitado al micrófono o la cámara antes de que reciba acceso a medios. Los permisos del navegador y del sistema operativo siguen aplicándose. `srcDoc` y las incrustaciones en el propio origen de Twenty no pueden recibir esta delegación. Los widgets de diseño de página `IFRAME` definidos por la aplicación usan los orígenes concedidos de su aplicación propietaria y el mismo flujo de confirmación.++Las incrustaciones habilitadas aparecen en el mismo indicador de encabezado que la captura nativa, con **Acceso al micrófono habilitado** o **Acceso a la cámara habilitado** en lugar de afirmar que la grabación está activa. El indicador permanece visible mientras el acceso está habilitado, incluso si la incrustación está oculta. **Deshabilitar** descarga el iframe y lo vuelve a cargar con los medios bloqueados. La captura de la aplicación mediante `getUserMedia()` sigue informando la captura real y conserva su propio control **Detener**.++El contenido del iframe permanece aislado. Las incrustaciones de medios externos aprobadas conservan su propio origen después de que el miembro habilita el acceso, lo que permite al sitio web usar su sesión y solicitar permisos de medios del navegador. Otros iframes de componentes de interfaz conservan un origen de aislamiento opaco.+### Otras carencias* **Cargas útiles de arrastrar y soltar.** Los eventos de arrastre se disparan, pero `event.dataTransfer` es `undefined`.* **Integraciones nativas de Node.** `fs`, `path` y `node:crypto` hacen que la compilación falle, así que mueve ese trabajo a una [función de lógica](/es/developers/extend/apps/logic/logic-functions). Web Crypto reemplaza a `node:crypto`, y `fetch`, `TextEncoder` y `URL` también están disponibles; consulta el [ámbito global](#global-scope), pero nada reemplaza a `fs`: el entorno aislado no tiene sistema de archivos.-* **`iframe`** siempre se vuelve a aislar sin `allow-same-origin`, por lo que un embed que depende de su propia sesión se renderiza como desconectado. Tampoco tiene `onLoad`.<PageBanner illustration="card-page-front-components" />diff --git a/packages/twenty-docs/es/developers/extend/apps/layout/page-layouts.mdx b/packages/twenty-docs/es/developers/extend/apps/layout/page-layouts.mdxindex 40a8fa893cd..c8f9cad5bfb 100644--- a/packages/twenty-docs/es/developers/extend/apps/layout/page-layouts.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/layout/page-layouts.mdx@@ -65,6 +65,7 @@ export default definePageLayout({* Establece `layoutMode` explícitamente. Omitirlo te da `VERTICAL_LIST` en una `STANDALONE_PAGE` y `GRID` en todos los demás casos, lo cual rara vez es lo que quieres en una página de registro.* Cada `widget` dentro de una pestaña puede renderizar un [componente de frontend](/es/developers/extend/apps/layout/front-components), una lista de relaciones u otros tipos de widget integrados.* Un widget `FRONT_COMPONENT` puede establecer `headerCommandMenuItemUniversalIdentifiers` en una matriz ordenada de identificadores universales de elementos de menú de comandos de la misma aplicación. Estas acciones aparecen como botones de icono en el encabezado de la tarjeta del widget y conservan sus comprobaciones de disponibilidad y permisos a nivel de comando. Los identificadores deben ser únicos y deben resolverse cuando se instale la aplicación.+* Un widget de `IFRAME` puede usar el micrófono o la cámara en sitios web aprobados mediante [`requestedIframeMediaPermissions`](/es/developers/extend/apps/config/application#embedded-website-media-access) de la aplicación a la que pertenece. Los miembros seleccionan **Habilitar** y aprueban una confirmación nativa del navegador que muestra la aplicación, el origen del sitio web y el acceso solicitado al micrófono o a la cámara antes de que comience el acceso. Las aprobaciones de seguridad del espacio de trabajo y las concesiones de otras aplicaciones no se aplican a los widgets definidos por la aplicación.* `position` en las pestañas controla su orden. Usa valores más altos (p. ej., 50) para colocar pestañas personalizadas después de las integradas.* `twenty app pull` vuelve a escribir los diseños de página con sus pestañas y widgets integrados. Un widget que la exportación todavía no puede incluir, como uno que muestra el propio componente frontal de su aplicación o uno del tipo `VIEW` obsoleto, se informa mediante pull en lugar de escribirse; consulte [lo que pull no escribe](/es/developers/extend/apps/operations/sync-and-recovery#pulling-an-installed-app-back-to-source).diff --git a/packages/twenty-docs/es/developers/extend/apps/layout/views.mdx b/packages/twenty-docs/es/developers/extend/apps/layout/views.mdxindex d1da3b0d61e..1d27875583e 100644--- a/packages/twenty-docs/es/developers/extend/apps/layout/views.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/layout/views.mdx@@ -87,21 +87,22 @@ Tres propiedades opcionales refinan un filtro:### Operandos admitidos por tipo de campo-| Tipo de campo | Operandos admitidos |-| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |-| `TEXT`, `EMAILS`, `FULL_NAME`, `ADDRESS`, `LINKS`, `PHONES`, `RAW_JSON`, `FILES`, `ACTOR`, `ARRAY` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `ACTOR.source`, `ACTOR.workspaceMemberId` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `SELECT` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `MULTI_SELECT` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `RELATION` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `NUMBER` | `IS`, `IS_NOT`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `RATING` | `IS`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `CURRENCY`, `CURRENCY.amountMicros` | `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `CURRENCY.currencyCode` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `DATE`, `DATE_TIME` | `IS`, `IS_RELATIVE`, `IS_IN_PAST`, `IS_IN_FUTURE`, `IS_TODAY`, `IS_BEFORE`, `IS_AFTER`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `BOOLEAN` | `IS` |-| `UUID` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `TS_VECTOR` | `VECTOR_SEARCH` |+| Tipo de campo | Operandos admitidos |+| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ |+| `TEXT` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `EMAILS`, `FULL_NAME`, `ADDRESS`, `LINKS`, `PHONES`, `RAW_JSON`, `FILES`, `ACTOR`, `ARRAY` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `ACTOR.source`, `ACTOR.workspaceMemberId` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `SELECT` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `MULTI_SELECT` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `RELATION` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `NUMBER` | `IS`, `IS_NOT`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `RATING` | `IS`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `CURRENCY`, `CURRENCY.amountMicros` | `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `CURRENCY.currencyCode` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `DATE`, `DATE_TIME` | `IS`, `IS_RELATIVE`, `IS_IN_PAST`, `IS_IN_FUTURE`, `IS_TODAY`, `IS_BEFORE`, `IS_AFTER`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `BOOLEAN` | `IS` |+| `UUID` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `TS_VECTOR` | `VECTOR_SEARCH` |> Los tipos de campo con nombres similares pueden usar operandos completamente diferentes; `SELECT` y `MULTI_SELECT` son un caso común.@@ -109,18 +110,19 @@ Tres propiedades opcionales refinan un filtro:El campo `value` siempre es un valor serializable en JSON, pero su forma esperada depende del operando:-| Familia de operandos | Forma del valor | Ejemplo |-| ------------------------------------------------------ | ------------------------------------- | ------------------------ |-| `IS`, `IS_NOT` en `SELECT` | array de claves de opciones (cadenas) | `['ACTIVE', 'PENDING']` |-| `CONTAINS`, `DOES_NOT_CONTAIN` en `MULTI_SELECT` | array de claves de opciones (cadenas) | `['TAG_A']` |-| `IS`, `IS_NOT` en `RELATION` | array de IDs de registros (uuids) | `['c5a1...']` |-| `CONTAINS`, `DOES_NOT_CONTAIN` en campos de tipo texto | cadena | `'acme'` |-| `IS`, `IS_NOT` en `NUMBER` | cadena (el valor) | `'5'` |-| `IS` en `RATING` / `UUID` | cadena (el valor) | `'5'` |-| `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL` | cadena (el límite) | `'10'` |-| `IS`, `IS_BEFORE`, `IS_AFTER` en `DATE` / `DATE_TIME` | cadena ISO 8601 | `'2025-01-01T00:00:00Z'` |-| `IS_EMPTY`, `IS_NOT_EMPTY` | cadena vacía | `''` |-| `IS` en `BOOLEAN` | `'true'` o `'false'` | `'true'` |+| Familia de operandos | Forma del valor | Ejemplo |+| ------------------------------------------------------ | ------------------------------------------------- | ------------------------ |+| `IS`, `IS_NOT` en `SELECT` | array de claves de opciones (cadenas) | `['ACTIVE', 'PENDING']` |+| `CONTAINS`, `DOES_NOT_CONTAIN` en `MULTI_SELECT` | array de claves de opciones (cadenas) | `['TAG_A']` |+| `IS`, `IS_NOT` en `RELATION` | array de IDs de registros (uuids) | `['c5a1...']` |+| `CONTAINS`, `DOES_NOT_CONTAIN` en campos de tipo texto | cadena | `'acme'` |+| `IS`, `IS_NOT` en `TEXT` | cadena (exacta, sensible a mayúsculas/minúsculas) | `'Acme'` |+| `IS`, `IS_NOT` en `NUMBER` | cadena (el valor) | `'5'` |+| `IS` en `RATING` / `UUID` | cadena (el valor) | `'5'` |+| `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL` | cadena (el límite) | `'10'` |+| `IS`, `IS_BEFORE`, `IS_AFTER` en `DATE` / `DATE_TIME` | cadena ISO 8601 | `'2025-01-01T00:00:00Z'` |+| `IS_EMPTY`, `IS_NOT_EMPTY` | cadena vacía | `''` |+| `IS` en `BOOLEAN` | `'true'` o `'false'` | `'true'` |## Cómo aparecen las vistas en la interfaz de usuariodiff --git a/packages/twenty-docs/es/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/es/developers/extend/apps/operations/cli.mdxindex f7981556788..3661e4a8c7b 100644--- a/packages/twenty-docs/es/developers/extend/apps/operations/cli.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/operations/cli.mdx@@ -7,9 +7,9 @@ import { PageBanner } from "/snippets/page-banner.mdx"## Ejecutar la CLI-La CLI `twenty` se conecta a espacios de trabajo de Twenty desde tu terminal. Úsala para inspeccionar metadatos, leer registros, enviar solicitudes de API y crear, sincronizar y depurar aplicaciones. Necesita **Node.js 24.5+ o 26.5+**.+La CLI `twenty` se conecta a espacios de trabajo de Twenty desde tu terminal. Úsala para inspeccionar metadatos, leer registros, enviar solicitudes de API y crear, sincronizar y depurar aplicaciones. La propia CLI requiere **Node.js 24.5+**. El desarrollo de aplicaciones también necesita una versión de Node compatible con el SDK instalado; consulta [Inicio rápido](/es/developers/extend/apps/getting-started/quick-start#before-you-start).-Ejecuta cualquier comando mediante `npx`, sin instalar nada:+Ejecuta cualquier comando mediante `npx`, sin una instalación global:```bash filename="Terminal"npx twenty@latest --version@@ -22,7 +22,7 @@ npm install -g twentytwenty --version```-Los ejemplos siguientes usan `twenty`. Anteponles `npx twenty@latest` si no la instalaste globalmente. Ejecuta `twenty commands` para ver la lista completa de comandos y `twenty \<command> --help` para ver las opciones de un comando.+Los ejemplos siguientes usan `twenty`. Sustituye `twenty` por `npx twenty@latest` si no lo instalaste globalmente. Ejecuta `twenty commands` para ver la lista completa de comandos y `twenty \<command> --help` para ver las opciones de un comando.| Comando | Qué hace || --------------- | ----------------------------------------------------------------------------------------------- |@@ -65,6 +65,14 @@ printf '%s' "$TWENTY_API_KEY" | twenty auth login --with-token --url https://acmTambién puedes configurar `TWENTY_API_URL` y `TWENTY_API_KEY` para una sola ejecución sin guardar nada. Las conexiones guardadas se almacenan en `~/.twenty/config.json`.+Los comandos seleccionan un espacio de trabajo en este orden:++1. Un `--remote \<name>` explícito, que anula las variables de entorno de destino.+2. `TWENTY_REMOTE`, o el par `TWENTY_API_URL` y `TWENTY_API_KEY`. No combines estos dos métodos.+3. El remoto predeterminado guardado.++`auth login --name \<name>` guarda una conexión, pero mantiene un valor predeterminado existente. Añade `--use`, o ejecuta `twenty remote use \<name>`, para cambiar el valor predeterminado.+## Explorar tus datos```bash filename="Terminal"diff --git a/packages/twenty-docs/es/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/es/developers/extend/apps/operations/publishing.mdxindex 7d7ad35b451..eb7536557ce 100644--- a/packages/twenty-docs/es/developers/extend/apps/operations/publishing.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/operations/publishing.mdx@@ -61,11 +61,11 @@ twenty auth login --url https://your-twenty-server.com --name productionCompila y sube tu aplicación al servidor en un solo paso:```bash filename="Terminal"-twenty app publish --private-# To deploy to a specific remote:-# twenty app publish --private --remote production+twenty app publish --private --remote production```+El uso explícito de `--remote production` selecciona la conexión guardada anteriormente, aunque otro remoto sea el predeterminado. Guardar un remoto con nombre no cambia un valor predeterminado existente.+### Compartir una aplicación desplegadaLas aplicaciones en tarball no se listan en el marketplace público, por lo que otros espacios de trabajo en el mismo servidor no las descubrirán navegando. Para compartir una aplicación desplegada:@@ -83,7 +83,7 @@ Al actualizar una aplicación tarball ya desplegada, el servidor requiere que laPara publicar una actualización:1. Incrementa el campo `version` en tu `package.json` (p. ej., `1.2.3` → `1.2.4`, `1.3.0` o `2.0.0`)-2. Ejecuta `twenty app publish --private` (o `twenty app publish --private --remote production`)+2. Ejecuta `twenty app publish --private --remote production`3. Los espacios de trabajo que tienen la aplicación instalada y la actualización automática habilitada (en la pestaña General de la aplicación) se actualizan automáticamente en segundo plano; los demás verán la actualización disponible en su configuración<Note>@@ -388,19 +388,21 @@ Ve a la página **Configuración > Aplicaciones** en Twenty, donde se pueden exp{/* TODO: add screenshot of the UI when the app is registered */}-También puedes instalar aplicaciones desde la línea de comandos:+Desde el directorio de la aplicación, instala su versión publicada en el espacio de trabajo de destino:```bash filename="Terminal"-twenty app install+twenty app install --remote production```+Usa el nombre del remoto para el espacio de trabajo donde quieres instalar la aplicación. Para instalar sin un proyecto local, pasa `--universal-identifier \<id>`.+<Note>El servidor aplica el versionado semver al instalar, reflejando las reglas del despliegue:* Instalar la misma versión que ya está instalada en tu espacio de trabajo se rechaza con un error `APP_ALREADY_INSTALLED`.* Instalar una versión inferior a la que está instalada actualmente se rechaza con un error `CANNOT_DOWNGRADE_APPLICATION`.-Para instalar una versión más reciente, primero despliégala o publícala y luego vuelve a ejecutar `twenty app install`.+Para instalar una versión más reciente, primero despliégala o publícala y luego vuelve a ejecutar `twenty app install --remote production`.</Note>diff --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 6a8217e5e4f..bf40971f28a 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@@ -20,7 +20,7 @@ El desarrollo de aplicaciones locales gira en torno a la **sincronización**: la| --------------------------------------------------------- | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- || Iterar localmente con sincronización en tiempo real | `twenty app dev` | Supervisa tus archivos y sincroniza en cada cambio. || Sincronizar una vez y salir (CI, scripts, hooks) | `twenty app apply` | Una compilación + sincronización, luego sale. Añade `--yes` para omitir la confirmación de cambio destructivo. |-| Previsualizar cambios **sin aplicarlos** | `twenty app plan` | Calcula e imprime el diff; no escribe nada. |+| Previsualizar cambios **sin aplicarlos** | `twenty app plan` | Compila localmente e imprime las diferencias; no cambia el espacio de trabajo. || 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.** Restaura los archivos de definición, las traducciones y las dependencias almacenadas. Consulta más abajo. |@@ -87,7 +87,7 @@ Plan: 1 to add, 1 to change, 0 to destroy.Un plan:-* **No escribe nada**: sin migración de metadatos, sin actualización del registro de la aplicación, sin cambios de roles/pestañas predeterminados y sin generación del cliente de la API.+* **No cambia el espacio de trabajo**, no realiza migraciones de metadatos, actualizaciones de registros de aplicaciones ni cambios en roles o pestañas predeterminados. Crea una instantánea local, pero no vuelve a generar el cliente de API.* Devuelve el **mismo diff** que aplicaría una sincronización real, para que puedas revisar por adelantado las entidades creadas/actualizadas/eliminadas.* Es útil antes de un cambio arriesgado, al revisar un cambio generado por IA o en un script que deba fallar si está a punto de producirse un cambio inesperado.@@ -139,13 +139,14 @@ Si falla la instalación de dependencias para un proyecto nuevo, se conserva la* flujos de trabajo, como archivos `defineWorkflow()`, cuando su versión almacenada es la que escribió la última sincronización. Para la aplicación personalizada del espacio de trabajo, es la versión activa, independientemente de si la publicó una sincronización o el generador de flujos de trabajo, y la aplicación publica una definición modificada como una nueva versión, tal como se describe en [Flujos de trabajo](/es/developers/extend/apps/logic/workflows#workflows-of-the-workspace-custom-application);* habilidades, como archivos `defineSkill()`;* agentes, como archivos `defineAgent()`, con sus desencadenadores y el rol al que los vincula tu aplicación;+* validation rules, as `defineValidationRule()` files with their expression as a string;* traducciones publicadas, como `locales/\<locale>.json` para que la extracción de cadenas pueda leerlas de nuevo a partir de los metadatos y el origen extraídos, y `locales/compiled/\<locale>.json` para el resto.Cada 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.+Ejecuta `yarn install` después de obtener los cambios de dependencias. Pull instala dependencias solo al crear un proyecto nuevo, antes de restaurar los archivos remotos; no las reinstala después de reemplazar `package.json` o `yarn.lock`. Pull no vuelve a generar el cliente tipado. Ejecuta `twenty app generate-client` cuando necesites tipos actualizados del espacio de trabajo.**Qué no escribe:**@@ -156,6 +157,7 @@ Ejecuta `yarn install` después de obtener los cambios de dependencias. Pull no* **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 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.+* **Validation rules the export cannot carry yet** — a rule with no expression or message, such as an unfinished draft from Settings, or one that reads a field deleted from the workspace, is reported and left in place.* **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.@@ -173,11 +175,12 @@ Cuando los metadatos locales parezcan incorrectos, ve escalando en este orden y2. **Previsualizar el plan.** Ejecuta `twenty app plan` para ver exactamente qué pretende cambiar la siguiente sincronización, sin aplicarlo.3. Lee el error identificado. Un conflicto suele señalar un identificador duplicado o reutilizado.4. **Desinstalar y volver a instalar.** `twenty app uninstall`, luego vuelve a sincronizar (`twenty app dev`). Esto reconstruye los metadatos de la aplicación desde cero manteniendo intacto el resto de tu espacio de trabajo.-5. **Restablecimiento completo (último recurso).** Restablece tu base de datos de desarrollo de Docker o del repositorio y, después, vuelve a sembrar los datos y a sincronizar.+5. **Restablecimiento completo (último recurso).** Para un entorno local administrado por la CLI, ejecuta `twenty local reset`, después `twenty local start` y vuelve a conectarte antes de sincronizar de nuevo. Para una copia del código fuente, restablece y vuelve a inicializar su base de datos de desarrollo en su lugar.<Warning>- restablecer tu base de datos de desarrollo de Docker o del repositorio elimina **todos** los datos- de tu instancia local — todos los espacios de trabajo, registros y aplicaciones. Úsalo solo cuando los pasos anteriores hayan fallado.+ Restablecer tu entorno local o la base de datos de desarrollo del repositorio elimina+ **todos** los datos de tu instancia local, cada espacio de trabajo, registro y aplicación. Úsalo solo+ cuando los pasos anteriores hayan fallado.</Warning><Note>diff --git a/packages/twenty-docs/es/developers/extend/apps/operations/testing.mdx b/packages/twenty-docs/es/developers/extend/apps/operations/testing.mdxindex c489b39b851..fbd33004e69 100644--- a/packages/twenty-docs/es/developers/extend/apps/operations/testing.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/operations/testing.mdx@@ -176,7 +176,7 @@ También puedes ejecutar la comprobación de tipos en tu aplicación sin ejecutatwenty app typecheck```-Esto ejecuta `tsc --noEmit` contra el `tsconfig.json` de tu aplicación e informa cualquier error de tipo. Las aplicaciones generadas también incluyen un script `yarn typecheck` que cubre los archivos de prueba (`tsconfig.spec.json`).+Esto comprueba el `tsconfig.json` de tu aplicación con el compilador de TypeScript instalado, sin generar archivos, e informa de cualquier error de tipo. Las aplicaciones generadas también incluyen un script `yarn typecheck` que cubre los archivos de prueba (`tsconfig.spec.json`).## CI con GitHub Actionsdiff --git a/packages/twenty-docs/es/user-guide/calendar-emails/capabilities/calendar.mdx b/packages/twenty-docs/es/user-guide/calendar-emails/capabilities/calendar.mdxindex 4599271283a..7025cdd4fc2 100644--- a/packages/twenty-docs/es/user-guide/calendar-emails/capabilities/calendar.mdx+++ b/packages/twenty-docs/es/user-guide/calendar-emails/capabilities/calendar.mdx@@ -15,7 +15,7 @@ Twenty sincroniza automáticamente los eventos de su calendario y los vincula a## Pestaña de Calendario-Junto a la pestaña de Correos Electrónicos en los registros, encontrará una pestaña `Calendario` que contiene el historial de reuniones programadas con el registro.+Junto a la pestaña de Mensajes, encontrará una pestaña `Calendar` que contiene el historial de reuniones programadas con el registro.### Disponible para@@ -26,7 +26,7 @@ Junto a la pestaña de Correos Electrónicos en los registros, encontrará una p### Visualización del Historial de Reuniones1. **Navegue hacia un Registro**: Vaya a cualquier registro de Persona, Empresa u Oportunidad-2. **Seleccione la Pestaña de Calendario**: Haga clic en la pestaña `Calendario` junto a la pestaña de Correos Electrónicos+2. **Seleccione la pestaña Calendar**: Haga clic en la pestaña `Calendar` junto a la pestaña de Mensajes3. **Explore el Historial de Reuniones**: Vea todas las reuniones programadas y sus detalles4. **Acceda al Contexto de la Reunión**: Vea los participantes, horarios e información relacionadadiff --git a/packages/twenty-docs/es/user-guide/calendar-emails/capabilities/mailbox.mdx b/packages/twenty-docs/es/user-guide/calendar-emails/capabilities/mailbox.mdxindex ba4fb4bbe95..18894dd48fd 100644--- a/packages/twenty-docs/es/user-guide/calendar-emails/capabilities/mailbox.mdx+++ b/packages/twenty-docs/es/user-guide/calendar-emails/capabilities/mailbox.mdx@@ -24,7 +24,7 @@ Las conversaciones de correo electrónico aparecen en tres objetos principales:### Visualización de Conversaciones de Correo Electrónico1. **Navegue hacia un Registro**: Vaya a cualquier registro de Persona, Empresa u Oportunidad-2. **Seleccione la Pestaña de Correos Electrónicos**: Haga clic en la pestaña `Correos Electrónicos` para ver los correos sincronizados+2. **Seleccione la Pestaña de Mensajes**: Haga clic en la pestaña `Messages` para ver los correos sincronizados3. **Abra un Hilo de Correo Electrónico**: Haga clic en cualquier correo electrónico para abrir y leer la conversación completa4. **Explorar el Historial**: Desplácese por el historial completo de correos electrónicos con ese contactodiff --git a/packages/twenty-docs/es/user-guide/dashboards/capabilities/widgets.mdx b/packages/twenty-docs/es/user-guide/dashboards/capabilities/widgets.mdxindex 57c842b29a0..668c461df03 100644--- a/packages/twenty-docs/es/user-guide/dashboards/capabilities/widgets.mdx+++ b/packages/twenty-docs/es/user-guide/dashboards/capabilities/widgets.mdx@@ -104,11 +104,13 @@ Muestra valores clave individuales de forma destacada.Incorpora herramientas y contenido externos directamente en tu panel.-Para teléfonos integrados o herramientas de vídeo, un miembro con permiso para gestionar la seguridad puede configurar **Configuración → General → Seguridad → Acceso a medios de sitios web integrados**. Añade el origen HTTPS exacto del sitio web, como `https://workspace.aircall.io`, y habilita el **Micrófono**, la **Cámara** o ambos. No se aceptan rutas ni comodines. Aprueba únicamente sitios web de confianza.+Para los widgets iframe añadidos en el espacio de trabajo, un miembro con permiso para administrar la seguridad puede configurar **Configuración → General → Seguridad → Acceso a medios de sitios web incrustados**. Añade el origen HTTPS exacto del sitio web, como `https://workspace.aircall.io`, y habilita el **Micrófono**, la **Cámara** o ambos. No se aceptan rutas ni comodines. Aprueba únicamente sitios web de confianza.-Vuelve a cargar las pestañas abiertas de Twenty después de cambiar estos permisos. La recarga finaliza las llamadas y grabaciones activas. Cada miembro selecciona **Habilitar micrófono**, **Habilitar cámara** o **Habilitar micrófono y cámara** en la incrustación y aprueba el permiso del navegador cuando se le solicite.+Las incrustaciones de medios proporcionadas por una aplicación instalada utilizan una aprobación independiente: la aplicación declara el sitio web en [`requestedIframeMediaPermissions`](/es/developers/extend/apps/config/application#embedded-website-media-access), y un miembro que puede administrar aplicaciones lo aprueba durante la instalación. Estas concesiones se aplican a los propios componentes front-end y widgets iframe de la aplicación. Las aprobaciones de seguridad del espacio de trabajo y las concesiones de otras aplicaciones no se aplican a los widgets definidos por la aplicación.-El indicador del encabezado muestra **Acceso a medios habilitado** mientras una incrustación tiene acceso, incluso cuando está oculta. Esto no significa que el sitio web esté grabando actualmente: Twenty no puede inspeccionar la actividad del micrófono o la cámara dentro de otro sitio web. Selecciona el indicador y elige **Deshabilitar** para descargar la incrustación y volver a cargarla con el acceso a medios bloqueado. Habilitar el acceso de nuevo requiere otro clic.+Vuelve a cargar las pestañas abiertas de Twenty después de cambiar estos permisos. La recarga finaliza las llamadas y grabaciones activas. Cada vez que un miembro selecciona **Activar micrófono**, **Activar cámara** o **Activar micrófono y cámara** en una incrustación, aparece una confirmación nativa del navegador que muestra el widget o la aplicación propietaria, el origen del sitio web y el acceso solicitado al micrófono o la cámara. Después de confirmar, aprueba el permiso de medios del navegador cuando se te solicite. Esta confirmación se aplica tanto a los widgets del espacio de trabajo como a las incrustaciones proporcionadas por la aplicación.++El indicador del encabezado muestra **Acceso a medios habilitado** mientras una incrustación tiene acceso, incluso cuando está oculta. Esto no significa que el sitio web esté grabando actualmente: Twenty no puede inspeccionar la actividad del micrófono o la cámara dentro de otro sitio web. Selecciona el indicador y elige **Deshabilitar** para descargar la incrustación y volver a cargarla con el acceso a medios bloqueado. Selecciona **Activar** de nuevo para restaurar el acceso.<Frame><img src="/images/user-guide/dashboard/dashboard-widget-table.png" alt="Tabla" />diff --git a/packages/twenty-docs/it/developers/extend/apps/config/application.mdx b/packages/twenty-docs/it/developers/extend/apps/config/application.mdxindex 7a4624a0425..2ecee008468 100644--- a/packages/twenty-docs/it/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/config/application.mdx@@ -79,6 +79,29 @@ Un'app installata senza l'autorizzazione richiesta mette in pausa l'acquisizioneConsulta [Acquisizione multimediale](/it/developers/extend/apps/layout/front-components#media-capture) per il comportamento dell'acquisizione e gli indicatori di registrazione.+## Accesso ai contenuti multimediali di siti web incorporati++Imposta `requestedIframeMediaPermissions` quando un componente front o un widget di layout della pagina `IFRAME` incorpora un sito web che necessita del microfono o della fotocamera, ad esempio uno strumento telefonico o video. Elenca fino a 20 siti web, ciascuno come origine HTTPS esatta, con l'accesso al microfono e alla fotocamera impostato separatamente. Le origini devono essere univoche, non contenere percorsi o caratteri jolly e richiedere l'accesso ad almeno uno tra microfono e fotocamera.++```ts+import { defineApplication } from 'twenty-sdk/define';++export default defineApplication({+ universalIdentifier: '39783023-bcac-41e3-b0d2-ff1944d8465d',+ displayName: 'Phone',+ description: 'Call your contacts from Twenty',+ requestedIframeMediaPermissions: [+ { origin: 'https://workspace.aircall.io', microphone: true, camera: false },+ ],+});+```++I siti web dichiarati vengono visualizzati durante l'installazione. L'approvazione richiede un membro dello spazio di lavoro in grado di gestire le app e si applica all'intero spazio di lavoro, per i componenti front e i widget iframe dell'app stessa. Le approvazioni di sicurezza dello spazio di lavoro si applicano solo ai widget creati nello spazio di lavoro. Le app di sviluppo sincronizzate localmente ricevono i siti web dichiarati nel relativo manifest. Queste autorizzazioni non sostituiscono le autorizzazioni del browser o del sistema operativo. Le intestazioni del browser hanno un limite di dimensione, quindi se i siti web di uno spazio di lavoro lo superano, i siti web approvati dallo spazio di lavoro hanno la precedenza e i siti web rimanenti non ricevono l'accesso ai contenuti multimediali.++Gli aggiornamenti alle app pubblicate mantengono le autorizzazioni esistenti e non concedono automaticamente ulteriore accesso ai contenuti multimediali. Per approvare nuove richieste, un membro in grado di gestire le app apre la scheda **Generali** dell'app installata e seleziona **Esamina l'accesso ai contenuti multimediali** in **Accesso ai contenuti multimediali di siti web incorporati**. Questa approvazione utilizza una conferma nativa del browser che mostra l'app, le origini dei siti web e l'accesso richiesto al microfono o alla fotocamera. Dopo l'approvazione, ricarica le schede Twenty aperte per applicare le autorizzazioni aggiornate.++Consulta [Siti web incorporati con accesso ai contenuti multimediali](/it/developers/extend/apps/layout/front-components#embedded-websites-with-media-access) per i requisiti dell'iframe.+## Tipi di variabiliSia `applicationVariables` che `serverVariables` accettano un `type` opzionale (e, per `SELECT` / `MULTI_SELECT`, un elenco di `options`). Tipi supportati: `TEXT` (predefinito), `BOOLEAN`, `NUMBER`, `NUMERIC`, `DATE`, `DATE_TIME`, `SELECT`, `MULTI_SELECT`, `ARRAY`, `RAW_JSON`, `RICH_TEXT`.diff --git a/packages/twenty-docs/it/developers/extend/apps/data/overview.mdx b/packages/twenty-docs/it/developers/extend/apps/data/overview.mdxindex 77e8cfa2e74..be1743f3ef5 100644--- a/packages/twenty-docs/it/developers/extend/apps/data/overview.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/data/overview.mdx@@ -46,6 +46,10 @@ Il **data layer** di un'app Twenty è l'insieme dei dati che la tua app *aggiung<CardTitle>Tipi di attività Timeline</CardTitle>Definire gli eventi di audit automatico e gli eventi espliciti delle app per registrare le cronologie.</Card>+ <Card href="/it/developers/extend/apps/data/objects" img="/images/user-guide/halftone/card-page-objects.svg">+ <CardTitle>Regole di convalida</CardTitle>+ `defineValidationRule` — dichiara le condizioni che un record deve soddisfare prima di poter essere salvato.+ </Card></CardGroup>## Entità in sintesi@@ -58,8 +62,9 @@ Il **data layer** di un'app Twenty è l'insieme dei dati che la tua app *aggiung| **Indice** | Un indice di database per velocizzare una query ricorrente su uno dei tuoi oggetti | `defineIndex()` || **Tipo di attività della timeline** | Un evento di audit automatico o un evento di dominio esplicito visualizzato nelle timeline dei record | `defineTimelineActivityType()` || **Percorso del record correlato** | Una catena di un massimo di tre relazioni attraverso la quale l'accesso a un record si estende ai record correlati | `defineRelatedRecordPath()` |+| **Regola di convalida** | Una condizione che un record deve soddisfare prima di poter essere salvato | `defineValidationRule()` |-La CLI rileva questi elementi tramite analisi AST in fase di build, quindi l'organizzazione dei file dipende da te — la convenzione è `src/objects/`, `src/fields/`, `src/indexes/`, `src/timeline-activity-types/` e `src/related-record-paths/`. Gli UUID `universalIdentifier` stabili collegano tutto tra le varie distribuzioni.+La CLI rileva questi elementi tramite analisi AST in fase di build, quindi l'organizzazione dei file spetta a te — la convenzione è `src/objects/`, `src/validation-rules/`, `src/fields/`, `src/indexes/`, `src/timeline-activity-types/` e `src/related-record-paths/`. Gli UUID `universalIdentifier` stabili collegano tutto tra le varie distribuzioni.## Indici (facoltativi)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 7cf0e1a2287..b8134456d01 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@@ -18,6 +18,7 @@ your-app/│ ├── roles/ ← defineRole│ ├── objects/ ← defineObject│ ├── fields/ ← defineField+│ ├── validation-rules/ ← defineValidationRule│ ├── logic-functions/ ← defineLogicFunction│ ├── front-components/ ← defineFrontComponent│ ├── skills/ ← defineSkill@@ -46,6 +47,7 @@ your-app/| **Oggetto** | Tipi di record personalizzati con campi | [Oggetti](/it/developers/extend/apps/data/objects) || **Campo** | Aggiungi campi agli oggetti di altre app | [Estensione degli oggetti](/it/developers/extend/apps/data/extending-objects) || **Relazione** | Collegamenti bidirezionali tra oggetti | [Relazioni](/it/developers/extend/apps/data/relations) |+| **Regola di convalida** | Condizioni che un record deve soddisfare prima di poter essere salvato | [Regole di convalida](/it/developers/extend/apps/data/validation-rules) || **Funzione logica** | TypeScript lato server con trigger | [Funzioni logiche](/it/developers/extend/apps/logic/logic-functions) || **Abilità** | Istruzioni riutilizzabili per agenti IA | [Abilità e agenti](/it/developers/extend/apps/logic/skills-and-agents) || **Agente** | Assistenti IA con prompt personalizzati | [Abilità e agenti](/it/developers/extend/apps/logic/skills-and-agents) |@@ -86,7 +88,7 @@ your-app/└─────────────────────────────────────────────────────────┘```-* **`venti app dev`** — guarda i tuoi file sorgente e le modifiche live syncs in un server Twenty collegato. Il client API tipizzato viene rigenerato automaticamente quando lo schema cambia.+* **`venti app dev`** — guarda i tuoi file sorgente e le modifiche live syncs in un server Twenty collegato. Dopo una sincronizzazione riuscita, rigenera il client API tipizzato quando lo schema o il pacchetto del generatore installato sono cambiati, oppure quando i file del client generati sono mancanti o modificati. Per aggiornare i tipi dopo aver modificato l'area di lavoro nell'interfaccia utente, esegui `twenty app generate-client`.* **`venti app build`** — compila TypeScript, raggruppa funzioni logiche e componenti frontali con esbuild, e produce un manifesto.* **Hook di pre/post-installazione e disinstallazione** — funzioni opzionali che vengono eseguite durante l’installazione o subito prima della rimozione. Vedi [Hook di installazione](/it/developers/extend/apps/config/install-hooks) per i dettagli.diff --git a/packages/twenty-docs/it/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/it/developers/extend/apps/getting-started/local-server.mdxindex 68c44ebba67..a32bcbbc6fd 100644--- a/packages/twenty-docs/it/developers/extend/apps/getting-started/local-server.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/getting-started/local-server.mdx@@ -93,7 +93,7 @@ Per un checkout del codice sorgente di Twenty, funziona anche l'ambiente di svil```bashbash packages/twenty-utils/setup-dev-env.shyarn start-twenty auth login --url http://localhost:3000 --name local+twenty auth login --url http://localhost:3000 --name local --use```Usa l'URL e la porta effettivi del tuo server. Per gli spazi di lavoro con sottodomini, usa il@@ -102,8 +102,9 @@ nome host dello spazio di lavoro. Per la distribuzione in produzione, segui la## Dipendenze del progetto-Installa `twenty-sdk` e `twenty-client-sdk` come dipendenze del progetto. Installa globalmente la-CLI `twenty`, quindi esegui `twenty app typecheck`, `twenty app build` e-`twenty app apply` dalla directory dell'app.+`twenty app init` dichiara `twenty-sdk`, `twenty-client-sdk` e `twenty-ui` in+`devDependencies`, ma non li installa. Con la CLI `twenty` installata+globalmente, esegui `yarn install` dalla directory dell'app generata prima di eseguire+`twenty app typecheck`, `twenty app build` o `twenty app apply`.<PageBanner illustration="dev-self-host" />diff --git a/packages/twenty-docs/it/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/it/developers/extend/apps/getting-started/project-structure.mdxindex 165025dab5d..e5b8d99a1ae 100644--- a/packages/twenty-docs/it/developers/extend/apps/getting-started/project-structure.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/getting-started/project-structure.mdx@@ -12,6 +12,7 @@ Una nuova app generata da `twenty app init` si presenta così:```text filename="my-twenty-app/"my-twenty-app/package.json+ yarn.lock # Created by app init; used by yarn installsrc/application-config.ts # Required — your app's entry pointdefault-role.ts # Permissions for logic functions@@ -28,6 +29,7 @@ my-twenty-app/__tests__/application-config.test.ts # Unit testglobal-setup.ts # Integration test setup (sync + uninstall)+ run-twenty.ts # CLI subprocess helper for testsschema.integration-test.ts # Integration test against a live server.github/workflows/ci.yml # Lint, typecheck, unit + integration tests@@ -65,20 +67,9 @@ my-twenty-app/## Dipendenze-I pacchetti SDK e UI di Twenty devono trovarsi in `devDependencies`:+`twenty app init` inserisce `twenty-sdk`, `twenty-client-sdk` e `twenty-ui` in `devDependencies`, bloccati alla versione dell'SDK selezionata da quella versione della CLI. Mantieni le versioni generate per una nuova app e mantieni tutti e tre i pacchetti sincronizzati durante l'aggiornamento. La CLI può ricevere versioni patch in modo indipendente, quindi la sua versione non deve necessariamente corrispondere a quella di questi pacchetti.-```json filename="package.json"-{- "dependencies": {},- "devDependencies": {- "twenty-client-sdk": "2.40.0",- "twenty-sdk": "2.40.0",- "twenty-ui": "2.40.0"- }-}-```--`twenty app init` vincola `twenty-sdk`, `twenty-client-sdk` e `twenty-ui` alla propria versione. Mantieni tutti e tre sincronizzati durante l'aggiornamento.+Il valore `engines.twenty` generato imposta la versione minima del server alla versione major e minor di quell'SDK. I flussi di lavoro GitHub Actions generati bloccano separatamente la CLI.* **`twenty-sdk`** fornisce definizioni delle app, helper di runtime e integrazione del renderer. Usa il pacchetto **`twenty`** installato separatamente per i comandi CLI e gli strumenti di build/scaffolding.* **`twenty-client-sdk`** *viene* importato dal codice della tua app (`CoreApiClient`, `MetadataApiClient`, `RestApiClient`), ma Twenty lo fornisce a runtime: le funzioni di logica lo ricevono da un layer SDK generato e i componenti di front-end lo risolvono da moduli forniti dal server. La copia installata viene utilizzata solo per il type checking e per la build al momento del deploy, quindi non è mai necessario includerla nel bundle distribuito.diff --git a/packages/twenty-docs/it/developers/extend/apps/getting-started/quick-start.mdx b/packages/twenty-docs/it/developers/extend/apps/getting-started/quick-start.mdxindex 90c397380c7..c98837433d2 100644--- a/packages/twenty-docs/it/developers/extend/apps/getting-started/quick-start.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/getting-started/quick-start.mdx@@ -8,7 +8,7 @@ import { CardTitle } from "/snippets/card-title.mdx"## Prima di iniziare-Usa Node.js 24.5+ o 26.5+ e Yarn 4 (tramite Corepack: `corepack enable`; su Node 26, installalo prima con `npm install -g corepack`). Installa il CLI a livello globale; la tua app mantiene le proprie dipendenze SDK.+Usa Node.js 24 (24.5+) o 26 (26.5.1+) e Yarn 4 (tramite Corepack: `corepack enable`; su Node 26, installalo prima con `npm install -g corepack`). Installa il CLI a livello globale; la tua app mantiene le proprie dipendenze SDK.<Note>La compilazione delle app Twenty è supportata ufficialmente solo sui sistemi Unix (macOS e Linux). Su Windows, lavora all'interno di WSL 2.@@ -30,9 +30,12 @@ yarn installUtilizza uno spazio di lavoro esistente oppure avvia un [server locale](/it/developers/extend/apps/getting-started/local-server), quindi accedi:```bash-twenty auth login --url https://your-workspace.twenty.com --name dev+twenty auth login --url https://your-workspace.twenty.com --name dev --use+twenty auth status --remote dev```+`--name dev` salva la connessione come `dev`; `--use` la imposta come predefinita per i comandi seguenti. Per selezionarla esplicitamente, aggiungi `--remote dev`. Le variabili d'ambiente possono sovrascrivere l'impostazione predefinita; consulta la [selezione dell'area di lavoro](/it/developers/extend/apps/operations/cli#connecting-to-a-workspace).+## Sincronizza le modifichePer la prima sincronizzazione, consenti esplicitamente la registrazione e l'installazione:diff --git a/packages/twenty-docs/it/developers/extend/apps/getting-started/scaffolding.mdx b/packages/twenty-docs/it/developers/extend/apps/getting-started/scaffolding.mdxindex a24dc64e945..55b1ff2e485 100644--- a/packages/twenty-docs/it/developers/extend/apps/getting-started/scaffolding.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/getting-started/scaffolding.mdx@@ -7,12 +7,13 @@ import { PageBanner } from "/snippets/page-banner.mdx"## Panoramica-Usa la CLI autonoma per generare un oggetto, un campo, una funzione logica o un componente front-end:+Utilizza la CLI standalone per generare un oggetto, un campo, una regola di convalida, una funzione logica o un componente front-end:```bashtwenty app addtwenty app add object --name invoice --name-plural invoices --no-inputtwenty app add field --name amount --type NUMBER --object <object-uuid> --no-input+twenty app add validation-rule --name invoice-has-amount --object <object-uuid> --no-inputtwenty app add logic-function --name send-invoice --no-inputtwenty app add front-component --name invoice-panel --no-input```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 16455e6a4bc..ae3b8703fa2 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@@ -1205,10 +1205,31 @@ Un punto arancione nell'intestazione dello spazio di lavoro indica un'acquisizio`getUserMedia()` e `MediaRecorder` vengono eseguiti tramite polyfill sandbox, pertanto il codice di registrazione standard e `MediaRecorder.isTypeSupported()` funzionano senza modifiche dopo l'approvazione. Gli oggetti di vincolo dettagliati sono accettati ma non inoltrati. L'host acquisisce usando le impostazioni predefinite per i tipi richiesti. Applicazioni diverse possono acquisire contemporaneamente e l'arresto di un'app influisce solo sulle proprie sessioni. Ogni componente front supporta un'acquisizione in sospeso o attiva alla volta. Archivia un `Blob` registrato con la funzione host `uploadFile`.+### Siti web incorporati con accesso ai media++Per incorporare uno strumento telefonico o video, dichiara la relativa origine HTTPS in [`requestedIframeMediaPermissions`](/it/developers/extend/apps/config/application#embedded-website-media-access) della tua applicazione, con l'accesso al microfono e alla fotocamera impostati separatamente. L'installazione dell'app concede questi siti web allo spazio di lavoro. Gli aggiornamenti alle app pubblicate mantengono le autorizzazioni esistenti e non concedono automaticamente ulteriore accesso ai media. Le app di sviluppo sincronizzate localmente ricevono automaticamente i siti web dichiarati nel relativo manifest. Un membro che può gestire le app può approvare nuove richieste dalla scheda **Generale** dell'app installata, in **Accesso ai media dei siti web incorporati** > **Esamina l'accesso ai media**. Questa approvazione utilizza una conferma nativa del browser che mostra l'app, le origini dei siti web e l'accesso richiesto al microfono o alla fotocamera. Twenty legge i siti web autorizzati al caricamento di una scheda, quindi ricarica le schede Twenty aperte dopo l'installazione o l'approvazione.++Richiedi le funzionalità corrispondenti nell'iframe:++```tsx+<iframe+ title="Aircall phone"+ src="https://workspace.aircall.io?integration=generic"+ allow="microphone"+ width={376}+ height={666}+/>+```++Per il video, utilizza `allow="microphone; camera"` e dichiara entrambe per l'origine. Twenty delega solo i media concessi alla tua app per quell'origine. I membri devono selezionare il controllo **Abilita** dell'elemento incorporato e approvare una conferma nativa del browser che mostra l'app, l'origine del sito web e l'accesso richiesto al microfono o alla fotocamera prima che riceva l'accesso ai media. Le autorizzazioni del browser e del sistema operativo sono ancora applicabili. `srcDoc` e gli elementi incorporati all'origine di Twenty non possono ricevere questa delega. I widget di layout di pagina `IFRAME` definiti dall'app utilizzano le origini concesse all'app proprietaria e lo stesso flusso di conferma.++Gli elementi incorporati abilitati appaiono nello stesso indicatore nell'intestazione dell'acquisizione nativa, con **Accesso al microfono abilitato** o **Accesso alla fotocamera abilitato** anziché indicare che la registrazione è attiva. L'indicatore rimane visibile finché l'accesso è abilitato, anche se l'elemento incorporato è nascosto. **Disabilita** scarica l'iframe e lo ricarica con i media bloccati. L'acquisizione dell'app tramite `getUserMedia()` continua a segnalare l'acquisizione effettiva e mantiene il proprio controllo **Arresta**.++Il contenuto dell'iframe rimane in sandbox. Gli elementi incorporati di media esterni approvati mantengono la propria origine dopo che il membro abilita l'accesso, consentendo al sito web di utilizzare la propria sessione e richiedere le autorizzazioni del browser per i media. Gli altri iframe dei componenti front-end mantengono un'origine sandbox opaca.+### Altre lacune* **Payload di drag-and-drop.** Gli eventi di drag vengono attivati, ma `event.dataTransfer` è `undefined`.* **Built-in di Node.** `fs`, `path` e `node:crypto` fanno fallire la build, quindi sposta quel lavoro in una [logic function](/it/developers/extend/apps/logic/logic-functions). Web Crypto sostituisce `node:crypto` e sono disponibili anche `fetch`, `TextEncoder` e `URL`; consulta l'[ambito globale](#global-scope) — ma nulla sostituisce `fs`: il sandbox non dispone di un filesystem.-* **`iframe`** viene sempre nuovamente messo in sandbox senza `allow-same-origin`, quindi un embed che dipende dalla propria sessione viene renderizzato come disconnesso. Non ha nemmeno `onLoad`.<PageBanner illustration="card-page-front-components" />diff --git a/packages/twenty-docs/it/developers/extend/apps/layout/page-layouts.mdx b/packages/twenty-docs/it/developers/extend/apps/layout/page-layouts.mdxindex 372e75c73db..21056223259 100644--- a/packages/twenty-docs/it/developers/extend/apps/layout/page-layouts.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/layout/page-layouts.mdx@@ -65,6 +65,7 @@ export default definePageLayout({* Imposta esplicitamente `layoutMode`. Ometterlo imposta `VERTICAL_LIST` su una `STANDALONE_PAGE` e `GRID` altrove, il che raramente è ciò che vuoi per la pagina di un record.* Ogni `widget` all'interno di una scheda può renderizzare un [front component](/it/developers/extend/apps/layout/front-components), un elenco di relazioni o altri tipi di widget integrati.* Un widget `FRONT_COMPONENT` può impostare `headerCommandMenuItemUniversalIdentifiers` su un array ordinato di identificatori universali degli elementi del menu di comando della stessa app. Queste azioni vengono visualizzate come pulsanti con icona nell'intestazione della scheda del widget e mantengono la relativa disponibilità a livello di comando e i controlli delle autorizzazioni. Gli identificatori devono essere univoci e devono essere risolti quando l'app è installata.+* Un widget `IFRAME` può utilizzare il microfono o la videocamera per i siti web approvati tramite [`requestedIframeMediaPermissions`](/it/developers/extend/apps/config/application#embedded-website-media-access) dell'app proprietaria. I membri selezionano **Abilita** e approvano una conferma nativa del browser che mostra l'app, l'origine del sito web e l'accesso richiesto al microfono o alla videocamera prima che inizi l'accesso. Le approvazioni di sicurezza dell'area di lavoro e le autorizzazioni di altre app non si applicano ai widget definiti dall'app.* `position` sulle schede controlla il loro ordine. Usa valori più alti (ad es., 50) per posizionare le schede personalizzate dopo quelle integrate.* `twenty app pull` riscrive i layout di pagina con le relative schede e widget inclusi inline. Un widget che l'esportazione non può ancora includere, ad esempio uno che mostra il componente front della tua app o uno del tipo `VIEW` deprecato, viene segnalato da pull anziché scritto; consulta [ciò che pull non scrive](/it/developers/extend/apps/operations/sync-and-recovery#pulling-an-installed-app-back-to-source).diff --git a/packages/twenty-docs/it/developers/extend/apps/layout/views.mdx b/packages/twenty-docs/it/developers/extend/apps/layout/views.mdxindex a8f57a26bd9..7915ed44816 100644--- a/packages/twenty-docs/it/developers/extend/apps/layout/views.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/layout/views.mdx@@ -87,21 +87,22 @@ Tre proprietà facoltative perfezionano un filtro:### Operatori supportati per tipo di campo-| Tipo di campo | Operandi supportati |-| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |-| `TEXT`, `EMAILS`, `FULL_NAME`, `ADDRESS`, `LINKS`, `PHONES`, `RAW_JSON`, `FILES`, `ACTOR`, `ARRAY` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `ACTOR.source`, `ACTOR.workspaceMemberId` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `SELECT` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `MULTI_SELECT` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `RELATION` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `NUMBER` | `IS`, `IS_NOT`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `RATING` | `IS`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `CURRENCY`, `CURRENCY.amountMicros` | `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `CURRENCY.currencyCode` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `DATE`, `DATE_TIME` | `IS`, `IS_RELATIVE`, `IS_IN_PAST`, `IS_IN_FUTURE`, `IS_TODAY`, `IS_BEFORE`, `IS_AFTER`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `BOOLEAN` | `IS` |-| `UUID` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `TS_VECTOR` | `VECTOR_SEARCH` |+| Tipo di campo | Operandi supportati |+| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ |+| `TEXT` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `EMAILS`, `FULL_NAME`, `ADDRESS`, `LINKS`, `PHONES`, `RAW_JSON`, `FILES`, `ACTOR`, `ARRAY` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `ACTOR.source`, `ACTOR.workspaceMemberId` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `SELECT` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `MULTI_SELECT` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `RELATION` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `NUMBER` | `IS`, `IS_NOT`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `RATING` | `IS`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `CURRENCY`, `CURRENCY.amountMicros` | `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `CURRENCY.currencyCode` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `DATE`, `DATE_TIME` | `IS`, `IS_RELATIVE`, `IS_IN_PAST`, `IS_IN_FUTURE`, `IS_TODAY`, `IS_BEFORE`, `IS_AFTER`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `BOOLEAN` | `IS` |+| `UUID` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `TS_VECTOR` | `VECTOR_SEARCH` |> I tipi di campo con nomi simili possono usare operandi completamente diversi — `SELECT` e `MULTI_SELECT` sono un caso comune.@@ -109,18 +110,19 @@ Tre proprietà facoltative perfezionano un filtro:Il campo `value` è sempre un valore serializzabile in JSON, ma la forma prevista dipende dall'operando:-| Famiglia di operandi | Forma del valore | Esempio |-| ----------------------------------------------------- | ------------------------------------- | ------------------------ |-| `IS`, `IS_NOT` su `SELECT` | array di chiavi di opzione (stringhe) | `['ACTIVE', 'PENDING']` |-| `CONTAINS`, `DOES_NOT_CONTAIN` su `MULTI_SELECT` | array di chiavi di opzione (stringhe) | `['TAG_A']` |-| `IS`, `IS_NOT` su `RELATION` | array di ID di record (uuid) | `['c5a1...']` |-| `CONTAINS`, `DOES_NOT_CONTAIN` su campi testuali | stringa | `'acme'` |-| `IS`, `IS_NOT` su `NUMBER` | stringa (il valore) | `'5'` |-| `IS` su `RATING` / `UUID` | stringa (il valore) | `'5'` |-| `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL` | stringa (il limite) | `'10'` |-| `IS`, `IS_BEFORE`, `IS_AFTER` su `DATE` / `DATE_TIME` | stringa ISO 8601 | `'2025-01-01T00:00:00Z'` |-| `IS_EMPTY`, `IS_NOT_EMPTY` | stringa vuota | `''` |-| `IS` su `BOOLEAN` | `'true'` o `'false'` | `'true'` |+| Famiglia di operandi | Forma del valore | Esempio |+| ----------------------------------------------------- | ------------------------------------------------------ | ------------------------ |+| `IS`, `IS_NOT` su `SELECT` | array di chiavi di opzione (stringhe) | `['ACTIVE', 'PENDING']` |+| `CONTAINS`, `DOES_NOT_CONTAIN` su `MULTI_SELECT` | array di chiavi di opzione (stringhe) | `['TAG_A']` |+| `IS`, `IS_NOT` su `RELATION` | array di ID di record (uuid) | `['c5a1...']` |+| `CONTAINS`, `DOES_NOT_CONTAIN` su campi testuali | stringa | `'acme'` |+| `IS`, `IS_NOT` su `TEXT` | stringa (esatta, sensibile alle maiuscole e minuscole) | `'Acme'` |+| `IS`, `IS_NOT` su `NUMBER` | stringa (il valore) | `'5'` |+| `IS` su `RATING` / `UUID` | stringa (il valore) | `'5'` |+| `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL` | stringa (il limite) | `'10'` |+| `IS`, `IS_BEFORE`, `IS_AFTER` su `DATE` / `DATE_TIME` | stringa ISO 8601 | `'2025-01-01T00:00:00Z'` |+| `IS_EMPTY`, `IS_NOT_EMPTY` | stringa vuota | `''` |+| `IS` su `BOOLEAN` | `'true'` o `'false'` | `'true'` |## Come le viste vengono visualizzate nell'interfaccia utentediff --git a/packages/twenty-docs/it/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/it/developers/extend/apps/operations/cli.mdxindex c60b1389b56..f59568a7730 100644--- a/packages/twenty-docs/it/developers/extend/apps/operations/cli.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/operations/cli.mdx@@ -7,9 +7,9 @@ import { PageBanner } from "/snippets/page-banner.mdx"## Esecuzione della CLI-La CLI `twenty` si connette agli spazi di lavoro Twenty dal tuo terminale. Usala per ispezionare i metadati, leggere i record, inviare richieste API e creare, sincronizzare ed eseguire il debug delle app. Richiede **Node.js 24.5+ o 26.5+**.+La CLI `twenty` si connette agli spazi di lavoro Twenty dal tuo terminale. Usala per ispezionare i metadati, leggere i record, inviare richieste API e creare, sincronizzare ed eseguire il debug delle app. La CLI stessa richiede **Node.js 24.5+**. Lo sviluppo di app richiede anche una versione di Node supportata dall'SDK installato; consulta [Avvio rapido](/it/developers/extend/apps/getting-started/quick-start#before-you-start).-Esegui qualsiasi comando tramite `npx`, senza installare nulla:+Esegui qualsiasi comando tramite `npx`, senza un'installazione globale:```bash filename="Terminal"npx twenty@latest --version@@ -22,7 +22,7 @@ npm install -g twentytwenty --version```-Gli esempi seguenti usano `twenty`. Aggiungi il prefisso `npx twenty@latest` se non l'hai installata globalmente. Esegui `twenty commands` per l'elenco completo dei comandi e `twenty \<command> --help` per le opzioni di un comando.+Gli esempi seguenti usano `twenty`. Sostituisci `twenty` con `npx twenty@latest` se non lo hai installato globalmente. Esegui `twenty commands` per l'elenco completo dei comandi e `twenty \<command> --help` per le opzioni di un comando.| Comando | Cosa fa || ---------------- | --------------------------------------------------------------------------------------- |@@ -65,6 +65,14 @@ printf '%s' "$TWENTY_API_KEY" | twenty auth login --with-token --url https://acmPuoi anche impostare `TWENTY_API_URL` e `TWENTY_API_KEY` per una singola esecuzione senza salvare nulla. Le connessioni salvate si trovano in `~/.twenty/config.json`.+I comandi selezionano un workspace in questo ordine:++1. Un elemento esplicito `--remote \<name>`, che sovrascrive le variabili di ambiente di destinazione.+2. `TWENTY_REMOTE`, oppure la coppia `TWENTY_API_URL` e `TWENTY_API_KEY`. Non combinare questi due metodi.+3. Il remote predefinito salvato.++`auth login --name \<name>` salva una connessione ma mantiene un valore predefinito esistente. Aggiungi `--use` oppure esegui `twenty remote use \<name>` per modificare il valore predefinito.+## Esplorazione dei dati```bash filename="Terminal"diff --git a/packages/twenty-docs/it/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/it/developers/extend/apps/operations/publishing.mdxindex a450befbed5..bda28bf893c 100644--- a/packages/twenty-docs/it/developers/extend/apps/operations/publishing.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/operations/publishing.mdx@@ -61,11 +61,11 @@ twenty auth login --url https://your-twenty-server.com --name productionCompila e carica la tua app sul server in un solo passaggio:```bash filename="Terminal"-twenty app publish --private-# To deploy to a specific remote:-# twenty app publish --private --remote production+twenty app publish --private --remote production```+L'opzione esplicita `--remote production` seleziona la connessione salvata sopra, anche se un altro remote è quello predefinito. Il salvataggio di un remote denominato non modifica quello predefinito esistente.+### Condivisione di un'app distribuitaLe app in formato tarball non sono elencate nel marketplace pubblico, quindi altri spazi di lavoro sullo stesso server non le troveranno navigando. Per condividere un'app distribuita:@@ -83,7 +83,7 @@ Quando si aggiorna un'app in formato tarball già distribuita, il server richiedPer rilasciare un aggiornamento:1. Incrementa il campo `version` nel tuo `package.json` (ad es. `1.2.3` → `1.2.4`, `1.3.0` o `2.0.0`).-2. Esegui `twenty app publish --private` (oppure `twenty app publish --private --remote production`)+2. Esegui `twenty app publish --private --remote production`3. Gli spazi di lavoro che hanno installato l'app e abilitato l'aggiornamento automatico (nella scheda Generale dell'app) vengono aggiornati automaticamente in secondo piano; gli altri vedranno l'aggiornamento disponibile nelle loro impostazioni<Note>@@ -389,19 +389,21 @@ Vai alla pagina **Impostazioni > Applicazioni** in Twenty, dove è possibile sfo{/* TODO: add screenshot of the UI when the app is registered */}-Puoi anche installare le app dalla riga di comando:+Dalla directory dell'app, installa la versione pubblicata nell'area di lavoro di destinazione:```bash filename="Terminal"-twenty app install+twenty app install --remote production```+Utilizza il nome del remote per l'area di lavoro in cui vuoi installare l'app. Per installare senza un progetto locale, passa `--universal-identifier \<id>`.+<Note>Il server applica il versioning semver durante l’installazione, rispecchiando le regole del deploy:* L’installazione della stessa versione già installata nel tuo spazio di lavoro viene rifiutata con un errore `APP_ALREADY_INSTALLED`.* L’installazione di una versione inferiore rispetto a quella attualmente installata viene rifiutata con un errore `CANNOT_DOWNGRADE_APPLICATION`.-Per installare una versione più recente, effettua prima il deploy o la pubblicazione, quindi riesegui `twenty app install`.+Per installare una versione più recente, effettua prima il deploy o la pubblicazione, quindi riesegui `twenty app install --remote production`.</Note>diff --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 341ad8ecdfc..2b851556282 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@@ -20,7 +20,7 @@ Lo sviluppo di app in locale ruota attorno alla **sincronizzazione**: la CLI ric| ----------------------------------------------------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- || Iterare in locale con sincronizzazione in tempo reale | `twenty app dev` | Monitora i file e sincronizza a ogni modifica. || Sincronizzare una volta e uscire (CI, script, hook) | `twenty app apply` | Esegue una build + sincronizzazione, poi termina. Aggiungi `--yes` per saltare la conferma delle modifiche distruttive. |-| Visualizzare in anteprima le modifiche **senza applicarle** | `twenty app plan` | Calcola e stampa il diff; non scrive nulla. |+| Visualizzare in anteprima le modifiche **senza applicarle** | `twenty app plan` | Esegue la build localmente e stampa le differenze; non modifica il workspace. || 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.** Ripristina i file di definizione, le traduzioni e le dipendenze archiviate. Vedi sotto. |@@ -87,7 +87,7 @@ Plan: 1 to add, 1 to change, 0 to destroy.Un piano:-* **Non scrive nulla** — nessuna migrazione dei metadati, nessun aggiornamento del record dell'applicazione, nessuna modifica ai ruoli/schede predefiniti e nessuna generazione del client API.+* **Non modifica il workspace**, non esegue la migrazione dei metadati, l'aggiornamento dei record dell'applicazione o modifiche ai ruoli o alle schede predefiniti. Crea uno snapshot locale, ma non rigenera il client API.* Restituisce lo **stesso diff** che una sincronizzazione reale applicherebbe, così puoi esaminare in anticipo le entità create/aggiornate/eliminate.* È utile prima di una modifica rischiosa, quando si rivede una modifica generata da un'IA o in uno script che deve fallire se sta per essere applicata una modifica imprevista.@@ -139,13 +139,14 @@ Se l'installazione delle dipendenze non riesce per un nuovo progetto, lo scaffol* workflow, come file `defineWorkflow()`, quando la loro versione archiviata è quella scritta dall'ultima sincronizzazione. Per l'applicazione Custom dell'area di lavoro, è la versione attiva, sia che l'abbia pubblicata una sincronizzazione o il builder di workflow, e l'applicazione pubblica una definizione modificata come nuova versione, come descritto in [Workflow](/it/developers/extend/apps/logic/workflows#workflows-of-the-workspace-custom-application);* competenze, come file `defineSkill()`;* agenti, come file `defineAgent()`, con i relativi trigger e il ruolo a cui la tua app li associa;+* validation rules, as `defineValidationRule()` files with their expression as a string;* traduzioni pubblicate, come `locales/\<locale>.json` affinché strings pull possa rileggerle dai metadati e dalla sorgente scaricati, e `locales/compiled/\<locale>.json` per il resto.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.+Esegui `yarn install` dopo aver scaricato le modifiche alle dipendenze. Pull installa le dipendenze solo durante la creazione di un nuovo progetto, prima di ripristinare i file remoti; non le reinstalla dopo aver sostituito `package.json` o `yarn.lock`. Pull non rigenera il client tipizzato. Esegui `twenty app generate-client` quando ti servono tipi del workspace aggiornati.**Cosa non scrive:**@@ -156,6 +157,7 @@ Esegui `yarn install` dopo aver scaricato le modifiche alle dipendenze. Pull non* **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 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.+* **Validation rules the export cannot carry yet** — a rule with no expression or message, such as an unfinished draft from Settings, or one that reads a field deleted from the workspace, is reported and left in place.* **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.@@ -173,11 +175,12 @@ Quando i metadati locali sembrano errati, procedi in quest'ordine e fermati non2. **Visualizza in anteprima il piano.** Esegui `twenty app plan` per vedere esattamente cosa intende cambiare la prossima sincronizzazione, senza applicarlo.3. **Leggi l'errore nominale.** Se una sincronizzazione fallisce, annota il tipo di metadato e lo `universalIdentifier` nel messaggio (vedi sopra) e individua quell'entità nel tuo manifest. Un conflitto di solito indica un identificatore duplicato o riutilizzato.4. **Disinstalla e reinstalla.** `twenty app uninstall`, poi sincronizza di nuovo (`twenty app dev`). Questo ricostruisce i metadati dell'app partendo da zero, lasciando intatto il resto del tuo spazio di lavoro.-5. **Ripristino completo (ultima risorsa).** Reimposta il database di sviluppo Docker o del repository, quindi esegui di nuovo il seeding e la sincronizzazione.+5. **Reimpostazione completa (ultima risorsa).** Per un ambiente locale gestito dalla CLI, esegui `twenty local reset`, quindi `twenty local start` e riconnettiti prima di sincronizzare nuovamente. Per un checkout del codice sorgente, reimposta e inizializza nuovamente con dati seed il relativo database di sviluppo.<Warning>- la reimpostazione del database di sviluppo Docker o del repository elimina **tutti** i dati- nella tua istanza locale — ogni workspace, record e app. Usalo solo quando i passaggi precedenti hanno fallito.+ La reimpostazione dell'ambiente locale o del database di sviluppo del repository elimina+ **tutti** i dati nella tua istanza locale, ogni workspace, record e app. Usalo solo+ quando i passaggi precedenti hanno fallito.</Warning><Note>diff --git a/packages/twenty-docs/it/developers/extend/apps/operations/testing.mdx b/packages/twenty-docs/it/developers/extend/apps/operations/testing.mdxindex d41a5f522d5..72443ca8b16 100644--- a/packages/twenty-docs/it/developers/extend/apps/operations/testing.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/operations/testing.mdx@@ -176,7 +176,7 @@ Puoi anche eseguire il controllo dei tipi sulla tua app senza eseguire i test:twenty app typecheck```-Questo esegue `tsc --noEmit` sul file `tsconfig.json` della tua app e riporta eventuali errori di tipo. Le app generate dallo scaffolder includono anche uno script `yarn typecheck` che copre anche i file di test (`tsconfig.spec.json`).+Questo controlla il file `tsconfig.json` della tua app con il compilatore TypeScript installato, senza generare file, e segnala eventuali errori di tipo. Le app generate dallo scaffolder includono anche uno script `yarn typecheck` che copre anche i file di test (`tsconfig.spec.json`).## CI con GitHub Actionsdiff --git a/packages/twenty-docs/it/user-guide/calendar-emails/capabilities/calendar.mdx b/packages/twenty-docs/it/user-guide/calendar-emails/capabilities/calendar.mdxindex d51e6c40d98..4df24307495 100644--- a/packages/twenty-docs/it/user-guide/calendar-emails/capabilities/calendar.mdx+++ b/packages/twenty-docs/it/user-guide/calendar-emails/capabilities/calendar.mdx@@ -15,7 +15,7 @@ Twenty sincronizza automaticamente gli eventi del tuo calendario e li collega ai## Scheda del calendario-Accanto alla scheda Email nei record, troverai una scheda `Calendario` che contiene la cronologia delle riunioni programmate con il record.+Accanto alla scheda Messaggi nei record, troverai una scheda `Calendar` che contiene la cronologia delle riunioni programmate con il record.### Disponibile per@@ -26,7 +26,7 @@ Accanto alla scheda Email nei record, troverai una scheda `Calendario` che conti### Visualizzazione della cronologia delle riunioni1. **Naviga a un record**: Vai a qualsiasi record di Persona, Azienda o Opportunità-2. **Seleziona la scheda Calendario**: Clicca sulla scheda `Calendario` accanto alla scheda Emails+2. **Seleziona la scheda Calendar**: fai clic sulla scheda `Calendar` accanto alla scheda Messaggi3. **Sfoglia la cronologia delle riunioni**: Visualizza tutte le riunioni programmate e i loro dettagli4. **Accedi al contesto della riunione**: Vedi i partecipanti, i tempi e le informazioni relative alle riunionidiff --git a/packages/twenty-docs/it/user-guide/calendar-emails/capabilities/mailbox.mdx b/packages/twenty-docs/it/user-guide/calendar-emails/capabilities/mailbox.mdxindex 2d17888dfcb..4d0fc211466 100644--- a/packages/twenty-docs/it/user-guide/calendar-emails/capabilities/mailbox.mdx+++ b/packages/twenty-docs/it/user-guide/calendar-emails/capabilities/mailbox.mdx@@ -24,7 +24,7 @@ Le conversazioni email appaiono in tre oggetti principali:### Visualizzazione dei thread email1. **Naviga a un record**: Vai a qualsiasi record di Persona, Azienda o Opportunità-2. **Seleziona la scheda Email**: Clicca sulla scheda `Emails` per visualizzare le email sincronizzate+2. **Seleziona la scheda Messaggi**: Clicca sulla scheda `Messages` per visualizzare le email sincronizzate3. **Apri un thread email**: Clicca su qualsiasi email per aprire e leggere l'intera conversazione4. **Sfoglia cronologia**: Scorri attraverso la cronologia completa delle email con quel contattodiff --git a/packages/twenty-docs/it/user-guide/dashboards/capabilities/widgets.mdx b/packages/twenty-docs/it/user-guide/dashboards/capabilities/widgets.mdxindex 3d13b5e2d1b..8529b8e09f0 100644--- a/packages/twenty-docs/it/user-guide/dashboards/capabilities/widgets.mdx+++ b/packages/twenty-docs/it/user-guide/dashboards/capabilities/widgets.mdx@@ -104,11 +104,13 @@ Mostra in evidenza singoli valori chiave.Incorpora strumenti e contenuti esterni direttamente nella tua dashboard.-Per telefoni incorporati o strumenti video, un membro con l'autorizzazione a gestire la sicurezza può configurare **Impostazioni → Generali → Sicurezza → Accesso ai contenuti multimediali dei siti web incorporati**. Aggiungi l'origine HTTPS esatta del sito web, ad esempio `https://workspace.aircall.io`, e abilita **Microfono**, **Fotocamera** o entrambi. I percorsi e i caratteri jolly non sono accettati. Approva solo i siti web di cui ti fidi.+Per i widget iframe aggiunti nello spazio di lavoro, un membro con l'autorizzazione a gestire la sicurezza può configurare **Impostazioni → Generali → Sicurezza → Accesso ai contenuti multimediali dei siti web incorporati**. Aggiungi l'origine HTTPS esatta del sito web, ad esempio `https://workspace.aircall.io`, e abilita **Microfono**, **Fotocamera** o entrambi. I percorsi e i caratteri jolly non sono accettati. Approva solo i siti web di cui ti fidi.-Ricarica le schede di Twenty aperte dopo aver modificato queste autorizzazioni. La ricarica termina le chiamate e le registrazioni attive. Ogni membro seleziona quindi **Abilita microfono**, **Abilita videocamera** o **Abilita microfono e videocamera** nell'incorporamento e approva l'autorizzazione del browser quando richiesto.+Gli incorporamenti multimediali forniti da un'app installata utilizzano un'approvazione separata: l'app dichiara il sito web in [`requestedIframeMediaPermissions`](/it/developers/extend/apps/config/application#embedded-website-media-access) e un membro che può gestire le app lo approva durante l'installazione. Queste autorizzazioni si applicano ai componenti front-end e ai widget iframe dell'app stessa. Le approvazioni di sicurezza dello spazio di lavoro e le autorizzazioni di altre app non si applicano ai widget definiti dall'app.-L'indicatore nell'intestazione mostra **Accesso ai contenuti multimediali abilitato** quando un incorporamento dispone dell'accesso, anche quando è nascosto. Ciò non significa che il sito web stia registrando al momento: Twenty non può ispezionare l'attività del microfono o della videocamera all'interno di un altro sito web. Seleziona l'indicatore e scegli **Disabilita** per scaricare l'incorporamento e ricaricarlo con l'accesso ai contenuti multimediali bloccato. Per abilitare nuovamente l'accesso è necessario un altro clic.+Ricarica le schede di Twenty aperte dopo aver modificato queste autorizzazioni. La ricarica termina le chiamate e le registrazioni attive. Ogni volta che un membro seleziona **Abilita microfono**, **Abilita fotocamera** o **Abilita microfono e fotocamera** in un incorporamento, viene visualizzata una conferma nativa del browser che mostra il widget o l'app proprietaria, l'origine del sito web e l'accesso richiesto al microfono o alla fotocamera. Dopo aver confermato, approva l'autorizzazione del browser per i contenuti multimediali quando richiesto. Questa conferma si applica sia ai widget dello spazio di lavoro sia agli incorporamenti forniti dall'app.++L'indicatore nell'intestazione mostra **Accesso ai contenuti multimediali abilitato** quando un incorporamento dispone dell'accesso, anche quando è nascosto. Ciò non significa che il sito web stia registrando al momento: Twenty non può ispezionare l'attività del microfono o della videocamera all'interno di un altro sito web. Seleziona l'indicatore e scegli **Disabilita** per scaricare l'incorporamento e ricaricarlo con l'accesso ai contenuti multimediali bloccato. Seleziona nuovamente **Abilita** per ripristinare l'accesso.<Frame><img src="/images/user-guide/dashboard/dashboard-widget-table.png" alt="Grafico tabella" />diff --git a/packages/twenty-docs/ro/developers/extend/apps/config/application.mdx b/packages/twenty-docs/ro/developers/extend/apps/config/application.mdxindex 4f00e26db37..222004f98d9 100644--- a/packages/twenty-docs/ro/developers/extend/apps/config/application.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/config/application.mdx@@ -79,6 +79,29 @@ O aplicație instalată fără acordarea necesară întrerupe captura și afișeConsultați [Captură media](/ro/developers/extend/apps/layout/front-components#media-capture) pentru comportamentul capturii și indicatorii de înregistrare.+## Acces la conținut media pentru site-uri web încorporate++Setați `requestedIframeMediaPermissions` atunci când o componentă frontală sau un widget de dispunere a paginii `IFRAME` încorporează un site web care necesită microfonul sau camera, cum ar fi un instrument de telefonie sau video. Listați până la 20 de site-uri web, fiecare ca origine HTTPS exactă, cu accesul la microfon și cameră setat separat. Originile trebuie să fie unice, să nu conțină nicio cale sau caracter wildcard și să solicite acces la cel puțin unul dintre microfon sau cameră.++```ts+import { defineApplication } from 'twenty-sdk/define';++export default defineApplication({+ universalIdentifier: '39783023-bcac-41e3-b0d2-ff1944d8465d',+ displayName: 'Phone',+ description: 'Call your contacts from Twenty',+ requestedIframeMediaPermissions: [+ { origin: 'https://workspace.aircall.io', microphone: true, camera: false },+ ],+});+```++Site-urile web declarate apar în timpul instalării. Aprobarea necesită un membru al spațiului de lucru care poate gestiona aplicații și se aplică întregului spațiu de lucru, pentru propriile componente frontale și widgeturi iframe ale aplicației. Aprobările de securitate ale spațiului de lucru se aplică numai widgeturilor create în spațiul de lucru. Aplicațiile de dezvoltare sincronizate local primesc site-urile web declarate în manifestul lor. Aceste permisiuni acordate nu înlocuiesc permisiunile browserului sau ale sistemului de operare. Antetele browserului au o limită de dimensiune, astfel încât, dacă site-urile web ale unui spațiu de lucru o depășesc, site-urile web aprobate pentru spațiul de lucru au prioritate, iar site-urile web rămase nu primesc acces la conținut media.++Actualizările aplicațiilor publicate păstrează permisiunile existente și nu acordă automat acces suplimentar la conținut media. Pentru a aproba solicitări noi, un membru care poate gestiona aplicații deschide fila **Generale** a aplicației instalate și selectează **Revizuiește accesul la conținut media** sub **Acces la conținut media pentru site-uri web încorporate**. Această aprobare utilizează o confirmare nativă a browserului care afișează aplicația, originile site-urilor web și accesul solicitat la microfon sau cameră. După aprobare, reîncărcați filele Twenty deschise pentru a aplica permisiunile actualizate.++Consultați [Site-uri web încorporate cu acces la conținut media](/ro/developers/extend/apps/layout/front-components#embedded-websites-with-media-access) pentru cerințele iframe.+## Tipuri de variabileAtât `applicationVariables`, cât și `serverVariables` acceptă un câmp opțional `type` (și, pentru `SELECT` / `MULTI_SELECT`, o listă `options`). Tipuri acceptate: `TEXT` (implicit), `BOOLEAN`, `NUMBER`, `NUMERIC`, `DATE`, `DATE_TIME`, `SELECT`, `MULTI_SELECT`, `ARRAY`, `RAW_JSON`, `RICH_TEXT`.diff --git a/packages/twenty-docs/ro/developers/extend/apps/data/overview.mdx b/packages/twenty-docs/ro/developers/extend/apps/data/overview.mdxindex 39c13edf9f6..ecda101e40d 100644--- a/packages/twenty-docs/ro/developers/extend/apps/data/overview.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/data/overview.mdx@@ -34,7 +34,7 @@ Stratul de **date** al unei aplicații Twenty reprezintă datele pe care aplica<CardTitle>Obiectele</CardTitle>`defineObject` - declara noi tipuri de înregistrări cu propriile lor câmpuri.</Card>- <Card href="/ro/developers/extend/apps/data/extending-objects" img="/images/user-guide/halftone/card-page-extending-objects.svg">+ <Card href="/dezvoltatori/extindere/aplicații/date/extindere/obiecte" img="/images/ghid/halfton/card-page-extenending-obiects.svg"><CardTitle>Extinderea obiectelor</CardTitle>`defineField` - adaugă câmpuri la obiectele standard sau alte aplicații.</Card>@@ -46,6 +46,10 @@ Stratul de **date** al unei aplicații Twenty reprezintă datele pe care aplica<CardTitle>Tipuri de activitate de cronologie</CardTitle>Definiți evenimentele automate de audit și evenimentele aplicației explicite pentru cronologii înregistrate.</Card>+ <Card href="/ro/developers/extend/apps/data/objects" img="/images/user-guide/halftone/card-page-objects.svg">+ <CardTitle>Reguli de validare</CardTitle>+ `defineValidationRule` — declară condițiile pe care trebuie să le îndeplinească o înregistrare înainte de a putea fi salvată.+ </Card></CardGroup>## Entități dintr-o privire@@ -58,8 +62,9 @@ Stratul de **date** al unei aplicații Twenty reprezintă datele pe care aplica| **Indice** | Un indice de bază de date pentru a accelera o interogare recurentă asupra unuia dintre obiectele tale | `defineIndex()` || **Tip de activitate a cronologiei** | Un eveniment automat de audit sau un eveniment explicit de domeniu afișat în cronologiile înregistrărilor | `defineTimelineActivityType()` || **Cale de înregistrări asociate** | Un lanț de până la trei relații prin care accesul la o înregistrare se extinde la înregistrările sale asociate | `defineRelatedRecordPath()` |+| **Regulă de validare** | O condiție pe care trebuie să o îndeplinească o înregistrare înainte de a putea fi salvată | `defineValidationRule()` |-CLI-ul detectează acestea prin analiza AST la momentul build-ului, astfel încât organizarea fișierelor ține de tine — convenția este `src/objects/`, `src/fields/`, `src/indexes/`, `src/timeline-activity-types/` și `src/related-record-paths/`. UUID-urile stabile `universalIdentifier` leagă totul în toate implementările.+CLI-ul detectează acestea prin analiza AST la momentul build-ului, astfel încât organizarea fișierelor ține de tine — convenția este `src/objects/`, `src/validation-rules/`, `src/fields/`, `src/indexes/`, `src/timeline-activity-types/` și `src/related-record-paths/`. UUID-urile stabile `universalIdentifier` leagă totul în toate implementările.## Indici (opțional)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 316d7c957d0..7fc3934674c 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@@ -18,6 +18,7 @@ your-app/│ ├── roles/ ← defineRole│ ├── objects/ ← defineObject│ ├── fields/ ← defineField+│ ├── validation-rules/ ← defineValidationRule│ ├── logic-functions/ ← defineLogicFunction│ ├── front-components/ ← defineFrontComponent│ ├── skills/ ← defineSkill@@ -46,6 +47,7 @@ your-app/| **Obiect** | Tipuri de înregistrări personalizate cu câmpuri | [Objects](/ro/developers/extend/apps/data/objects) || **Câmp** | Adăugați câmpuri la obiecte din alte aplicații | [Extending Objects](/ro/developers/extend/apps/data/extending-objects) || **Relație** | Legături bidirecționale între obiecte | [Relations](/ro/developers/extend/apps/data/relations) |+| **Regulă de validare** | Condiții pe care o înregistrare trebuie să le îndeplinească înainte de a putea fi salvată | [Reguli de validare](/ro/developers/extend/apps/data/validation-rules) || **Funcție logică** | TypeScript pe partea de server cu declanșatoare | [Funcții logice](/ro/developers/extend/apps/logic/logic-functions) || **Abilitate** | Instrucțiuni reutilizabile pentru agenți AI | [Abilități și agenți](/ro/developers/extend/apps/logic/skills-and-agents) || **Agent** | Agenți AI cu prompturi personalizate | [Abilități și agenți](/ro/developers/extend/apps/logic/skills-and-agents) |@@ -86,7 +88,7 @@ your-app/└─────────────────────────────────────────────────────────┘```-* **`douăzeci de aplicații dev`** — îți urmărește fișierele sursă și modificările live-syncs la un server conectat. Clientul API tipizat este regenerat automat atunci când schema se schimbă.+* **`douăzeci de aplicații dev`** — îți urmărește fișierele sursă și modificările live-syncs la un server conectat. După o sincronizare reușită, regenerează clientul API tipizat atunci când schema sau pachetul generator instalat s-au modificat ori când fișierele client generate lipsesc sau au fost modificate. Pentru a reîmprospăta tipurile după schimbarea spațiului de lucru în interfața cu utilizatorul, rulează `twenty app generate-client`.* **`douăzeci de aplicații construite`** — compilează TypeScript, împachetează funcțiile logice și componentele frontale cu esbuild, și produce un manifest.* **Hook-uri pre/post-instalare și dezinstalare** — funcții opționale care rulează în timpul instalării sau chiar înainte de eliminare. Vezi [Install Hooks](/ro/developers/extend/apps/config/install-hooks) pentru detalii.diff --git a/packages/twenty-docs/ro/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/ro/developers/extend/apps/getting-started/local-server.mdxindex e9aa9cc0bfb..e7acb7ea45c 100644--- a/packages/twenty-docs/ro/developers/extend/apps/getting-started/local-server.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/getting-started/local-server.mdx@@ -93,7 +93,7 @@ Pentru un checkout al codului-sursă Twenty, funcționează și mediul de dezvol```bashbash packages/twenty-utils/setup-dev-env.shyarn start-twenty auth login --url http://localhost:3000 --name local+twenty auth login --url http://localhost:3000 --name local --use```Utilizați URL-ul și portul efective ale serverului dvs. Pentru spațiile de lucru cu subdomenii, utilizați@@ -102,8 +102,9 @@ numele de gazdă al spațiului de lucru. Pentru implementarea în producție, ur## Dependențele proiectului-Instalați `twenty-sdk` și `twenty-client-sdk` ca dependențe ale proiectului. Instalați-CLI-ul `twenty` la nivel global, apoi rulați `twenty app typecheck`, `twenty app build` și-`twenty app apply` din directorul aplicației.+`twenty app init` declară `twenty-sdk`, `twenty-client-sdk` și `twenty-ui` în+`devDependencies`, dar nu le instalează. Cu CLI-ul `twenty` instalat+global, rulați `yarn install` din directorul aplicației generate înainte de a rula+`twenty app typecheck`, `twenty app build` sau `twenty app apply`.<PageBanner illustration="dev-self-host" />diff --git a/packages/twenty-docs/ro/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/ro/developers/extend/apps/getting-started/project-structure.mdxindex 16f5de0d683..683f9522dc5 100644--- a/packages/twenty-docs/ro/developers/extend/apps/getting-started/project-structure.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/getting-started/project-structure.mdx@@ -12,6 +12,7 @@ O aplicație nouă generată de `twenty app init` arată astfel:```text filename="my-twenty-app/"my-twenty-app/package.json+ yarn.lock # Created by app init; used by yarn installsrc/application-config.ts # Required — your app's entry pointdefault-role.ts # Permissions for logic functions@@ -28,6 +29,7 @@ my-twenty-app/__tests__/application-config.test.ts # Unit testglobal-setup.ts # Integration test setup (sync + uninstall)+ run-twenty.ts # CLI subprocess helper for testsschema.integration-test.ts # Integration test against a live server.github/workflows/ci.yml # Lint, typecheck, unit + integration tests@@ -67,20 +69,9 @@ my-twenty-app/## Dependențe-Pachetele SDK și UI Twenty aparțin în `devDependencies`:+`twenty app init` adaugă `twenty-sdk`, `twenty-client-sdk` și `twenty-ui` în `devDependencies`, fixate la versiunea SDK selectată de acea versiune CLI. Păstrați versiunile generate pentru o aplicație nouă și mențineți toate cele trei pachete sincronizate la actualizare. CLI-ul poate primi versiuni patch în mod independent, astfel încât versiunea sa nu trebuie să corespundă cu cea a acestor pachete.-```json filename="package.json"-{- "dependencies": {},- "devDependencies": {- "twenty-client-sdk": "2.40.0",- "twenty-sdk": "2.40.0",- "twenty-ui": "2.40.0"- }-}-```--`twenty app init` fixează `twenty-sdk`, `twenty-client-sdk` și `twenty-ui` la propria sa versiune. Menține-le pe toate trei sincronizate atunci când faci actualizarea.+Elementul generat `engines.twenty` stabilește versiunea minimă de server la versiunea majoră și minoră a acelui SDK. Fluxurile de lucru GitHub Actions generate fixează separat versiunea CLI.* **`twenty-sdk`** oferă definiții de aplicații, ajutoare pentru timpul de execuție și integrare cu motorul de randare. Utilizați pachetul **`twenty`** instalat separat pentru comenzile CLI și instrumentele de compilare/generare a structurii de bază.* **`twenty-client-sdk`** este importat de codul aplicației tale (`CoreApiClient`, `MetadataApiClient`, `RestApiClient`), dar Twenty îl furnizează la runtime — funcțiile de logică îl obțin dintr-un strat SDK generat, iar componentele de interfață îl rezolvă din module livrate de server. Copia instalată local este folosită doar pentru verificarea tipurilor și pentru build-ul la momentul de deploy, astfel că nu trebuie niciodată inclusă în bundle-ul livrat.diff --git a/packages/twenty-docs/ro/developers/extend/apps/getting-started/quick-start.mdx b/packages/twenty-docs/ro/developers/extend/apps/getting-started/quick-start.mdxindex fcb3ed7ee51..c626399a4d7 100644--- a/packages/twenty-docs/ro/developers/extend/apps/getting-started/quick-start.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/getting-started/quick-start.mdx@@ -8,7 +8,7 @@ import { CardTitle } from "/snippets/card-title.mdx"## Înainte de a începe-Utilizați Node.js 24.5+ sau 26.5+ și Yarn 4 (prin Corepack: `corepack enable`; pe Node 26, instalați-l mai întâi cu `npm install -g corepack`). Instalați CLI-ul la nivel global; aplicația dvs. își păstrează propriile dependențe SDK.+Folosește Node.js 24 (24.5+) sau 26 (26.5.1+) și Yarn 4 (prin Corepack: `corepack enable`; pe Node 26, instalează-l mai întâi cu `npm install -g corepack`). Instalați CLI-ul la nivel global; aplicația dvs. își păstrează propriile dependențe SDK.<Note>Construirea aplicațiilor Twenty este acceptată oficial numai pe sistemele Unix (macOS și Linux). Pe Windows, lucrați în WSL 2.@@ -30,9 +30,12 @@ yarn installFolosiți un spațiu de lucru existent sau porniți un [server local](/ro/developers/extend/apps/getting-started/local-server), apoi autentificați-vă:```bash-twenty auth login --url https://your-workspace.twenty.com --name dev+twenty auth login --url https://your-workspace.twenty.com --name dev --use+twenty auth status --remote dev```+`--name dev` salvează conexiunea ca `dev`; `--use` o setează ca implicită pentru comenzile de mai jos. Pentru a o viza în mod explicit, adaugă `--remote dev`. Variabilele de mediu pot suprascrie opțiunea implicită; consultă [selectarea spațiului de lucru](/ro/developers/extend/apps/operations/cli#connecting-to-a-workspace).+## Sincronizați modificărilePentru prima sincronizare, permiteți explicit înregistrarea și instalarea:diff --git a/packages/twenty-docs/ro/developers/extend/apps/getting-started/scaffolding.mdx b/packages/twenty-docs/ro/developers/extend/apps/getting-started/scaffolding.mdxindex 37c024566a7..ffb90da6b73 100644--- a/packages/twenty-docs/ro/developers/extend/apps/getting-started/scaffolding.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/getting-started/scaffolding.mdx@@ -7,12 +7,13 @@ import { PageBanner } from "/snippets/page-banner.mdx"## Prezentare generală-Utilizați CLI-ul independent pentru a genera un obiect, un câmp, o funcție logică sau o componentă front-end:+Utilizați CLI-ul independent pentru a genera un obiect, un câmp, o regulă de validare, o funcție logică sau o componentă front-end:```bashtwenty app addtwenty app add object --name invoice --name-plural invoices --no-inputtwenty app add field --name amount --type NUMBER --object <object-uuid> --no-input+twenty app add validation-rule --name invoice-has-amount --object <object-uuid> --no-inputtwenty app add logic-function --name send-invoice --no-inputtwenty app add front-component --name invoice-panel --no-input```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 21281065884..f33547d338d 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@@ -1205,10 +1205,31 @@ Un punct portocaliu în antetul spațiului de lucru indică o captură activă.`getUserMedia()` și `MediaRecorder` rulează prin polyfill-uri sandbox, astfel încât codul standard de înregistrare și `MediaRecorder.isTypeSupported()` funcționează nemodificate după aprobare. Obiectele detaliate de constrângeri sunt acceptate, dar nu sunt transmise mai departe. Gazda realizează captura folosind valorile sale implicite pentru tipurile solicitate. Aplicații diferite pot realiza capturi simultan, iar oprirea unei aplicații afectează doar propriile sesiuni. Fiecare componentă front acceptă câte o captură în așteptare sau activă la un moment dat. Stochează un `Blob` înregistrat cu funcția gazdă `uploadFile`.+### Site-uri web încorporate cu acces la conținut media++Pentru a încorpora un instrument de telefonie sau video, declarați originea HTTPS a acestuia în [`requestedIframeMediaPermissions`](/ro/developers/extend/apps/config/application#embedded-website-media-access) din aplicația dvs., cu accesul la microfon și cameră configurat separat. Instalarea aplicației acordă spațiului de lucru acces pentru aceste site-uri web. Actualizările aplicațiilor publicate păstrează permisiunile existente și nu acordă automat acces suplimentar la conținut media. Aplicațiile de dezvoltare sincronizate local primesc automat site-urile web declarate în manifestul lor. Un membru care poate gestiona aplicații poate aproba solicitări noi din fila **General** a aplicației instalate, în **Acces media pentru site-uri web încorporate** > **Revizuiește accesul media**. Această aprobare utilizează o confirmare nativă a browserului care afișează aplicația, originile site-urilor web și accesul solicitat la microfon sau cameră. Twenty citește site-urile web autorizate când se încarcă o filă, deci reîncărcați filele Twenty deschise după instalare sau aprobare.++Solicitați funcțiile corespunzătoare în iframe:++```tsx+<iframe+ title="Aircall phone"+ src="https://workspace.aircall.io?integration=generic"+ allow="microphone"+ width={376}+ height={666}+/>+```++Pentru video, utilizați `allow="microphone; camera"` și declarați ambele pentru origine. Twenty deleagă doar accesul media acordat aplicației dvs. pentru acea origine. Membrii trebuie să selecteze controlul **Activează** al elementului încorporat și să aprobe o confirmare nativă a browserului care afișează aplicația, originea site-ului web și accesul solicitat la microfon sau cameră înainte ca acesta să primească acces la conținut media. Permisiunile browserului și ale sistemului de operare se aplică în continuare. `srcDoc` și elementele încorporate la originea proprie a Twenty nu pot primi această delegare. Widgeturile de aspect de pagină `IFRAME` definite de aplicație utilizează originile autorizate ale aplicației proprietare și același flux de confirmare.++Elementele încorporate activate apar în același indicator din antet ca și capturarea nativă, cu **Acces la microfon activat** sau **Acces la cameră activat**, în loc să indice că înregistrarea este activă. Indicatorul rămâne vizibil cât timp accesul este activat, chiar dacă elementul încorporat este ascuns. **Dezactivează** descarcă iframe-ul și îl reîncarcă cu accesul media blocat. Capturarea aplicației prin `getUserMedia()` continuă să raporteze capturarea efectivă și păstrează propriul control **Oprește**.++Conținutul iframe rămâne izolat într-un sandbox. Elementele externe încorporate cu conținut media aprobate își păstrează propria origine după ce membrul activează accesul, permițând site-ului web să își utilizeze sesiunea și să solicite permisiuni media în browser. Alte iframe-uri ale componentelor front-end păstrează o origine sandbox opacă.+### Alte lacune* **Payload-uri drag-and-drop.** Evenimentele de tip drag sunt declanșate, dar `event.dataTransfer` este `undefined`.* **Built-in-uri Node.** `fs`, `path` și `node:crypto` eșuează la build, așa că mută acea logică într-o [logic function](/ro/developers/extend/apps/logic/logic-functions). Web Crypto înlocuiește `node:crypto`, iar `fetch`, `TextEncoder` și `URL` sunt de asemenea disponibile, vedeți [domeniul global](#global-scope) — dar nimic nu înlocuiește `fs`: sandboxul nu are sistem de fișiere.-* **`iframe`** este întotdeauna re-sandboxat fără `allow-same-origin`, astfel încât o încorporare care se bazează pe propria sesiune se afișează ca delogat. Nu are nici `onLoad`.<PageBanner illustration="card-page-front-components" />diff --git a/packages/twenty-docs/ro/developers/extend/apps/layout/page-layouts.mdx b/packages/twenty-docs/ro/developers/extend/apps/layout/page-layouts.mdxindex 8b23077ec29..e1369dc4f57 100644--- a/packages/twenty-docs/ro/developers/extend/apps/layout/page-layouts.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/layout/page-layouts.mdx@@ -65,6 +65,7 @@ export default definePageLayout({* Setează explicit `layoutMode`. Dacă îl omiți, vei obține `VERTICAL_LIST` pe un `STANDALONE_PAGE` și `GRID` în rest, ceea ce rareori îți dorești pe o pagină de înregistrare.* Fiecare `widget` dintr-o filă poate reda un [front component](/ro/developers/extend/apps/layout/front-components), o listă de relații sau alte tipuri de widgeturi integrate.* Un widget `FRONT_COMPONENT` poate seta `headerCommandMenuItemUniversalIdentifiers` la o matrice ordonată de identificatori universali ai elementelor meniului de comenzi din aceeași aplicație. Aceste acțiuni apar ca butoane cu pictograme în antetul cardului widgetului și își păstrează verificările de disponibilitate și permisiuni la nivel de comandă. Identificatorii trebuie să fie unici și trebuie să se rezolve atunci când aplicația este instalată.+* Un widget `IFRAME` poate utiliza microfonul sau camera pentru site-uri web aprobate prin [`requestedIframeMediaPermissions`](/ro/developers/extend/apps/config/application#embedded-website-media-access) ale aplicației care îl deține. Membrii selectează **Activare** și aprobă o confirmare nativă a browserului care afișează aplicația, originea site-ului web și accesul solicitat la microfon sau cameră înainte ca accesul să înceapă. Aprobările de securitate ale spațiului de lucru și autorizațiile altor aplicații nu se aplică widgeturilor definite de aplicație.* `position` pe file le controlează ordinea. Folosește valori mai mari (de ex., 50) pentru a plasa filele personalizate după cele integrate.* `twenty app pull` scrie aspectele paginilor înapoi, cu filele și widgeturile lor inline. Un widget pe care exportul nu îl poate include încă, cum ar fi unul care afișează propria componentă front-end a aplicației dvs. sau unul de tipul `VIEW` depreciat, este raportat de pull în loc să fie scris; consultați [ce nu scrie pull](/ro/developers/extend/apps/operations/sync-and-recovery#pulling-an-installed-app-back-to-source).diff --git a/packages/twenty-docs/ro/developers/extend/apps/layout/views.mdx b/packages/twenty-docs/ro/developers/extend/apps/layout/views.mdxindex 33fcb219428..6d6aa65fa3c 100644--- a/packages/twenty-docs/ro/developers/extend/apps/layout/views.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/layout/views.mdx@@ -87,21 +87,22 @@ Trei proprietăți opționale rafinează un filtru:### Operanzi acceptați pentru fiecare tip de câmp-| Tipul câmpului | Operanzi acceptați |-| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |-| `TEXT`, `EMAILS`, `FULL_NAME`, `ADDRESS`, `LINKS`, `PHONES`, `RAW_JSON`, `FILES`, `ACTOR`, `ARRAY` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `ACTOR.source`, `ACTOR.workspaceMemberId` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `SELECT` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `MULTI_SELECT` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `RELATION` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `NUMBER` | `IS`, `IS_NOT`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `RATING` | `IS`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `CURRENCY`, `CURRENCY.amountMicros` | `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `CURRENCY.currencyCode` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `DATE`, `DATE_TIME` | `IS`, `IS_RELATIVE`, `IS_IN_PAST`, `IS_IN_FUTURE`, `IS_TODAY`, `IS_BEFORE`, `IS_AFTER`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `BOOLEAN` | `IS` |-| `UUID` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |-| `TS_VECTOR` | `VECTOR_SEARCH` |+| Tipul câmpului | Operanzi acceptați |+| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ |+| `TEXT` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `EMAILS`, `FULL_NAME`, `ADDRESS`, `LINKS`, `PHONES`, `RAW_JSON`, `FILES`, `ACTOR`, `ARRAY` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `ACTOR.source`, `ACTOR.workspaceMemberId` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `SELECT` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `MULTI_SELECT` | `CONTAINS`, `DOES_NOT_CONTAIN`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `RELATION` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `NUMBER` | `IS`, `IS_NOT`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `RATING` | `IS`, `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `CURRENCY`, `CURRENCY.amountMicros` | `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL`, `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `CURRENCY.currencyCode` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `DATE`, `DATE_TIME` | `IS`, `IS_RELATIVE`, `IS_IN_PAST`, `IS_IN_FUTURE`, `IS_TODAY`, `IS_BEFORE`, `IS_AFTER`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `BOOLEAN` | `IS` |+| `UUID` | `IS`, `IS_NOT`, `IS_EMPTY`, `IS_NOT_EMPTY` |+| `TS_VECTOR` | `VECTOR_SEARCH` |> Tipurile de câmp cu nume similare pot folosi operanzi complet diferiți — `SELECT` și `MULTI_SELECT` fiind un caz comun.@@ -115,6 +116,7 @@ Câmpul `value` este întotdeauna o valoare serializabilă JSON, dar forma sa a| `CONTAINS`, `DOES_NOT_CONTAIN` pe `MULTI_SELECT` | array de chei de opțiune (șiruri de caractere) | `['TAG_A']` || `IS`, `IS_NOT` pe `RELATION` | array de ID-uri de înregistrare (uuid-uri) | `['c5a1...']` || `CONTAINS`, `DOES_NOT_CONTAIN` pe câmpuri de tip text | șir | `'acme'` |+| `IS`, `IS_NOT` pe `TEXT` | șir (exact, sensibil la caz) | `"Acme'` || `IS`, `IS_NOT` pe `NUMBER` | șir de caractere (valoarea) | `'5'` || `IS` pe `RATING` / `UUID` | șir de caractere (valoarea) | `'5'` || `GREATER_THAN_OR_EQUAL`, `LESS_THAN_OR_EQUAL` | șir de caractere (limita) | `'10'` |diff --git a/packages/twenty-docs/ro/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/ro/developers/extend/apps/operations/cli.mdxindex 36957379c8d..c566d01a6a4 100644--- a/packages/twenty-docs/ro/developers/extend/apps/operations/cli.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/operations/cli.mdx@@ -7,9 +7,9 @@ import { PageBanner } from "/snippets/page-banner.mdx"## Rularea CLI-ului-CLI-ul `twenty` se conectează la spațiile de lucru Twenty din terminalul dvs. Folosiți-l pentru a inspecta metadatele, a citi înregistrări, a trimite solicitări API și a crea, sincroniza și depana aplicații. Necesită **Node.js 24.5+ sau 26.5+**.+CLI-ul `twenty` se conectează la spațiile de lucru Twenty din terminalul dvs. Folosiți-l pentru a inspecta metadatele, a citi înregistrări, a trimite solicitări API și a crea, sincroniza și depana aplicații. CLI-ul însuși necesită **Node.js 24.5+**. Dezvoltarea aplicațiilor necesită, de asemenea, o versiune Node acceptată de SDK-ul instalat; consultați [Pornire rapidă](/ro/developers/extend/apps/getting-started/quick-start#before-you-start).-Rulați orice comandă prin `npx`, fără a instala nimic:+Rulați orice comandă prin `npx`, fără o instalare globală:```bash filename="Terminal"npx twenty@latest --version@@ -22,7 +22,7 @@ npm install -g twentytwenty --version```-Exemplele de mai jos folosesc `twenty`. Prefixați-le cu `npx twenty@latest` dacă nu l-ați instalat la nivel global. Rulați `twenty commands` pentru lista completă de comenzi și `twenty \<command> --help` pentru opțiunile unei comenzi.+Exemplele de mai jos folosesc `twenty`. Înlocuiți `twenty` cu `npx twenty@latest` dacă nu l-ați instalat global. Rulați `twenty commands` pentru lista completă de comenzi și `twenty \<command> --help` pentru opțiunile unei comenzi.| Comandă | Ce face || --------------- | -------------------------------------------------------------------------------------- |@@ -65,6 +65,14 @@ printf '%s' "$TWENTY_API_KEY" | twenty auth login --with-token --url https://acmDe asemenea, puteți seta `TWENTY_API_URL` și `TWENTY_API_KEY` pentru o singură rulare fără a salva nimic. Conexiunile salvate se află în `~/.twenty/config.json`.+Comenzile selectează un spațiu de lucru în această ordine:++1. Un `--remote \<name>` explicit, care suprascrie variabilele de mediu țintă.+2. `TWENTY_REMOTE` sau perechea `TWENTY_API_URL` și `TWENTY_API_KEY`. Nu combinați aceste două metode.+3. Remote-ul implicit salvat.++`auth login --name \<name>` salvează o conexiune, dar păstrează un remote implicit existent. Adăugați `--use` sau rulați `twenty remote use \<name>` pentru a schimba remote-ul implicit.+## Explorarea datelor```bash filename="Terminal"diff --git a/packages/twenty-docs/ro/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/ro/developers/extend/apps/operations/publishing.mdxindex da69af41a0b..576a3b729ca 100644--- a/packages/twenty-docs/ro/developers/extend/apps/operations/publishing.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/operations/publishing.mdx@@ -61,11 +61,11 @@ twenty auth login --url https://your-twenty-server.com --name productionConstruiește și încarcă aplicația ta pe server într-un singur pas:```bash filename="Terminal"-twenty app publish --private-# To deploy to a specific remote:-# twenty app publish --private --remote production+twenty app publish --private --remote production```+`--remote production` explicit selectează conexiunea salvată mai sus, chiar dacă o altă conexiune la distanță este implicită. Salvarea unei conexiuni la distanță cu nume nu schimbă o conexiune implicită existentă.+### Partajarea unei aplicații implementateAplicațiile tarball nu sunt listate în marketplace-ul public, astfel încât alte spații de lucru de pe același server nu le vor descoperi prin navigare. Pentru a partaja o aplicație implementată:@@ -83,7 +83,7 @@ Când actualizezi o aplicație tarball deja implementată, serverul solicită caPentru a lansa o actualizare:1. Incrementează câmpul `version` din `package.json` (de ex. `1.2.3` → `1.2.4`, `1.3.0` sau `2.0.0`)-2. Rulează `twenty app publish --private` (sau `twenty app publish --private --remote production`)+2. Rulează `twenty app publish --private --remote production`3. Spațiile de lucru care au aplicația instalată și au activat actualizarea automată pentru aceasta (în fila General a aplicației) sunt actualizate automat în fundal; celelalte vor vedea actualizarea disponibilă în setările lor<Note>@@ -388,19 +388,21 @@ Mergi la pagina **Setări > Aplicații** din Twenty, unde pot fi parcurse și in{/* TODO: add screenshot of the UI when the app is registered */}-Poți instala aplicații și din linia de comandă:+Din directorul aplicației, instalează versiunea sa publicată în spațiul de lucru țintă:```bash filename="Terminal"-twenty app install+twenty app install --remote production```+Folosește numele conexiunii la distanță pentru spațiul de lucru în care dorești să instalezi aplicația. Pentru a instala fără un proiect local, transmite `--universal-identifier \<id>`.+<Note>Serverul impune versionarea semver la instalare, reflectând regulile de la deploy:* Instalarea aceleiași versiuni care este deja instalată în spațiul tău de lucru este respinsă cu o eroare `APP_ALREADY_INSTALLED`.* Instalarea unei versiuni mai mici decât cea instalată în prezent este respinsă cu o eroare `CANNOT_DOWNGRADE_APPLICATION`.-Pentru a instala o versiune mai nouă, implementeaz-o sau public-o mai întâi, apoi rulează din nou `twenty app install`.+Pentru a instala o versiune mai nouă, fă mai întâi deploy sau public-o, apoi rulează din nou `twenty app install --remote production`.</Note>diff --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 a531b443004..972070dacfc 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@@ -20,7 +20,7 @@ Dezvoltarea locală de aplicații se învârte în jurul **sincronizării**: CLI| -------------------------------------------------------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- || Iterează local cu sincronizare în timp real | `twenty app dev` | Monitorizează fișierele și sincronizează la fiecare modificare. || Sincronizează o singură dată și iese (CI, scripturi, hook-uri) | `twenty app apply` | O singură compilare + sincronizare, apoi iese. Adaugă `--yes` pentru a omite confirmarea schimbărilor distructive. |-| Previzualizează modificările **fără a le aplica** | `twenty app plan` | Calculează și afișează diff-ul; nu scrie nimic. |+| Previzualizează modificările **fără a le aplica** | `twenty app plan` | Generează local și afișează diferențele; nu modifică spațiul de lucru. || 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.** Restaurează fișierele define, traducerile și dependențele stocate. Consultați mai jos. |@@ -87,7 +87,7 @@ Plan: 1 to add, 1 to change, 0 to destroy.Un plan:-* **Nu scrie nimic** — fără migrare de metadate, fără actualizare a înregistrării aplicației, fără modificări ale rolului sau filei implicite și fără generare de client API.+* **Nu modifică spațiul de lucru**, nu efectuează migrarea metadatelor, actualizarea înregistrărilor aplicației sau modificări ale rolului/filei implicite. Creează un instantaneu local, dar nu regenerează clientul API.* Returnează **același diff** pe care l-ar aplica o sincronizare reală, astfel încât poți revizui dinainte entitățile create/actualizate/șterse.* Este util înaintea unei modificări riscante, când revizuiești o modificare generată de AI sau într-un script care ar trebui să eșueze dacă o modificare neașteptată este pe cale să fie aplicată.@@ -139,13 +139,14 @@ Dacă instalarea dependențelor eșuează pentru un proiect nou, scaffold-ul est* fluxurile de lucru, ca fișiere `defineWorkflow()`, atunci când versiunea lor stocată este cea scrisă de ultima sincronizare. Pentru aplicația Custom a spațiului de lucru, este versiunea activă, indiferent dacă a fost publicată de o sincronizare sau de constructorul de fluxuri de lucru, iar aplicarea publică o definiție modificată ca versiune nouă, după cum este descris în [Workflows](/ro/developers/extend/apps/logic/workflows#workflows-of-the-workspace-custom-application);* abilități, ca fișiere `defineSkill()`;* agenți, ca fișiere `defineAgent()`, cu declanșatoarele lor și rolul căruia aplicația dvs. îi face asocierea;+* validation rules, as `defineValidationRule()` files with their expression as a string;* traduceri publicate, ca `locales/\<locale>.json` pentru ca strings pull să poată citi înapoi din metadatele și sursa extrase și `locales/compiled/\<locale>.json` pentru restul.Fiecare 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.+Rulați `yarn install` după preluarea modificărilor dependențelor. Pull instalează dependențele doar la crearea unui proiect nou, înainte de restaurarea fișierelor la distanță; nu le reinstalează după înlocuirea `package.json` sau `yarn.lock`. Pull nu regenerează clientul tipizat. Rulează `twenty app generate-client` când ai nevoie de tipuri actualizate pentru spațiul de lucru.**Ce nu scrie:**@@ -156,6 +157,7 @@ Rulați `yarn install` după preluarea modificărilor dependențelor. Pull nu in* **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 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.+* **Validation rules the export cannot carry yet** — a rule with no expression or message, such as an unfinished draft from Settings, or one that reads a field deleted from the workspace, is reported and left in place.* **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.@@ -173,12 +175,12 @@ Când metadatele locale par greșite, escaladează în această ordine și opre2. **Previzualizează planul.** Rulează `twenty app plan` pentru a vedea exact ce intenționează să schimbe următoarea sincronizare, fără a-l aplica.3. **Citește eroarea nominalizată.** Dacă o sincronizare eșuează, notează tipul de metadate și `universalIdentifier`-ul din mesaj (vezi mai sus) și localizează acea entitate în manifest. Un conflict indică de obicei un identificator duplicat sau reutilizat.4. **Dezinstalează și reinstalează.** `twenty app uninstall`, apoi sincronizează din nou (`twenty app dev`). Acest lucru reconstruiește metadatele aplicației de la zero, păstrând în același timp restul spațiului de lucru intact.-5. **Resetare completă (ultimă soluție).** resetează baza de date de dezvoltare Docker sau a repository-ului, apoi reinițializează datele și resincronizează.+5. **Resetare completă (ultimă soluție).** Pentru un mediu local gestionat prin CLI, rulează `twenty local reset`, apoi `twenty local start` și reconectează-te înainte de a sincroniza din nou. Pentru un checkout al sursei, resetează și reinițializează cu date baza de date de dezvoltare a acestuia.<Warning>- resetarea bazei de date de dezvoltare Docker sau a repository-ului șterge **toate** datele- din instanța ta locală — fiecare spațiu de lucru, înregistrare și aplicație. Folosește-o doar după ce- pașii anteriori au eșuat.+ Resetarea mediului local sau a bazei de date de dezvoltare a depozitului tău șterge+ **toate** datele din instanța ta locală, fiecare spațiu de lucru, înregistrare și aplicație. Folosește-o doar+ după ce pașii anteriori au eșuat.</Warning><Note>diff --git a/packages/twenty-docs/ro/developers/extend/apps/operations/testing.mdx b/packages/twenty-docs/ro/developers/extend/apps/operations/testing.mdxindex 9140914a62f..02ce779015b 100644--- a/packages/twenty-docs/ro/developers/extend/apps/operations/testing.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/operations/testing.mdx@@ -176,7 +176,7 @@ Puteți rula și verificarea tipurilor pe aplicație fără a rula testele:twenty app typecheck```-Aceasta rulează `tsc --noEmit` pe fișierul `tsconfig.json` al aplicației și raportează orice erori de tip. Aplicațiile create cu scaffolderul includ, de asemenea, un script `yarn typecheck` care acoperă și fișierele de test (`tsconfig.spec.json`).+Aceasta verifică fișierul `tsconfig.json` al aplicației dvs. cu compilatorul TypeScript instalat, fără a genera fișiere, și raportează orice erori de tip. Aplicațiile create cu scaffolderul includ, de asemenea, un script `yarn typecheck` care acoperă și fișierele de test (`tsconfig.spec.json`).## CI cu GitHub Actionsdiff --git a/packages/twenty-docs/ro/user-guide/calendar-emails/capabilities/calendar.mdx b/packages/twenty-docs/ro/user-guide/calendar-emails/capabilities/calendar.mdxindex 8519a4ddbef..02c87538187 100644--- a/packages/twenty-docs/ro/user-guide/calendar-emails/capabilities/calendar.mdx+++ b/packages/twenty-docs/ro/user-guide/calendar-emails/capabilities/calendar.mdx@@ -15,7 +15,7 @@ Twenty sincronizează automat evenimentele din calendarul dvs. și le leagă de## Fila Calendar-Lângă fila E-mailuri, veți găsi o filă `Calendar` care conține istoricul întâlnirilor programate cu înregistrarea.+Lângă fila Mesaje din înregistrări, veți găsi o filă `Calendar` care conține istoricul întâlnirilor programate cu înregistrarea.### Disponibil pentru@@ -26,7 +26,7 @@ Lângă fila E-mailuri, veți găsi o filă `Calendar` care conține istoricul### Vizualizarea istoricului întâlnirilor1. Navigați la o înregistrare: Accesați înregistrarea oricărei persoane, companii sau oportunități-2. **Selectați fila Calendar**: Faceți clic pe fila `Calendar` lângă fila E-mailuri+2. **Selectați fila Calendar**: Faceți clic pe fila `Calendar` lângă fila Mesaje3. **Răsfoiți istoricul întâlnirilor**: Vizualizați toate întâlnirile programate și detaliile acestora4. **Accesați contextul întâlnirii**: Vizualizați participanții la întâlnire, orele și informațiile conexediff --git a/packages/twenty-docs/ro/user-guide/calendar-emails/capabilities/mailbox.mdx b/packages/twenty-docs/ro/user-guide/calendar-emails/capabilities/mailbox.mdxindex a34aaaf12f7..bb7cffad770 100644--- a/packages/twenty-docs/ro/user-guide/calendar-emails/capabilities/mailbox.mdx+++ b/packages/twenty-docs/ro/user-guide/calendar-emails/capabilities/mailbox.mdx@@ -24,7 +24,7 @@ Conversațiile prin e-mail apar în trei obiecte principale:### Vizualizarea conversațiilor prin e-mail1. Navigați la o înregistrare: Accesați înregistrarea oricărei persoane, companii sau oportunități-2. **Selectați fila E-mailuri**: Faceți clic pe fila `E-mailuri` pentru a vizualiza e-mailurile sincronizate+2. **Selectați fila Mesaje**: Faceți clic pe fila `Messages` pentru a vizualiza e-mailurile sincronizate3. **Deschideți un fir de e-mail**: Faceți clic pe orice e-mail pentru a deschide și a citi întreaga conversație4. **Răsfoiți istoricul**: Derulați prin întregul istoric al e-mailurilor cu acel contactdiff --git a/packages/twenty-docs/ro/user-guide/dashboards/capabilities/widgets.mdx b/packages/twenty-docs/ro/user-guide/dashboards/capabilities/widgets.mdxindex 2453af2b375..2e592031c79 100644--- a/packages/twenty-docs/ro/user-guide/dashboards/capabilities/widgets.mdx+++ b/packages/twenty-docs/ro/user-guide/dashboards/capabilities/widgets.mdx@@ -104,11 +104,13 @@ Afișează proeminent valori cheie unice.Încorporați instrumente externe și conținut extern direct în tabloul de bord.-Pentru telefoane încorporate sau instrumente video, un membru cu permisiunea de a gestiona securitatea poate configura **Settings → General → Security → Embedded website media access**. Adăugați originea HTTPS exactă a site-ului web, cum ar fi `https://workspace.aircall.io`, și activați **Microphone**, **Camera** sau ambele. Căile și metacaracterele nu sunt acceptate. Aprobați numai site-uri web în care aveți încredere.+Pentru widgeturile iframe adăugate în spațiul de lucru, un membru cu permisiunea de a gestiona securitatea poate configura **Setări → General → Securitate → Acces la conținut media de pe site-uri web încorporate**. Adăugați originea HTTPS exactă a site-ului web, cum ar fi `https://workspace.aircall.io`, și activați **Microphone**, **Camera** sau ambele. Căile și metacaracterele nu sunt acceptate. Aprobați numai site-uri web în care aveți încredere.-Reîncărcați filele Twenty deschise după modificarea acestor permisiuni. Reîncărcarea încheie apelurile și înregistrările active. Fiecare membru selectează apoi **Activați microfonul**, **Activați camera**, sau **Activați microfonul și camera** în încorporare și aprobă permisiunea browserului atunci când i se solicită.+Încorporările media furnizate de o aplicație instalată utilizează o aprobare separată: aplicația declară site-ul web în [`requestedIframeMediaPermissions`](/ro/developers/extend/apps/config/application#embedded-website-media-access), iar un membru care poate gestiona aplicațiile îl aprobă în timpul instalării. Aceste acordări se aplică propriilor componente frontale și widgeturi iframe ale aplicației. Aprobările de securitate ale spațiului de lucru și acordările altor aplicații nu se aplică widgeturilor definite de aplicație.-Indicatorul din antet afișează **Acces media activat** cât timp o încorporare are acces, inclusiv atunci când este ascunsă. Aceasta nu înseamnă că site-ul web înregistrează în prezent: Twenty nu poate inspecta activitatea microfonului sau a camerei dintr-un alt site web. Selectați indicatorul și alegeți **Dezactivați** pentru a descărca încorporarea și a o reîncărca cu accesul la media blocat. Reactivarea accesului necesită un alt clic.+Reîncărcați filele Twenty deschise după modificarea acestor permisiuni. Reîncărcarea încheie apelurile și înregistrările active. De fiecare dată când un membru selectează **Activare microfon**, **Activare cameră** sau **Activare microfon și cameră** într-o încorporare, o confirmare nativă a browserului afișează widgetul sau aplicația proprietară, originea site-ului web și accesul solicitat la microfon sau cameră. După confirmare, aprobă permisiunea media a browserului când ți se solicită. Această confirmare se aplică atât widgeturilor din spațiul de lucru, cât și încorporărilor furnizate de aplicație.++Indicatorul din antet afișează **Acces media activat** cât timp o încorporare are acces, inclusiv atunci când este ascunsă. Aceasta nu înseamnă că site-ul web înregistrează în prezent: Twenty nu poate inspecta activitatea microfonului sau a camerei dintr-un alt site web. Selectați indicatorul și alegeți **Dezactivați** pentru a descărca încorporarea și a o reîncărca cu accesul la media blocat. Selectează din nou **Activare** pentru a restabili accesul.<Frame><img src="/images/user-guide/dashboard/dashboard-widget-table.png" alt="Grafic tabele" />