snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/ar/getting-started/core-concepts/ai.mdx

@@ -0,0 +1,34 @@
+---
+title: الذكاء الاصطناعي
+description: كيف يستخدم Twenty الذكاء الاصطناعي لتحسين تجربة الـ CRM لديك.
+icon: robot
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+يقوم Twenty بدمج الذكاء الاصطناعي مباشرة في نظام الـ CRM الخاص بك — ليس كحيلة دعائية، بل كأداة تعمل ضمن نموذج البيانات لديك ونظام الصلاحيات لديك.
+
+## روبوت محادثة بالذكاء الاصطناعي
+
+اطرح أسئلة حول بياناتك باللغة الطبيعية. يمكن لروبوت المحادثة بالذكاء الاصطناعي الاستعلام عن سجلات الـ CRM لديك، وتلخيص المعلومات، ومساعدتك في العثور على ما تبحث عنه دون إنشاء عوامل تصفية معقدة.
+
+<VimeoEmbed videoId="1185511734" title="روبوت محادثة بالذكاء الاصطناعي" />
+
+## وكلاء الذكاء الاصطناعي
+
+وكلاء الذكاء الاصطناعي يتجاوزون حدود المحادثة — بإمكانهم تنفيذ مهام متعددة الخطوات بشكل مستقل:
+
+* إثراء السجلات ببيانات من مصادر خارجية
+* صياغة رسائل المتابعة وإرسالها
+* تحليل صحة مسار المبيعات ووضع علامات على الصفقات المعرّضة للخطر
+* معالجة البيانات الواردة وتوجيهها إلى الفريق المناسب
+
+يعمل الوكلاء ضمن تدفقات العمل الحالية لديك، بحيث يمكنك الجمع بين الذكاء الاصطناعي والموافقات اليدوية، والمنطق الشرطي، واستدعاءات واجهات برمجة التطبيقات الخارجية.
+
+## الصلاحيات والأمان
+
+يحترم الذكاء الاصطناعي في Twenty نموذج الصلاحيات لديك. يمكن للوكلاء الوصول فقط إلى الكائنات والحقول التي يمتلك المستخدم (أو الدور) صلاحية عرضها. تظل البيانات الحساسة محمية حتى عندما يكون الذكاء الاصطناعي مُستخدمًا.
+
+<Card title="دليل الذكاء الاصطناعي الكامل" icon="arrow-right" href="/l/ar/user-guide/ai/overview">
+  مرجع تفصيلي حول روبوت المحادثة، والوكلاء، وضوابط الصلاحيات.
+</Card>

packages/twenty-docs/l/ar/getting-started/core-concepts/apps.mdx

@@ -0,0 +1,41 @@
+---
+title: التطبيقات
+icon: cube
+description: وسّع Twenty باستخدام التعليمات البرمجية — كائنات مخصصة، ومنطق على جانب الخادم، ومكونات واجهة المستخدم، ووكلاء الذكاء الاصطناعي، جميعها كحزم TypeScript.
+---
+
+توفر معظم أدوات إدارة علاقات العملاء (CRM) لك لوحة إعدادات. تمنحك Twenty منصة. التطبيقات هي الطريقة التي يمكّن بها المطوّرون Twenty من تجاوز ما توفره واجهة المستخدم — من خلال تعريف نماذج البيانات، ومنطق جانب الخادم، ومكونات واجهة المستخدم، وإمكانات الذكاء الاصطناعي كتعليمات برمجية، ثم نشرها في مساحة عمل واحدة أو أكثر.
+
+## لماذا توجد التطبيقات
+
+تغطي عمليات سير العمل الأتمتة بدون كود. ولكن بعض الأمور تحتاج إلى كود: محرّك تسعير مخصص، وخط تجميع إثراء مملوك، واختبار امتثال يُشغَّل عند كل تحديث للسجل، ولوحة واجهة مستخدم مخصصة تسحب البيانات من أداة داخلية.
+
+تمكّنك التطبيقات من إنشاء هذه كامتدادات من الدرجة الأولى — ليست نصوصًا هشة تتحدّث إلى واجهة برمجة تطبيقات من الخارج، بل تعليمات برمجية تعمل على المنصة مع وصول كامل إلى نظام الأنواع، ونموذج الأذونات، وواجهة المستخدم.
+
+## ما الذي يمكن للتطبيق أن يعرِّفه
+
+التطبيق هو حزمة TypeScript تُصرِّح عن **كيانات** باستخدام `twenty-sdk`:
+
+| كيان                   | ماذا يفعل                                                                                       |
+| ---------------------- | ----------------------------------------------------------------------------------------------- |
+| **الكائنات والحقول**   | جداول بيانات جديدة وحقول للكائنات الموجودة — تُعامَل بالطريقة نفسها مثل المضمنة افتراضيًا       |
+| **الوظائف المنطقية**   | TypeScript على جانب الخادم يتم تشغيله عبر مسارات HTTP، أو جداول cron، أو أحداث قاعدة البيانات   |
+| **المكوّنات الأمامية** | مكوّنات React معزولة تُعرَض داخل واجهة مستخدم Twenty (اللوحة الجانبية، الودجات، قائمة الأوامر). |
+| **المهارات والوكلاء**  | قدرات الذكاء الاصطناعي — تعليمات قابلة لإعادة الاستخدام ومساعدون مستقلون ذاتيًا                 |
+| **طرق العرض والتنقّل** | طرق عرض قوائم مُعدّة مسبقًا وعناصر قائمة الشريط الجانبي                                         |
+
+يتم اكتشاف كل شيء عبر تحليل AST وقت البناء — بدون ملفات إعداد وبدون روتين تسجيل متكرِّر. ضع `export default defineObject(...)` في أي ملف `.ts` وسيلتقطه الـ SDK.
+
+## كيفية عملها
+
+* **الدوال المنطقية** تُنفَّذ في عمليات Node.js معزولة، ومحمية عن المضيف. تصل إلى البيانات من خلال عميل API مضبوط الأنواع، ومقيَّد بأذونات دور التطبيق.
+* **المكوّنات الأمامية** تعمل ضمن Web Workers باستخدام Remote DOM — معزولة عن الصفحة الرئيسية لكنها تعرض عناصر DOM الأصلية (وليس iframes).
+* **الأذونات** تُطبَّق على مستوى واجهة API. لا يرى التطبيق إلا ما يسمح به دوره.
+
+## تجربة المطوّر
+
+تكتب تطبيقك كمشروع TypeScript على جهازك. تراقب أداة CLI ملفات المصدر لديك وتزامنها مباشرة مع خادم Twenty شغّال — عدِّل ملفًا لترى التغيير في واجهة المستخدم خلال ثانية واحدة. يُعاد توليد عميل API مضبوط الأنواع تلقائيًا عند تغيّر المخطط. عندما تكون مستعدًا، يقوم `yarn twenty app:publish --private` بالدفع إلى خادم إنتاج، أو يقوم `yarn twenty app:publish` بإدراج تطبيقك على npm وسوق Twenty.
+
+<Card title="أنشئ تطبيقك الأول" icon="arrow-right" href="/l/ar/developers/extend/apps/getting-started/quick-start">
+  دليل إرشادي من ثلاث مراحل — الإنشاء الأوّلي، تشغيل خادم محلّي، ومزامنة تغييراتك.
+</Card>

