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

packages/twenty-docs/l/ar/user-guide/data-migration/capabilities/error-handling.mdx

@@ -0,0 +1,76 @@
+---
+title: التعامل مع الأخطاء والتحقّق
+description: راجع وأصلِح أخطاء الاستيراد مباشرةً في واجهة المستخدم قبل التأكيد.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## التحقّق قبل الاستيراد
+
+بعد رفع ملفك وتعيين الحقول، تتحقّق Twenty من بياناتك **قبل** الاستيراد. يتيح لك ذلك اكتشاف الأخطاء وإصلاحها من دون التأثير في بياناتك الحالية.
+
+## كيف يعمل
+
+1. **ارفع** ملف CSV الخاص بك
+2. **طابِق** أعمدتك مع حقول Twenty
+3. **راجِع** الأخطاء المحتملة المميّزة باللون الأصفر
+4. **أصلِح الأخطاء** مباشرةً في واجهة المستخدم
+5. **أكِّد** عملية الاستيراد
+
+<VimeoEmbed videoId="1145273857" title="عرض توضيحي بالفيديو" />
+
+## عرض الأخطاء
+
+يتم تمييز الصفوف التي تحتوي على مشكلات باللون **الأصفر**. يمكنك:
+
+* **حرِّر الخلية مباشرةً** لإصلاح الخطأ
+* **أزل الصف** لتجاوزه بالكامل
+
+يوفّر هذا التحرير المضمَّن الوقت — لا حاجة للعودة إلى جدول البيانات، وإصلاح الأخطاء، وإعادة الرفع.
+
+## أنواع الأخطاء الشائعة
+
+### قيم مكرّرة
+
+**السبب**: حقل فريد (البريد الإلكتروني، النطاق) موجود مسبقًا في Twenty أو يظهر مرتين في ملفك.
+
+**الإصلاح**:
+
+* حرِّر القيمة المكرّرة في واجهة مستخدم الاستيراد
+* أزل أحد الصفوف المكرّرة
+
+راجع [قيود التفرّد](/l/ar/user-guide/data-migration/capabilities/uniqueness-constraints) لمزيد من التفاصيل حول كيفية فرض التفرّد.
+
+### تنسيق غير صالح
+
+**السبب**: لا تتطابق البيانات مع التنسيق المتوقع (مثل: بريد إلكتروني غير صالح، تنسيق تاريخ غير صحيح).
+
+**الإصلاح**: حرِّر الخلية لاستخدام التنسيق الصحيح.
+
+راجع [تعيين الحقول](/l/ar/user-guide/data-migration/capabilities/field-mapping) لمعرفة التنسيق المتوقع لكل نوع من الحقول.
+
+### حقول مطلوبة مفقودة
+
+**السبب**: حقل مطلوب فارغ.
+
+**الإصلاح**: أدخِل قيمة في الحقل المطلوب أو أزل الصف.
+
+### العلاقة غير موجودة
+
+**السبب**: السجل المشار إليه غير موجود (مثل: نطاق شركة لم يتم استيراده).
+
+**الإصلاح**:
+
+* استورِد سجلات الأصل أولًا
+* أو صحِّح قيمة المرجع
+
+راجع [استيراد العلاقات](/l/ar/user-guide/data-migration/capabilities/import-relations) لمعرفة ترتيب الاستيراد الصحيح وكيفية ربط السجلات.
+
+## نصائح لتقليل الأخطاء
+
+1. **تنزيل القالب** لرؤية التنسيق المتوقع قبل استيراد الملف الخاص بك
+2. **نظِّف بياناتك** في جدول البيانات أولًا
+3. **استورِد الملفات بالترتيب الصحيح** لاستيراد العلاقات (الشركات → الأشخاص → الفرص)
+4. **اختبر بدُفعات صغيرة** قبل الاستيراد الكامل
+5. **تحقّق من التكرارات** قبل الرفع
+6. **الحد من كل ملف إلى 10,000 سجلا**

packages/twenty-docs/l/ar/user-guide/data-migration/capabilities/field-mapping.mdx