packages/twenty-docs/l/ar/getting-started/core-concepts/calendar-and-email.mdx

@@ -0,0 +1,46 @@
+---
+title: التقويم والبريد الإلكتروني
+description: قم بمزامنة بريدك الإلكتروني وتقويمك مع Twenty.
+icon: envelope
+---
+
+يتكامل Twenty مع أدواتك الحالية بحيث يبقى نظام إدارة علاقات العملاء (CRM) محدَّثًا دون الحاجة إلى إدخال البيانات يدويًا.
+
+## مزامنة البريد الإلكتروني
+
+قم بتوصيل صندوق بريد **Google Workspace** أو **Microsoft 365** الخاص بك. بمجرد الاتصال:
+
+* يتم ربط رسائل البريد الإلكتروني تلقائيًا بسجلات الشركات والأشخاص المطابقة
+* تظهر سلاسل البريد الإلكتروني الكاملة في المخطط الزمني لكل سجل
+* يمكنك إرسال رسائل البريد الإلكتروني مباشرةً من Twenty
+* يتم دعم صناديق بريد متعددة لكل مستخدم
+
+يمكنك التحكّم فيما يتم استيراده — قم بالتصفية حسب النطاق الزمني أو المرسِل لتجنّب جلب رسائل بريد إلكتروني غير ذات صلة.
+
+## مزامنة التقويم
+
+تتم مزامنة أحداث التقويم تلقائيًا من حسابك المتصل. تظهر الأحداث في سجلات نظام إدارة علاقات العملاء (CRM) ذات الصلة، مما يمنحك صورة كاملة عن تفاعلاتك مع كل جهة اتصال أو شركة.
+
+## التكاملات
+
+إضافةً إلى البريد الإلكتروني والتقويم، يتكامل Twenty مع الأدوات الخارجية من خلال:
+
+| طريقة                         | حالة استخدام                                                        |
+| ----------------------------- | ------------------------------------------------------------------- |
+| **API**                       | أنشئ عمليات تكامل مخصّصة باستخدام GraphQL أو REST API               |
+| **خطافات الويب**              | أرسل إشعارات في الوقت الفعلي إلى الأنظمة الخارجية عند تغيّر السجلات |
+| **Zapier**                    | اتصل بأكثر من 5,000 تطبيق بدون كود                                  |
+| **إجراءات HTTP في سير العمل** | استدعِ أي واجهة برمجة تطبيقات خارجية كجزء من سير عمل مؤتمت          |
+
+## تطبيقات مخصّصة
+
+يمكن للمطورين إنشاء تطبيقات متكاملة الإمكانات على Twenty — بإضافة واجهات مستخدم مخصّصة ومنطق على جانب الخادم وعمليات تكامل عميقة. يمكن نشر التطبيقات للمجتمع أو إبقاؤها خاصة.
+
+<CardGroup cols={2}>
+  <Card title="دليل التقويم والبريد الإلكتروني" icon="envelope" href="/l/ar/user-guide/calendar-emails/overview">
+    إعداد مزامنة البريد الإلكتروني، ومزامنة التقويم، وحل المشكلات.
+  </Card>
+  <Card title="واجهة برمجة التطبيقات والملحقات" icon="plug" href="/l/ar/developers/extend/api">
+    أنشئ عمليات تكامل مخصّصة باستخدام واجهة برمجة تطبيقات Twenty.
+  </Card>
+</CardGroup>

packages/twenty-docs/l/ar/getting-started/core-concepts/dashboards.mdx

@@ -0,0 +1,37 @@
+---
+title: لوحات القيادة
+description: تتبّع الأداء واعرض بيانات CRM الخاصة بك بصريًا باستخدام لوحات قيادة مخصصة.
+icon: chart-bar
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+توفر لك لوحات القيادة رؤية في الوقت الفعلي لمؤشرات عملك — صحة مسار المبيعات، أداء الفريق، اتجاهات الإيرادات، وأي شيء آخر تريد تتبّعه.
+
+<VimeoEmbed videoId="1185511768" title="لوحة القيادة" />
+
+## الأدوات
+
+تتكوّن كل لوحة قيادة من أدوات. الأداة هي مخطط واحد أو مقياس واحد مرتبط ببيانات CRM الخاصة بك. يمكنك تكوين:
+
+* **نوع المخطط** — شريطي، خطي، دائري، رقمي، وغير ذلك
+* **مصدر البيانات** — أي كيان في نموذج البيانات لديك (قياسي أو مخصص)
+* **عوامل التصفية** — تضييق النتائج إلى سجلات أو نطاقات زمنية أو شرائح محددة
+* **التجميع** — العد، المجموع، المتوسط، الحد الأدنى، الحد الأقصى لأي حقل رقمي
+* **التجميع حسب** — التفصيل حسب حقول محددة أو تواريخ أو علاقات
+
+## ما الذي يمكنك تتبّعه
+
+* قيمة مسار المبيعات حسب المرحلة
+* الصفقات المُغلقة عبر الزمن
+* متوسط حجم الصفقة حسب المصدر
+* معدلات إكمال المهام
+* مقاييس مخصصة على أي كيان
+
+## المشاركة
+
+لوحات القيادة على مستوى مساحة العمل — يمكن للجميع في فريقك رؤيتها. رتّب الأدوات في تخطيط شبكي وقم بتغيير حجمها لإنشاء العرض الذي يناسب فريقك.
+
+<Card title="دليل لوحات القيادة الكامل" icon="arrow-right" href="/l/ar/user-guide/dashboards/overview">
+  مرجع تفصيلي حول إنشاء لوحات القيادة، وتكوين الأدوات، وإعدادات المخططات.
+</Card>

packages/twenty-docs/l/ar/getting-started/core-concepts/data-model.mdx

@@ -0,0 +1,47 @@
+---
+title: نموذج البيانات
+description: تعرّف على كيفية تنظيم Twenty لبياناتك باستخدام الكائنات والحقول والعلاقات.
+icon: database
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+كل شيء في Twenty مبني حول **الكائنات** و**الحقول** — وهي اللبنات الأساسية لنموذج البيانات لديك.
+
+## كائنات
+
+الكائنات هي الجداول التي تحتفظ ببياناتك. يوفّر Twenty كائنات قياسية جاهزة للاستخدام:
+
+* **Companies** — المؤسسات التي تتعامل معها تجاريًا
+* **People** — جهات الاتصال الفردية
+* **Opportunities** — الصفقات في خط المبيعات لديك
+* **Tasks** — بنود عمل لفريقك
+* **Notes** — نص حر مرتبط بالسجلات
+
+يمكنك أيضًا إنشاء **كائنات مخصّصة** لأي شيء يحتاجه عملك — مثل المشاريع أو تذاكر الدعم أو المنتجات أو العقود أو أي شيء آخر.
+
+## الحقول
+
+الحقول هي الخصائص الموجودة في كل كائن. تدعم Twenty مجموعة واسعة من أنواع الحقول:
+
+| الفئة      | الأنواع                                                                                                   |
+| ---------- | --------------------------------------------------------------------------------------------------------- |
+| **أساسية** | نص، رقم، منطقي (Boolean)، تاريخ، عملة، تقييم، اختيار                                                      |
+| **مركّبة** | عنوان (الشارع، المدينة، الولاية، الرمز البريدي)، الاسم الكامل، الروابط، الهواتف، عناوين البريد الإلكتروني |
+| **خاصة**   | علاقة، مرفق ملف، JSON، الفاعل (من قام بالإنشاء/التعديل)                                                   |
+
+يحصل كل كائن أيضًا على حقول نظام تلقائية: `id`، `createdAt`، `updatedAt`، `createdBy`، و`position`.
+
+## العلاقات
+
+تتصل الكائنات ببعضها البعض من خلال العلاقات. لدى الشركة العديد من الأشخاص، وتنتمي الفرصة إلى شركة، وهكذا. يمكنك إنشاء علاقات مخصّصة بين أي كائنات، بما في ذلك العلاقات من نوع متعدد إلى متعدد.
+
+## ما الذي يجعل هذا قويًا
+
+على عكس أنظمة إدارة علاقات العملاء (CRM) التقليدية حيث تكون مقيّدًا بحقول محددة مسبقًا على كائنات محددة مسبقًا، يتيح لك Twenty نمذجة بياناتك بالطريقة نفسها التي يعمل بها نشاطك التجاري بالضبط. تحصل الكائنات المخصّصة على نفس المعاملة من الدرجة الأولى مثل الكائنات المضمّنة — بما في ذلك نقاط نهاية واجهة برمجة التطبيقات (API endpoints)، وطرق العرض، والأذونات، ومشغلات سير العمل.
+
+<Card title="تعرف بعمق على نموذج البيانات" icon="arrow-right" href="/l/ar/user-guide/data-model/overview">
+  مرجع كامل للكائنات والحقول والعلاقات وكيفية تهيئتها.
+</Card>
+
+<VimeoEmbed videoId="1185511827" title="نموذج البيانات" />

packages/twenty-docs/l/ar/getting-started/core-concepts/glossary.mdx