@@ -0,0 +1,198 @@
+---
+title: تعيين الحقول
+description: كيف يعمل تعيين الحقول أثناء استيراد البيانات.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## كيف يعمل تعيين الحقول
+
+عند تحميل ملف، يقوم Twenty بتحليل أعمدتك ومحاولة مطابقتها مع الحقول الموجودة.
+
+### التعيين التلقائي
+
+يحاول Twenty مطابقة الأعمدة استنادًا إلى:
+
+* أسماء رؤوس الأعمدة (مطابقات دقيقة أو متشابهة)
+* اكتشاف نوع البيانات (تواريخ، أرقام، عناوين بريد إلكتروني)
+* أنماط الحقول الشائعة
+
+<Note>**نصيحة سريعة:** صدِّر بضعة صفوف من الكائن الذي تريد استيراده. سيحتوي الملف المصدَّر على أسماء الأعمدة الدقيقة التي يتوقعها Twenty، مما يجعل التعيين التلقائي سلسًا أثناء الاستيراد.</Note>
+
+### خيارات التعيين اليدوي
+
+لكل عمود، يمكنك:
+
+* **تعيين إلى حقل**: اختر الحقل المطابق في Twenty من قائمة منسدلة
+* **عدم التعيين**: تخطَّ العمود بالكامل (لن يتم استيراد البيانات)
+
+<Note>**يجب أن تكون الحقول موجودة قبل الاستيراد.** الاستيراد يُنشئ السجلات، لا الحقول. أنشئ الحقول المخصصة ضمن **الإعدادات → نموذج البيانات** قبل الاستيراد.</Note>
+
+## توافق أنواع الحقول
+
+جميع أنواع الحقول المتاحة في نموذج البيانات مدعومة للاستيراد.
+
+يمكنك أيضًا استيراد قيم `id` إما لتعيين معرّف محدد للسجلات الجديدة أو لتحديث السجلات القائمة.
+
+<img src="/images/user-guide/fields/all-field-types.png" style={{width:'100%'}} />
+
+## متطلبات تنسيق البيانات
+
+<Note>**لبعض الحقول صياغة خاصة.** نوصي بتنزيل الملف النموذجي قبل إعداد عملية الاستيراد للاطلاع على الصياغة المتوقعة لكل نوع حقل.</Note>
+
+### حقول العنوان
+
+العنوان حقل متداخل يضم عدة أعمدة. يمكن ترك بعضِها فارغًا.
+
+* **Address / Address 1**: سطر عنوان الشارع 1
+* **Address / Address 2**: سطر عنوان الشارع 2
+* **Address / City**: اسم المدينة
+* **Address / State**: الولاية أو المقاطعة
+* **Address / Country**: اسم الدولة
+* **Address / Post Code**: الرمز البريدي/ZIP
+
+### حقول المصفوفة
+
+استخدم التنسيق التالي:
+
+```
+["value1","value2"]
+```
+
+### حقول القيم المنطقية
+
+استخدم `TRUE` أو `FALSE` (أحرف كبيرة) - وليس `true` أو `false`
+
+### حقول العملة
+
+العملة حقل متداخل يحتوي على عمودين يجب **ملؤهما كلاهما**:
+
+* **Amount / Amount**: القيمة الرقمية (مثال: `1234.56`)
+* **Amount / Currency**: رمز العملة (مثال: `USD`، `EUR`)
+
+### حقول التاريخ
+
+التنسيقات المدعومة:
+
+* `YYYY-MM-DD` (موصى به)
+* `MM/DD/YYYY`
+* `DD/MM/YYYY`
+* تنسيق ISO 8601
+
+### حقول النطاق
+
+* يُوصى باستخدام التنسيق `https://domain.com` لتجنب إنشاء التكرارات، إذ إن هذا هو التنسيق المستخدم للشركات التي يتم إنشاؤها عبر مزامنة صندوق البريد والتقويم
+* يمكن ملء حقلي `Domain Label` و`Domain URL`: وأفضل ممارسة هي وضع `domain.com` في التسمية و`https://domain.com` في عنوان URL
+* يجب أن تكون النطاقات فريدة داخل كائن الشركات
+* **يجب أن تكون النطاقات فريدة داخل الملف المُراد استيراده**
+
+### حقول البريد الإلكتروني
+
+* يجب أن تكون بتنسيق بريد إلكتروني صحيح
+* يجب أن تكون عناوين البريد الإلكتروني فريدة داخل كائن الأشخاص
+* **يجب أن تكون عناوين البريد الإلكتروني فريدة داخل الملف المُراد استيراده**
+* للبريد الإلكتروني الإضافي: استخدم **Emails / Primary Email** للبريد الرئيسي، و**Emails / Additional Emails** بهذا التنسيق:
+
+```
+["jane@twenty.com","jane.doe@twenty.com"]
+```
+
+### حقول الهوية
+
+تحديد `id` أثناء الاستيراد اختياري. يقوم Twenty بإنشاء واحد تلقائيًا إذا لم يتم توفيره.
+
+حالات استخدام لتعيين عمود `id`:
+
+* **تعيين معرّف محدد**: اختر UUID للسجلات التي سيتم إنشاؤها
+* **تحديث السجلات الحالية**: طابِق السجلات الحالية لتحديثها بدلاً من إنشاء تكرارات. في هذه الحالة، يُنصح بعدم تعيين الحقول الفريدة الأخرى: فاقتصار التعيين على حقل فريد واحد يضمن عملية استيراد أكثر سلاسة.
+
+<Note>إذا قدّمت قيمة `id`، فيجب أن تكون بتنسيق UUID (مثال: `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>
+
+### حقول JSON
+
+استخدم تنسيق JSON صالحًا:
+
+```
+{"key":"value","key2":"value2"}
+```
+
+### حقول الروابط
+
+مشابه لحقول النطاق:
+
+* املأ عمودي التسمية والرابط معًا: **Links / Link URL** و**Links / Link Label**
+* استخدم تنسيق الرابط الكامل: `https://example.com`
+* للروابط الثانوية، استخدم عمود **Links / Secondary Links** بهذا التنسيق:
+
+```
+[{"url":"https://twenty.com","label":"Twenty"}]
+```
+
+### حقول التحديد المتعدد
+
+استخدم **أسماء واجهة برمجة التطبيقات (API)** (وليس تسميات العرض) بالتنسيق التالي:
+
+```
+["VALUE1","VALUE2"]
+```
+
+اطّلع [هنا](#finding-api-names-for-select-fields) لمعرفة مكان العثور على أسماء واجهة برمجة التطبيقات.
+
+<Note>لن يتم إنشاء خيارات التحديد الجديدة تلقائيًا بواسطة الاستيراد. يجب إضافتها ضمن **الإعدادات → نموذج البيانات** قبل الاستيراد.</Note>
+
+<Warning>
+**استيراد الكتابات الزائدة؛ لا يضيف.**
+
+إذا كان السجل يحتوي بالفعل على `VALUE2` و`VALUE3` محدّدين، ثم استوردت `["VALUE1"]`، فسيحتوي السجل على `VALUE1` فقط بعد الاستيراد. يتم استبدال التحديدات السابقة، وليس دمجها.
+</Warning>
+
+### حقول الأرقام
+
+* أرقام فقط
+* تُكتب الكسور العشرية بنقطة: `1234.56`
+* من دون فواصل آلاف
+
+### حقول الهاتف
+
+الهاتف حقل متداخل يضم عدة أعمدة يجب **ملؤها**
+
+* **Phones / Primary Phone Number**: رقم الهاتف (مثال: `4159095555`)
+* **Phones / Primary Phone Country Code**: رمز الدولة (مثال: `US`)
+* **Phones / Primary Phone Calling Code**: رمز الاتصال (مثال: `+1`)
+
+### حقول التقييم
+
+استخدم تنسيق اسم واجهة برمجة التطبيقات: `RATING_1`، `RATING_2`، `RATING_3`، `RATING_4`، `RATING_5`
+
+### حقول العلاقات
+
+يرجى الاطّلاع على مقالتنا المخصّصة: [استيراد العلاقات بين الكائنات](/l/ar/user-guide/data-migration/capabilities/import-relations)
+
+### حقول الاختيار
+
+استخدم **اسم واجهة برمجة التطبيقات** للخيار (وليس تسمية العرض):
+
+```
+VALUE1
+```
+
+اطلع [هنا](#finding-api-names-for-select-fields) على مكان العثور على أسماء واجهة برمجة التطبيقات.
+<Note>لن يتم إنشاء خيارات الاختيار الجديدة تلقائيًا بواسطة الاستيراد. يجب إضافتها ضمن **الإعدادات → نموذج البيانات** قبل الاستيراد.</Note>
+
+### الحقول النصية
+
+* لا يلزم تنسيق خاص
+* تُزال المسافات في البداية والنهاية
+
+## العثور على أسماء واجهة برمجة التطبيقات
+
+بالنسبة لحقول الاختيار، والاختيار المتعدد، والمصفوفة ذات الخيارات المحددة مسبقًا، يجب استخدام **أسماء واجهة برمجة التطبيقات**، وليس تسميات العرض.
+
+### كيفية العثور على أسماء واجهة برمجة التطبيقات
+
+1. اذهب إلى **الإعدادات → نموذج البيانات**
+2. اختر الكائن والحقل
+3. فعّل **الوضع المتقدم** (زر التبديل في أسفل يمين صفحة الإعدادات)
+4. اعرض اسم واجهة برمجة التطبيقات لكل خيار
+
+<VimeoEmbed videoId="1144910809" title="عرض توضيحي بالفيديو" />

packages/twenty-docs/l/ar/user-guide/data-migration/capabilities/file-formats.mdx

@@ -0,0 +1,48 @@
+---
+title: تنسيقات الملفات المدعومة
+description: تنسيقات الملفات المدعومة لاستيراد البيانات في Twenty.
+---
+
+## التنسيقات المدعومة
+
+يدعم Twenty ثلاث تنسيقات ملفات للاستيراد:
+
+| التنسيق          | الامتداد | الملاحظات               |
+| ---------------- | -------- | ----------------------- |
+| **CSV**          | .csv     | موصى به، الأكثر توافقاً |
+| **Excel**        | .xlsx    | تنسيق Excel الحديث      |
+| **Excel (قديم)** | .xls     | تنسيق Excel الأقدم      |
+
+## متطلبات الملف
+
+| متطلب                   | القيمة                                     |
+| ----------------------- | ------------------------------------------ |
+| **الترميز**             | يُوصى باستخدام UTF-8                       |
+| **الحد الأقصى للسجلات** | 10,000 سجل لكل ملف                         |
+| **الهيكل**              | يجب أن يحتوي الصف الأول على عناوين الأعمدة |
+| **المحتوى**             | نوع كائن واحد لكل ملف                      |
+
+## أفضل الممارسات لملفات CSV
+
+* **المحدد**: استخدم الفاصلة (`,`) أو الفاصلة المنقوطة (`;`)
+* **محدد النص**: استخدم علامات الاقتباس المزدوجة (`"`) للنص الذي يحتوي على فواصل
+* **نهايات الأسطر**: Windows (CRLF) أو Unix (LF) كلاهما مدعومان
+* **القيم الفارغة**: اترك الخلايا فارغة، لا تستخدم "NULL" أو "N/A"
+
+## أفضل الممارسات لبرنامج Excel
+
+عند التصدير من Excel:
+
+* أزل الصيغ (صدّر القيم فقط)
+* احذف الصفوف الفارغة في النهاية
+* تأكد من عدم وجود خلايا مدمجة
+* استخدم الورقة الأولى فقط
+
+## مجموعات البيانات الكبيرة
+
+بالنسبة لمجموعات البيانات التي تزيد عن 10,000 سجل:
+
+* قسّمها إلى عدة ملفات
+* أو استخدم [الاستيراد عبر API](/l/ar/user-guide/data-migration/how-tos/import-data-via-api) لسجلات غير محدودة
+
+<Note>بالنسبة لعمليات الترحيل الكبيرة جداً (100,000+ سجل)، تكون واجهة API أسرع بكثير وأكثر موثوقية من عمليات استيراد CSV.</Note>

packages/twenty-docs/l/ar/user-guide/data-migration/capabilities/import-relations.mdx

@@ -0,0 +1,148 @@
+---
+title: استيراد العلاقات بين الكائنات
+description: استيراد العلاقات بين السجلات عبر CSV.
+---
+
+## نظرة عامة
+
+يدعم Twenty استيراد العلاقات بين الكائنات أثناء استيراد CSV. يتيح لك هذا ربط السجلات (مثلًا، إرفاق الأشخاص بالشركات) كجزء من ترحيل البيانات.
+
+<Note>**مدعوم حاليًا للاستيراد**: علاقات واحد إلى متعدد تشير إلى نوع كائن واحد على كل جانب (مثلًا، الأشخاص → الشركات). العلاقات التي تشير إلى أنواع كائنات متعددة غير مدعومة في الاستيراد/التصدير بعد.</Note>
+
+## كيف تعمل العلاقات في Twenty
+
+### واحد إلى متعدد / متعدد إلى واحد
+
+يدعم Twenty العلاقات القياسية حيث يرتبط سجل واحد بعدّة سجلات أخرى:
+
+* **شركة واحدة → العديد من الأشخاص**: يمكن أن تضم الشركة عدّة موظفين، لكن كل شخص ينتسب إلى شركة واحدة
+* **شركة واحدة → العديد من الفرص**: يمكن أن تحتوي الشركة على عدّة صفقات، لكن كل فرصة تتبع شركة واحدة
+
+### علاقات يمكن أن تشير إلى أنواع كائنات متعددة
+
+يمكن لبعض العلاقات الاتصال بأنواع مختلفة من الكائنات. يعمل هذا بطريقتين:
+
+**النمط 1: سجلات كثيرة يرتبط كلٌ منها بسجل واحد من أنواع كائنات مختلفة**
+
+يمكن إرفاق عدة ملاحظات أو مهام بأنواع متعددة من الكائنات في وقت واحد:
+
+* **الملاحظات** يمكن ربطها بشخص واحد وشركة واحدة وفرصة واحدة في الوقت نفسه
+* **المهام** يمكن ربطها بشخص واحد وشركة واحدة وفرصة واحدة في الوقت نفسه
+
+هنا تكون الملاحظات/المهام على جانب "المتعدد". يرتبط كلٌ منها بسجل واحد لكل نوع كائن.
+
+<img src="/images/user-guide/fields/many-to-one-morph.png" style={{width:'100%'}} />
+
+**النمط 2: سجل واحد يستقبل روابط من سجلات عديدة لأنواع كائنات مختلفة**
+
+يمكن لمشروع أن يستقبل روابط من سجلات متعددة عبر أنواع كائنات مختلفة:
+
+* **مشروع** يمكن أن يكون مرتبطًا به العديد من الأشخاص، والعديد من الشركات، والعديد من الملاحظات المرفقة به
+
+هنا يكون المشروع على جانب "الواحد". يمكن لعدّة سجلات من كائنات مختلفة أن ترتبط جميعها بالمشروع نفسه.
+
+<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
+
+<Warning>
+**قيد في الاستيراد/التصدير**: العلاقات التي تشير إلى أنواع كائنات متعددة (مثل الملاحظات → الأشخاص/الشركات/الفرص) **غير مدعومة بعد** في استيراد أو تصدير CSV.
+
+* **الاستيراد**: يمكن استيراد علاقات واحد إلى متعدد فقط التي تشير إلى نوع كائن واحد على كل جانب
+* **التصدير**: تُترك الأعمدة الخاصة بالعلاقات التي تشير إلى أنواع كائنات متعددة فارغة حاليًا
+
+هذا على خارطة الطريق لدينا.
+</Warning>
+
+### ما ليس مدعومًا اليوم
+
+**علاقات متعدد إلى متعدد** غير متاحة بعد. على سبيل المثال، لا يمكنك حاليًا إنشاء علاقة حيث:
+
+* يرتبط العديد من الأشخاص بالعديد من المشاريع
+
+<Note>العديد من العلاقات مخطط لها لـ H2 2026.</Note>
+
+## ربط السجلات أثناء الاستيراد
+
+<Note>**تذكير**: يمكن استيراد علاقات واحد إلى متعدد فقط التي تشير إلى نوع كائن واحد (مثلًا، الأشخاص → الشركات). العلاقات التي تشير إلى أنواع كائنات متعددة (مثل الملاحظات → الأشخاص/الشركات/الفرص) غير مدعومة بعد.</Note>
+
+### الخطوة 1: تحديد جانبي "الواحد" و"المتعدد"
+
+أولًا، حدّد أي الكائنات على جانب "الواحد" وأيها على جانب "المتعدد" في العلاقة.
+
+**مثال**:
+
+* **الشركة** هي جانب "الواحد" (شركة واحدة لديها العديد من الموظفين)
+* **الأشخاص** على جانب "المتعدد" (ينتمي كل شخص إلى شركة واحدة)
+
+### الخطوة 2: تأكّد من وجود سجلات جانب "الواحد"
+
+قبل استيراد جانب "المتعدد"، يجب أن تكون سجلات جانب "الواحد" موجودة مسبقًا في Twenty.
+
+* استورد أو أنشئ سجلات جانب "الواحد" أولًا (مثلًا، الشركات)
+* تحقّق من مُعرّفهم الفريد. يمكن أن يكون ذلك:
+  * حقل `id` (UUID الخاص بـ Twenty)
+  * حقل مُعيّن كفريد (مثلًا، `domain` للشركات، أو مُعرّف خارجي من نظامك السابق)
+
+<Warning>سيفشل الاستيراد إذا تمت الإشارة إلى سجل غير موجود.</Warning>
+
+### الخطوة 3: جهّز ملف CSV الخاص بك
+
+أضِف عمودًا في ملف CSV الخاص بجانب "المتعدد" يُشير إلى سجل جانب "الواحد".
+
+**مثال**: لملف CSV للأشخاص يربط بالشركات:
+
+```
+firstName,lastName,email,companyDomain
+John,Smith,john@acme.com,https://acme.com
+Jane,Doe,jane@widgets.co,https://widgets.co
+```
+
+**مهم**:
+
+* يجب أن **يطابق تمامًا** قيمة الحقل الفريد في سجل الشركة
+* بالنسبة للنطاقات، استخدم **عنوان النطاق (URL)** (مثلًا، `https://acme.com`)، وليس تسمية النطاق
+* قم بتعيين **مُعرّف فريد واحد** فقط لكل علاقة: فهذا يؤدي إلى عملية استيراد أكثر سلاسة
+
+### الخطوة 4: تأكّد من وجود حقل العلاقة
+
+قبل رفع ملفك، تأكّد من وجود حقل العلاقة بين كائناتك.
+
+إذا لم يكن موجودًا:
+
+1. اذهب إلى **الإعدادات → نموذج البيانات**
+2. اختر الكائن الخاص بك (مثلًا، الأشخاص)
+3. أنشئ حقل علاقة يشير إلى الكائن الهدف (مثلًا، الشركة)
+
+### الخطوة 5: ارفع الملف وعيّن العلاقة
+
+1. ارفع ملف CSV عبر واجهة الاستيراد
+2. في خطوة تعيين الحقول، اعثر على عمود العلاقة الخاص بك (مثلًا، `companyDomain`)
+3. عيّنه على حقل العلاقة (مثلًا، الشركة)
+4. سيقوم Twenty بربط كل سجل تلقائيًا بالأصل المطابق
+
+### الحقول الفريدة المتاحة للعلاقات
+
+| كائن                           | الحقول الفريدة المتاحة           |
+| ------------------------------ | -------------------------------- |
+| **الشركات**                    | `id`، `domain`، أي حقل فريد مخصص |
+| **الأشخاص**                    | `id`، `email`، أي حقل فريد مخصص  |
+| **أعضاء مساحة العمل**          | `id`، `email` (ليس الاسم)        |
+| **كائنات قياسية ومخصّصة أخرى** | `id`، أي حقل مُعلَّم كفريد       |
+
+<Note>**الربط بأعضاء مساحة العمل**: عندما تشير العلاقة إلى أعضاء مساحة العمل (فريقك الذي يسجّل الدخول إلى Twenty)، فقم بالإشارة إليهم عبر **عنوان البريد الإلكتروني**، وليس الاسم.</Note>
+
+<Note>نوصي باستخدام `domain` للشركات و`email` للأشخاص، إذ إنها مقروءة بشريًا وسهلة الإدارة في جداول البيانات.</Note>
+
+<Note>**تذكير**: السجلات المحذوفة حذفًا غير نهائي (مرئية ضمن Command Menu → See deleted records) تُحتسب ضمن معايير التفرّد. إذا قمت باستيراد سجل بالقيمة الفريدة نفسها لسجل محذوف، فسيتم استعادة السجل المحذوف. راجع [قيود التفرّد](/l/ar/user-guide/data-migration/capabilities/uniqueness-constraints) لمزيد من التفاصيل.</Note>
+
+## قاعدة ترتيب الاستيراد
+
+<Warning>
+**احرص دائمًا على استيراد جانب "الواحد" أولًا!**
+
+1. **الشركات** أولًا (من دون تبعيات)
+2. **الأشخاص** ثانيًا (مرتبطون بالشركات)
+3. **الفرص** ثالثًا (مرتبطة بالشركات/الأشخاص)
+4. **الكائنات المخصّصة** وفقًا لتبعياتها
+
+يجب أن يكون السجل الأصل موجودًا قبل أن تتمكّن من الإشارة إليه.
+</Warning>

packages/twenty-docs/l/ar/user-guide/data-migration/capabilities/uniqueness-constraints.mdx

@@ -0,0 +1,72 @@
+---
+title: قيود التفرّد
+description: كيف يفرض Twenty تفرد البيانات أثناء الاستيراد.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## نظرة عامة
+
+يفرض Twenty التفرّد على حقول معيّنة لمنع تكرار السجلات وضمان سلامة البيانات. فهم هذه القيود أمرٌ أساسي لنجاح عمليات الاستيراد.
+
+## الحقول الفريدة الافتراضية
+
+| كائن             | الحقول الفريدة       |
+| ---------------- | -------------------- |
+| **الأشخاص**      | `id`, `email`        |
+| **الشركات**      | `id`, `domain`       |
+| **كائنات مخصصة** | `id` فقط (افتراضيًا) |
+
+<Note>حقل `id` هو المعرّف الداخلي الخاص بـ Twenty، يتم إنشاؤه تلقائيًا لكل سجل. يستخدم تنسيق UUID (مثلًا: `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>
+
+## حقول فريدة مخصّصة
+
+يمكنك تعريف حقول فريدة إضافية ضمن **الإعدادات → نموذج البيانات**:
+
+1. اذهب إلى **الإعدادات → نموذج البيانات**
+2. اختر الكائن
+3. انقر على حقل
+4. فعِّل **فريد** في إعدادات الحقل
+
+### حالات استخدام للحقول الفريدة المخصّصة
+
+* **معرّفات خارجية**: خزّن معرّفات من أنظمة أخرى (Salesforce ID, HubSpot ID)
+* **معرّفات الأعمال**: أرقام الموظفين، رموز العملاء
+* **معلومات اتصال بديلة**: ملف LinkedIn، رقم الهاتف
+
+<Note>اسم الحقل `id` محجوز للمعرّف الداخلي الخاص بـ Twenty. استخدم اسمًا مختلفًا مثل `externalId` أو `legacyId` للمعرّفات الخارجية.</Note>
+
+## سلوك الاستيراد
+
+### إنشاء سجلات جديدة
+
+إذا لم تكن قيمة الحقل الفريد موجودة، فسيتم إنشاء سجل جديد.
+
+### تحديث السجلات الموجودة
+
+إذا طابقت قيمة حقل فريد سجلًا موجودًا، فسيتم **تحديث** ذلك السجل بالبيانات الجديدة.
+<Warning>لـ **تحديث السجلات الموجودة**، يُنصَح بـ **مطابقة حقل فريد واحد فقط**.</Warning>
+
+### السجلات المحذوفة حذفًا غير نهائي
+
+<Warning>
+**السجلات المحذوفة تُحتسب ضمن التفرّد.**
+
+السجلات المحذوفة حذفًا غير نهائي (مرئية ضمن Command Menu → See deleted records) مُدرجة ضمن فحوصات التفرّد. إذا قمت باستيراد سجل بالقيمة الفريدة نفسها لسجل محذوف، فسيتم **استعادة** السجل المحذوف مع البيانات الجديدة.
+</Warning>
+
+## اكتشاف التكرارات أثناء الاستيراد
+
+أثناء مرحلة التحقق:
+
+* يتم تمييز التكرارات داخل ملفك باللون الأصفر
+* يمكنك تعديل الصفوف المكرّرة أو إزالتها من واجهة المستخدم قبل بدء الاستيراد
+
+<VimeoEmbed videoId="1145246326" title="عرض توضيحي بالفيديو" />
+
+## أفضل الممارسات
+
+1. **أزل التكرارات** من ملفك قبل الاستيراد
+2. **تحقّق من السجلات الموجودة** في Twenty قبل الاستيراد
+3. **استخدم المعرّفات الخارجية** عند الترحيل من أنظمة أخرى
+4. **ضمّن الحقول الفريدة** إذا كنت تريد تحديث السجلات الموجودة