@@ -0,0 +1,105 @@
+---
+title: مسرد المصطلحات
+icon: book
+description: المصطلحات الأساسية المستخدمة في Twenty.
+---
+
+## واجهة برمجة التطبيقات
+
+واجهة برمجة التطبيقات (API) تتيح لك ربط Twenty بأنظمة برمجية أخرى وبناء تكاملات مخصصة.
+
+## التطبيقات
+
+التطبيقات هي امتدادات مخصّصة مُنشأة على شكل شيفرة يمكنها تعريف نماذج البيانات والوظائف المنطقية. تمكّن المطورين من إنشاء تخصيصات قابلة لإعادة الاستخدام يمكن نشرها عبر مساحات عمل متعددة.
+
+## إجراءات الكود
+
+إجراءات الكود هي خطوات في سير العمل تتيح لك كتابة شيفرة JavaScript مخصصة لتحويل البيانات أو إجراء حسابات أو تنفيذ منطق معقد غير ممكن بالإجراءات المضمنة.
+
+## قائمة الأوامر
+
+قائمة الأوامر هي واجهة وصول سريع (تُفتح باستخدام `Cmd + K` على Mac و `Ctrl + K` على Windows) تتيح لك تنفيذ الإجراءات وإنشاء السجلات والتنقل بكفاءة في مساحة العمل الخاصة بك.
+
+## الشركات والأشخاص
+
+يتضمن نظام إدارة علاقات العملاء نوعين أساسيين من السجلات:
+
+* تمثل `الشركة` عملاً تجارياً أو منظمة.
+* `People` تمثل العملاء الحاليين والمحتملين لشركتك.
+
+## الحقول المخصصة
+
+الحقول المخصصة هي حقول بيانات تُنشئها لالتقاط معلومات خاصة باحتياجات وعمليات عملك.
+
+## نموذج البيانات
+
+نموذج البيانات هو الهيكل الذي يحدد كيفية تنظيم المعلومات في نظام إدارة علاقات العملاء الخاص بك، بما في ذلك الكائنات الموجودة وخصائصها وعلاقاتها معًا.
+
+## المفضلات
+
+المفضلات هي السجلات التي قمت بتحديدها للوصول السريع، وتظهر في الشريط الجانبي للتنقل الفوري للبيانات الهامة.
+
+## الحقل
+
+الحقل يشير إلى منطقة معينة يتم فيها تخزين بيانات محددة لكيان معين.
+
+## مكرر
+
+المكرر هو إجراء في سير العمل يتكرر عبر مصفوفة من العناصر، وينفذ الإجراءات اللاحقة لكل عنصر في القائمة.
+
+## كانبان
+
+الـ`كانبان` هو طريقة بصرية لمتابعة عمليات الأعمال باستخدام البطاقات والأعمدة. يمثّل كل عمود مرحلة في عمليتك (مثل: جديد، جارٍ، ربح، خسارة)، وتحرّك السجلات عبر هذه المراحل مع تقدّمها.
+
+## كائن
+
+الكائن هو هيكل بيانات يمثل نوعاً معيناً من الكيانات في نظام إدارة علاقات العملاء الخاص بك (مثل الأشخاص أو الشركات أو الفرص). يمكن أن تكون الكائنات قياسية (مدمجة) أو مخصصة (تم إنشاؤها بواسطتك).
+
+## الفرص
+
+الفرص في نظام Twenty لإدارة علاقات العملاء هي صفقات أو مبيعات محتملة مع الحسابات أو جهات الاتصال.
+
+## السجل
+
+السجل يشير إلى مثيل لكائن، مثل حساب معين أو جهة اتصال.
+
+## حقول العلاقات
+
+تُنشئ حقول العلاقات الروابط بين الكائنات المختلفة، مما يتيح لك ربط السجلات معًا (مثل ربط شخص بشركة).
+
+## الحقول القياسية
+
+الحقول القياسية هي حقول بيانات مدمجة تأتي مع الكائنات بشكل افتراضي وتوفر وظائف شائعة في جميع مساحات العمل.
+
+## المهام
+
+المهام في Twenty CRM هي أنشطة مُسندة تتعلق بجهات اتصال أو حسابات أو فرص.
+
+## المشغلات
+
+المشغلات هي نقطة البداية في سير العمل — الحدث أو الشرط الذي يبدأ الأتمتة. تشمل الأمثلة إنشاء السجلات، وتحديث السجلات، وخطافات الويب، أو الأوقات المجدولة.
+
+## العروض
+
+يمكنك تخصيص عرض سجلاتك باستخدام العروض، وتعيين عوامل تصفية مختلفة وتخطيطات وخيارات فرز لكل عرض.
+
+## Upsert
+
+Upsert هي عملية تجمع بين "update" و"insert" — فهي تحدّث سجلاً موجوداً إذا تم العثور على تطابق، أو تنشئ سجلاً جديداً إذا لم يوجد تطابق.
+
+## خطافات الويب
+
+خطافات الويب هي رسائل آلية ترسل من Twenty إلى تطبيقات أخرى عند حدوث أحداث معينة، مما يتيح مزامنة البيانات في الوقت الفعلي.
+
+## مسارات العمل
+
+مسارات العمل هي عمليات مؤتمتة تطلق إجراءات بناءً على شروط محددة، مما يساعدك على أتمتة المهام المتكررة والعمليات التجارية.
+
+## مساحة العمل
+
+`مساحة العمل` تمثل عادةً شركة تستخدم Twenty. تحتوي على جميع السجلات والبيانات التي تدخلها أنت وأعضاء فريقك إلى Twenty.
+لها اسم نطاق واحد، وهو عادةً الاسم الذي تستخدمه شركتك لعناوين البريد الإلكتروني للموظفين.
+
+## أعضاء مساحة العمل
+
+أعضاء مساحة العمل هم مستخدمو Twenty من فريقك الذين لديهم حق الوصول إلى مساحة العمل الخاصة بك. يمكن تعيينهم كمالكين أو معينين للسجلات.

packages/twenty-docs/l/ar/getting-started/core-concepts/layout.mdx

@@ -0,0 +1,74 @@
+---
+title: التخطيط
+description: كيفية التنقل والتصفح وعرض السجلات في Twenty.
+icon: table-columns
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## التصميم الرئيسي
+
+مركز الشاشة هو المكان الذي تتواجد فيه سجلاتك — الأشخاص، الشركات، الفرص، المهام، الملاحظات، لوحات المعلومات، سير العمل، وأي كائنات مخصّصة. يمكنك هنا عرض السجلات وتحريرها وحذفها، وإنشاء عروض جديدة.
+
+<img src="/images/user-guide/home/main-layout.png" style={{width:'100%'}} />
+
+## شريط التنقل
+
+يوفر لك الشريط الجانبي الأيسر:
+
+* **مبدّل مساحة العمل** — التبديل بين مساحات العمل أو إنشاء مساحة جديدة (القائمة المنسدلة العلوية)
+* **البحث** — اضغط على `/` للتركيز فورًا، يجري البحث عبر جميع الكائنات
+* **الإعدادات** — الوصول إليها من الأعلى يسارًا
+* **المفضّلات** — عروض مثبّتة، فريدة لكل مستخدم
+* **اختصارات الكائنات** — وصول سريع إلى الأشخاص والشركات والفرص، إلخ.
+* **سير العمل** — إنشاء أتمتة
+
+اسحب العناصر لإعادة ترتيبها، وأنشئ مجلدات لتجميع الكائنات ذات الصلة، وأخفِ ما لا تستخدمه.
+
+<img src="/images/user-guide/home/navigation-bar.png" style={{width:'100%'}} />
+
+## قائمة الأوامر
+
+اضغط على `Cmd+K` (Mac) أو `Ctrl+K` (Windows) — أو انقر على النقاط الثلاث في الأعلى يمينًا. من هنا يمكنك:
+
+* إنشاء سجلات جديدة
+* استيراد وتصدير البيانات عبر CSV
+* إنشاء عروض جديدة
+* الوصول إلى السجلات المحذوفة (يدعم Twenty عمليات الحذف المنطقي والدائم)
+* عرض اختصارات لوحة المفاتيح للتنقل في مساحة العمل الخاصة بك
+
+<img src="/images/user-guide/home/command-menu.png" style={{width:'100%'}} />
+
+## بحث
+
+يمكن الوصول إليه عبر قائمة الأوامر، ومن أعلى شريط التنقل، أو بالضغط على `/`. يعمل البحث عبر جميع الكائنات.
+
+<img src="/images/user-guide/home/search-bar.png" style={{width:'100%'}} />
+
+## اللوحة الجانبية
+
+انقر على سجل لفتح اللوحة الجانبية على اليمين — نظرة سريعة على المعلومات الرئيسية للسجل بدون مغادرة الصفحة الحالية. انقر على **Open** للانتقال إلى صفحة السجل الكاملة.
+
+<img src="/images/user-guide/home/side-panel.png" style={{width:'100%'}} />
+
+## العروض
+
+يدعم كل كائن عروضًا متعددة — بدون حد لكل كائن. استخدم القائمة المنسدلة في الأعلى يسارًا للتبديل بينها.
+
+* **الجدول** — صفوف وأعمدة بأسلوب جداول البيانات، مع التجميع والتحرير المضمَّن وتخصيص الأعمدة
+* **كانبان** — بطاقات يمكن سحبها وإفلاتها منظَّمة حسب حقل محدد، مثالية لمسارات العمل
+* **التقويم** — سجلات موزَّعة حسب حقل تاريخ للتخطيط القائم على الوقت
+
+يحفظ كل عرض عوامل التصفية والفرز وظهور الحقول الخاصة به. شارك العروض مع مساحة العمل الخاصة بك أو احتفظ بها خاصة. اجعل العروض مفضّلة للوصول السريع من الشريط الجانبي.
+
+<img src="/images/user-guide/home/view-menu.png" style={{width:'100%'}} />
+
+## صفحات السجل
+
+عند فتح سجل، تتكوّن صفحة التفاصيل من **علامات تبويب** و**عناصر واجهة** قابلة للتهيئة. أضف عناصر الواجهة واحذفها وأعد ترتيبها وغيّر حجمها ضمن شبكة — الحقول، السجلات ذات الصلة، رسائل البريد الإلكتروني، الخط الزمني، المهام، الملاحظات، الملفات، الرسوم البيانية، iframes، وغير ذلك. لكل نوع كائن تصميمه الخاص.
+
+<Card title="دليل التصميم الكامل" icon="arrow-right" href="/l/ar/user-guide/layout/overview">
+  التنقل والعروض وصفحات السجلات — مرجع تفصيلي وأدلة كيفية التنفيذ.
+</Card>
+
+<VimeoEmbed videoId="1185511790" title="التخطيط" />

packages/twenty-docs/l/ar/getting-started/core-concepts/workflows.mdx

@@ -0,0 +1,55 @@
+---
+title: مسارات العمل
+description: قم بأتمتة عمليات عملك باستخدام أداة إنشاء مسارات العمل المرئية الخاصة بـ Twenty.
+icon: bolt
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+تتيح لك مسارات العمل أتمتة المهام المتكررة وربط Twenty بأدوات خارجية — دون كتابة كود (ويمكنك ذلك إن أردت).
+
+<VimeoEmbed videoId="1185511711" title="سير العمل" />
+
+## كيف تعمل مسارات العمل
+
+كل سير عمل يتكون من ثلاثة أجزاء:
+
+1. **المشغّل (Trigger)** — ما يبدأ سير العمل
+2. **الخطوات (Steps)** — ما يحدث لاحقًا (إجراء واحد أو أكثر بالتسلسل)
+3. **المتغيرات (Variables)** — البيانات التي تتدفق بين الخطوات
+
+## المشغلات
+
+| المشغّل                      | متى يتم تشغيله                                                                  |
+| ---------------------------- | ------------------------------------------------------------------------------- |
+| **حدث السجل (Record event)** | يتم إنشاء سجل أو تحديثه أو حذفه أو إجراء إدراج/تحديث (Upsert) له                |
+| **يدوي**                     | ينقر المستخدم على زر (على سجل واحد أو سجلات متعددة أو على مستوى النظام بالكامل) |
+| **الجدول الزمني**            | على فاصل زمني متكرر (بصيغة cron)                                                |
+| **الويب هوك**                | نظام خارجي يرسل طلب HTTP POST                                                   |
+
+## الإجراءات
+
+يمكن لمسارات العمل ربط أي مجموعة من العناصر التالية:
+
+* **عمليات السجل (Record operations)** — إنشاء السجلات أو تحديثها أو البحث عنها أو حذفها أو إجراء إدراج/تحديث لها
+* **إرسال بريد إلكتروني (Send email)** — إرسال رسائل البريد الإلكتروني أو إعداد مسودات منها من الحسابات المتصلة
+* **طلب HTTP (HTTP request)** — استدعاء أي واجهة برمجة تطبيقات خارجية
+* **الكود (Code)** — تشغيل JavaScript مخصص من أجل منطق معقد
+* **التفرعات (Branches)** — شروط If/else لتقسيم مسار سير العمل
+* **Iterator** — التكرار عبر المصفوفات من البيانات
+* **وكيل ذكاء اصطناعي (AI Agent)** — تمكين وكيل ذكاء اصطناعي من معالجة البيانات بشكل مستقل
+* **التأخير (Delay)** — الانتظار قبل المتابعة
+* **النموذج (Form)** — جمع مدخلات المستخدم في منتصف سير العمل
+
+## ما الذي يمكنك بناؤه
+
+* إرسال تنبيهات Slack عند وصول صفقة إلى مرحلة معينة
+* إثراء جهات الاتصال الجديدة تلقائيًا ببيانات من واجهات برمجة تطبيقات خارجية
+* اكتشاف الفرص الراكدة وإخطار المالك
+* مزامنة البيانات بين Twenty ونظام الفوترة لديك
+* إنشاء ملفات PDF أو فواتير من بيانات السجل
+* الرد تلقائيًا على رسائل البريد الإلكتروني الواردة التي تطابق معايير معينة
+
+<Card title="دليل مسارات العمل الكامل" icon="arrow-right" href="/l/ar/user-guide/workflows/overview">
+  مرجع تفصيلي حول المشغلات والإجراءات والمتغيرات ووصفات الأتمتة في العالم الحقيقي.
+</Card>

packages/twenty-docs/l/ar/getting-started/introduction.mdx

@@ -0,0 +1,66 @@
+---
+title: لماذا Twenty
+icon: heart
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+كنتَ دائمًا تختار بين برمجيات يسهل البدء بها لكن يستحيل تغييرها، وبين برمجيات مرنة لكنها تتطلب أشهرًا لإعدادها. Twenty هو الخيار الثالث: **نظام إدارة علاقات العملاء جاهز للإنتاج يمكنك إعادة تشكيله أثناء الاستخدام.**
+
+## ما الذي يجعل Twenty مختلفًا
+
+Twenty هو منصة يمكنك البناء عليها، وليس منتجًا تقوم فقط بتهيئته.
+
+<CardGroup cols={2}>
+  <Card img="/images/user-guide/halftone/ai.png">
+    <CardTitle>مصمَّم للوكلاء</CardTitle>
+    يعمل الوكلاء داخل نموذج بياناتك مع صلاحيات حقيقية. مهارات، أدوات، MCP.
+  </Card>
+  <Card img="/images/user-guide/halftone/permissions.png">
+    <CardTitle>قابلية توسعة مؤمّنة</CardTitle>
+    مرونة أدوات مبرمجة على أسس مؤمّنة.
+  </Card>
+  <Card img="/images/user-guide/halftone/dev-api.png">
+    <CardTitle>حزمة تقنية حديثة</CardTitle>
+    React، TypeScript. فريقك يعرف بالفعل كيفية توسيع Twenty. لا لغات احتكارية، ولا حجب للوصول.
+  </Card>
+  <Card img="/images/user-guide/halftone/dev-self-host.png">
+    <CardTitle>بدون قيود</CardTitle>
+    نواة مفتوحة المصدر، وقابلية للاستضافة الذاتية، وإمكانية تصدير بياناتك في أي وقت.
+  </Card>
+</CardGroup>
+
+## لمن صُمِّم Twenty
+
+* **المؤسسات الكبرى التي تستبدل Salesforce** — فريقك يقضي وقتًا أطول في مقاومة الأداة بدلًا من استخدامها.
+  تشعر بأنك مقيّد بها والتكاليف تستمر في الارتفاع.
+* **الشركات الناشئة ذات المؤسسين التقنيين** — لقد تجاوزتم مرحلة جداول البيانات وNotion. لديكم طموحات كبيرة وتريدون
+  نظام إدارة علاقات العملاء يتوسع معكم.
+* **فرق الدخول إلى السوق الباحثة عن ميزة تنافسية** — تريدون بناء نظام التصنيف الخاص بكم للعملاء المحتملين، ومنظومة الإثراء الخاصة بكم، وتدفّقات العمل الخارجية الخاصة بكم.
+* **المنظمات الحريصة على الخصوصية** — تحتاجون إلى
+  الاستضافة الذاتية وامتلاك بياناتكم من البداية إلى النهاية. بدافع المتطلبات التنظيمية،
+  أو التعاقدية، أو حتى المبدئية فقط.
+* **شركاء Salesforce** —
+  مطوّروكم سئموا من عرض زيادات تكاليف التراخيص على عملائكم.
+  تريدون تجربة تطوير أفضل، وتسليم المشاريع بشكل أسرع وبتكلفة تراخيص أقل لعملائكم.
+* **وكالات تطوير الويب** — فريقكم يعرف TypeScript، وReact،
+  وPostgreSQL. يفتح Twenty سوق أنظمة إدارة علاقات العملاء
+  أمامكم دون الحاجة إلى تعلّم APEX أو الحصول على شهادات احتكارية.
+
+## لمن لا يناسبه Twenty
+
+* **الفرق التي تريد نظام إدارة علاقات عملاء لا تحتاج أبدًا إلى التفكير فيه.** يكافئ Twenty الفرق التي تريد البقاء قريبة من أدواتها وتشكيلها بمرور الوقت. إذا كنتم تريدون
+  شيئًا مُدارًا بالكامل، فسيخدمكم Pipedrive أو
+  HubSpot جيدًا.
+* **الشركات التي تحتاج اليوم إلى مئات التكاملات الجاهزة مسبقًا.** نظامنا البيئي ينمو بسرعة، لكنه ليس بعد
+  بالاتساع نفسه الذي لدى Salesforce أو HubSpot. إذا كنتم مرتاحين
+  لبناء ما هو مفقود، فستحبونه. وإن لم تكونوا كذلك، امنحونا
+  عامًا آخر.
+* **المنظمات التي تُختار فيها الأدوات في غرف الاجتماعات،
+  وليس من قِبل الأشخاص الذين يستخدمونها.** لا نقوم بعشاءات فاخرة
+  ولا جلسات إحاطة تنفيذية. نحن ننجح مع الفرق التي لديها
+  صلاحية اختيار أدواتها الخاصة.
+
+<Card title="هل أنتم مستعدون للبدء؟" icon="rocket" href="/l/ar/getting-started/quickstart">
+  اضبط إعدادات Twenty في أقل من 5 دقائق — على السحابة أو بالاستضافة الذاتية.
+</Card>

packages/twenty-docs/l/ar/getting-started/key-features.mdx

@@ -0,0 +1,70 @@
+---
+title: الميزات الرئيسية
+description: جولة في كل ما يمكن أن يقدمه Twenty — بدءًا من نماذج البيانات المخصصة وصولًا إلى الأتمتة المدعومة بالذكاء الاصطناعي.
+icon: star
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Twenty هي منصة إدارة علاقات العملاء (CRM) متكاملة المزايا. إليك ما يمكنك بناؤه باستخدامه.
+
+<CardGroup cols={2}>
+  <Card href="/l/ar/user-guide/data-model/overview" img="/images/user-guide/halftone/data-model.png">
+    <CardTitle>نموذج بيانات مخصص</CardTitle>
+    عرّف هيكل البيانات الدقيق الذي يحتاجه عملك.
+    <br />أنشئ كائنات مخصصة، وأضف حقولًا مخصصة مع أكثر من 20 نوعًا من الحقول، وأنشئ علاقات بين أي كائنات.
+  </Card>
+
+  <Card href="/l/ar/user-guide/views-pipelines/overview" img="/images/user-guide/halftone/layout.png">
+    <CardTitle>طرق العرض والمسارات</CardTitle>
+    بدّل بين طرق عرض الجدول، ولوحات كانبان، وطرق عرض التقويم.
+    <br />قم بالتصفية باستخدام منطق AND/OR، ورتّب حسب عدة حقول، واجمع السجلات، واحفظ طرق عرض مخصصة.
+  </Card>
+
+  <Card href="/l/ar/user-guide/workflows/overview" img="/images/user-guide/halftone/workflows.png">
+    <CardTitle>سير العمل والأتمتة</CardTitle>
+    أتمت أي عملية عمل دون كتابة شفرة برمجية.
+    <br />قم بتشغيل سير العمل عند تغيّر السجلات، أو وفق الجداول الزمنية، أو الإجراءات اليدوية، أو خطافات الويب الواردة.
+  </Card>
+
+  <Card href="/l/ar/user-guide/calendar-emails/overview" img="/images/user-guide/halftone/calendar-emails.png">
+    <CardTitle>مزامنة التقويم والبريد الإلكتروني</CardTitle>
+    اربط حساب Google Workspace أو Microsoft 365 الخاص بك.
+    <br />تظهر رسائل البريد الإلكتروني وأحداث التقويم تلقائيًا على سجلات إدارة علاقات العملاء (CRM) ذات الصلة.
+  </Card>
+
+  <Card href="/l/ar/user-guide/ai/overview" img="/images/user-guide/halftone/ai.png">
+    <CardTitle>الذكاء الاصطناعي</CardTitle>
+    وكلاء ذكاء اصطناعي يعملون بشكل مستقل داخل نظام إدارة علاقات العملاء (CRM) — يجيبون عن الأسئلة، ويُثْرون السجلات، وينفّذون مهام متعددة الخطوات ضمن نموذج الأذونات الخاص بك.
+  </Card>
+
+  <Card href="/l/ar/user-guide/dashboards/overview" img="/images/user-guide/halftone/dashboards.png">
+    <CardTitle>لوحات المعلومات والتقارير</CardTitle>
+    أنشئ لوحات معلومات مخصصة باستخدام عناصر واجهة في الوقت الفعلي.
+    <br />تتبّع مقاييس المسار، وأداء الفريق، ومؤشرات الأداء الرئيسية للأعمال باستخدام مخططات وعوامل تصفية قابلة للتهيئة.
+  </Card>
+
+  <Card href="/l/ar/user-guide/permissions-access/overview" img="/images/user-guide/halftone/permissions.png">
+    <CardTitle>الصلاحيات والتحكم في الوصول</CardTitle>
+    تحكم في الوصول قائم على الأدوار على كل المستويات — الكائنات والحقول والسجلات الفردية.
+    <br />قم بتهيئة تسجيل الدخول الأحادي (SSO) باستخدام SAML أو OIDC. سجلات التدقيق تتعقّب من فعل ماذا.
+  </Card>
+
+  <Card href="/l/ar/developers/extend/api" img="/images/user-guide/halftone/dev-api.png">
+    <CardTitle>واجهة برمجة التطبيقات (API) وقابلية التوسّع</CardTitle>
+    واجهة برمجة تطبيقات موجّهة للمطورين تتكيّف مع نموذج البيانات المخصص لديك.
+    <br />نقاط نهاية GraphQL وREST معًا، مع توثيق يتم إنشاؤه تلقائيًا لكل مساحة عمل.
+  </Card>
+
+  <Card href="/l/ar/user-guide/data-migration/overview" img="/images/user-guide/halftone/data-migration.png">
+    <CardTitle>استيراد البيانات وتصديرها</CardTitle>
+    استورد البيانات من ملفات CSV أو عبر واجهة برمجة التطبيقات (API).
+    <br />تعيين الحقول، واكتشاف التكرار، والتعامل مع الأخطاء مدمجة في النظام. صدّر بياناتك في أي وقت — بدون أي قيود ارتباط بمنصة واحدة.
+  </Card>
+
+  <Card href="/l/ar/developers/self-host/self-host" img="/images/user-guide/halftone/dev-self-host.png">
+    <CardTitle>الاستضافة الذاتية</CardTitle>
+    شغّل Twenty على بنيتك التحتية الخاصة باستخدام أمر Docker Compose واحد.
+    <br />تحكّم كامل في بياناتك، وتحديثات وفق الجدول الزمني الذي يناسبك.
+  </Card>
+</CardGroup>

packages/twenty-docs/l/ar/getting-started/quickstart.mdx

@@ -0,0 +1,73 @@
+---
+title: البدء السريع
+description: شغّل Twenty في أقل من 5 دقائق — على السحابة أو بالاستضافة الذاتية.
+icon: play
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## التسجيل
+
+<Steps>
+  <Step title="أنشئ حسابك">
+    انتقل إلى [app.twenty.com](https://app.twenty.com) وسجِّل باستخدام Google أو Microsoft أو البريد الإلكتروني.
+  </Step>
+  <Step title="اختر فترة تجربة">
+    اختر **30 يومًا** (مع بطاقة) أو **7 أيام** (بدون بطاقة). كلتاهما تتضمنان وصولًا كاملاً — عدد غير محدود من جهات الاتصال، تكامل البريد الإلكتروني، الكائنات المخصصة، وواجهة برمجة التطبيقات (API). يمكنك تغيير الخطة أو فترة الفوترة في أي وقت.
+  </Step>
+  <Step title="إنشاء مساحة العمل الخاصة بك">
+    بعد تأكيد الدفع عبر Stripe، ستقوم بإعداد اسم مساحة العمل والملف الشخصي للمستخدم. يمكنك الإلغاء في أي وقت.
+  </Step>
+</Steps>
+
+<VimeoEmbed videoId="1185227242" title="إنشاء مساحة عمل" />
+
+## تهيئة مساحة عملك
+
+بمجرد دخولك، هناك ثلاث خطوات لتجعل Twenty ملكك:
+
+### ١. قم بتوصيل بريدك الإلكتروني
+
+انتقل إلى **الإعدادات → الحسابات** وقم بتوصيل حساب Google أو Microsoft الخاص بك. سيقوم Twenty باستيراد رسائل البريد الإلكتروني وفعاليات التقويم، وإنشاء جهات اتصال تلقائيًا من التفاعلات. هل تستخدم موفرًا آخر؟ يمكنك إضافة صناديق البريد عبر SMTP أو التقويمات عبر CalDAV من نفس الصفحة.
+
+<Note>ابدأ من هنا — توصيل صندوق بريد يمنح فريقك قيمة فورية من بيانات حقيقية قبل تخصيص أي شيء آخر.</Note>
+
+<VimeoEmbed videoId="1185416821" title="قم بتوصيل بريدك الإلكتروني" />
+
+### ٢. شكِّل نموذج بياناتك
+
+انتقل إلى **الإعدادات → نموذج البيانات** لإنشاء الكائنات والحقول المخصصة. بعض الأمور التي يجب معرفتها:
+
+* الكائنات والحقول المخصصة **غير محدودة في جميع الخطط** — بدون بيع إضافي.
+* **الأشخاص، الشركات، والفرص** هي الكائنات التي تعرض رسائل البريد الإلكتروني والاجتماعات المتزامنة. استخدمها كأساس لديك وأضِف حقولًا لتصنيفها (مثلاً، حقل `Person Type`) بدلًا من إنشاء كائنات منفصلة لن تحتوي على سجل بالبريد الإلكتروني.
+* لا يمكن أن يشترك شخصان في نفس عنوان البريد الإلكتروني. لا يمكن أن تشترك شركتان في نفس النطاق.
+* يمكنك إلغاء تنشيط الحقول/الكائنات القياسية التي لا تحتاجها، وإخفاء الحقول من طرق العرض دون حذفها.
+
+[مرجع نموذج البيانات →](/l/ar/user-guide/data-model/overview)
+
+<VimeoEmbed videoId="1185416793" title="شكِّل نموذج بياناتك" />
+
+### ٣. استيراد بياناتك
+
+استخدم قائمة الأوامر (`Cmd+K` / `Ctrl+K`) لاستيراد الأشخاص، الشركات، الفرص، أو أي كائن مخصص عبر CSV. قم بتنزيل الملف النموذجي أولًا للاطلاع على التنسيق المتوقع. احصر الملفات في 10 آلاف سجل وأزل التكرار عن عناوين البريد الإلكتروني/النطاقات قبل الاستيراد.
+
+[دليل ترحيل البيانات →](/l/ar/user-guide/data-migration/overview)
+
+<VimeoEmbed videoId="1185416775" title="استيراد بياناتك" />
+
+## الخطوات التالية
+
+<CardGroup cols={2}>
+  <Card title="تعرّف على التخطيط" icon="table-columns" href="/l/ar/getting-started/core-concepts/layout">
+    التنقّل، العروض، قائمة الأوامر، اللوحة الجانبية.
+  </Card>
+  <Card title="إنشاء سير العمل" icon="bolt" href="/l/ar/user-guide/workflows/overview">
+    أتمِت عملياتك التجارية.
+  </Card>
+  <Card title="إنشاء العروض" icon="table" href="/l/ar/user-guide/layout/overview">
+    جدول، كانبان، تقويم — قم بتصفية بياناتك وفرزها.
+  </Card>
+  <Card title="استكشف واجهة برمجة التطبيقات (API)" icon="plug" href="/l/ar/developers/extend/api">
+    مخطط لكل مستأجر عبر REST و GraphQL.
+  </Card>
+</CardGroup>