docs: sync workspace settings, record upsert and table operations

ar/api-doc/oauth.mdx

@@ -15,7 +15,7 @@ description: "أنشئ عمليات تكامل تتيح للمستخدمين ا
 
 ## إنشاء تطبيق OAuth
 
-1. انتقل إلى [الإعدادات > تطبيقات OAuth](https://app.teable.ai/setting/oauth-app) في حسابك على Teable.
+1. انقر على صورتك الرمزية أسفل الشريط الجانبي، ثم افتح **الإعدادات** ← **أدوات المطوّرين** ← **تطبيقات OAuth** (أو افتح [صفحة تطبيقات OAuth](https://app.teable.ai/setting/oauth-app) مباشرةً).
 2. انقر على **تطبيقات OAuth جديدة** لإنشاء تطبيق جديد.
 3. أدخل المعلومات المطلوبة:
    - **اسم تطبيق OAuth**: اسم وصفي لتطبيقك

ar/api-doc/record/create.mdx

@@ -1,6 +1,6 @@
 ---
 title: "API: إنشاء السجلات"
-description: "أنشئ سجلات عبر Teable API مع قيم الحقول والقيم الافتراضية وتحديد موضع السجلات."
+description: "أنشئ سجلات عبر Teable API، وحدد قيم الحقول ومواضعها، أو طابق السجلات الحالية بحقل فريد لتحديثها أو تخطيها أو رفض التعارضات."
 ---
 
 {/* mintlify-resync: 2026-05-14 */}
@@ -242,3 +242,88 @@ POST /api/table/\{tableId\}/record
   print(response.json())
   ```
 </CodeGroup>
+
+## إنشاء السجلات أو تحديثها حسب حقل فريد {#upsert-by-unique-field}
+
+عند مزامنة بيانات خارجية، يمكنك مطابقة السجلات بقيمة فريدة مثل رقم الطلب أو رقم العميل، دون البحث أولًا عن معرّفات السجلات.
+
+```text
+POST /api/table/{tableId}/record/upsert
+```
+
+<Info>تتطلب هذه الواجهة جدولًا يستخدم محرك v2، ولا تدعم الاستدعاء عبر العروض المشتركة. يتطلب وضع `error` إذن إنشاء السجلات؛ ويتطلب وضعا `ignore` و`update` إذني الإنشاء والتحديث معًا.</Info>
+
+### نص الطلب
+
+| المعامل | الوصف |
+| --- | --- |
+| `matchField` | مطلوب. معرّف حقل المطابقة، ويجب تفعيل قيد التفرد عليه. يُدعم حقل واحد فقط، ولا تُدعم المفاتيح المركبة. |
+| `onConflict` | مطلوب. طريقة التعامل مع تطابق موجود؛ راجع الجدول أدناه. |
+| `records` | مطلوب. سجل واحد على الأقل. يقدم كل سجل قيمه في `fields`، ويجب أن يتضمن قيمة مطابقة غير فارغة. لا يجوز تكرار قيم المطابقة داخل الطلب نفسه. |
+| `fieldKeyType` | اختياري. نوع المفاتيح في `fields`، كما في واجهة إنشاء السجلات. استخدم دائمًا معرّف الحقل في `matchField`. |
+| `typecast` | اختياري. ما إذا كان ينبغي محاولة تحويل أنواع قيم الحقول تلقائيًا، كما في واجهة إنشاء السجلات. |
+
+تُنشأ السجلات التي لا تطابق سجلًا موجودًا. وعند وجود تطابق، يُطبّق `onConflict`:
+
+| القيمة | السلوك |
+| --- | --- |
+| `error` | يفشل الطلب بأكمله إذا كانت أي قيمة مطابقة موجودة بالفعل. |
+| `ignore` | يحتفظ بالسجل الحالي ويتخطى سجل الإدخال هذا. |
+| `update` | يحدّث الحقول المقدمة فقط؛ وتحتفظ الحقول الأخرى بقيمها. |
+
+على سبيل المثال، إذا كان `fldOrderNumber` حقل رقم طلب مع تفعيل قيد التفرد، فإن الطلب التالي ينشئ طلبًا جديدًا أو يحدّث حالة طلب موجود:
+
+```json
+{
+  "fieldKeyType": "id",
+  "matchField": "fldOrderNumber",
+  "onConflict": "update",
+  "records": [
+    {
+      "fields": {
+        "fldOrderNumber": "ORDER-001",
+        "fldStatus": "مدفوع"
+      }
+    }
+  ]
+}
+```
+
+### الاستجابة
+
+في الاستجابة الناجحة، يتبع `results` ترتيب الإدخال، ويبدأ `index` من 0. ويحصي `summary` السجلات المطلوبة وكل نوع من النتائج.
+
+| `status` | المعنى |
+| --- | --- |
+| `created` | تم إنشاء سجل جديد. |
+| `updated` | تم تحديث سجل موجود. |
+| `unchanged` | القيم الحالية مطابقة بالفعل، أو لا توجد حقول تحتاج إلى تحديث. |
+| `skipped` | تم تخطي سجل موجود في وضع `ignore`. |
+
+تتضمن النتائج `recordId` و`record` فقط عندما يملك المستدعي إذن قراءة ذلك السجل. ويظل محتوى الحقول خاضعًا لأذونات القراءة.
+
+```json
+{
+  "results": [
+    {
+      "index": 0,
+      "status": "updated",
+      "recordId": "recExample",
+      "record": {
+        "id": "recExample",
+        "fields": {
+          "fldOrderNumber": "ORDER-001",
+          "fldStatus": "مدفوع"
+        }
+      }
+    }
+  ],
+  "summary": {
+    "requested": 1,
+    "created": 0,
+    "updated": 1,
+    "unchanged": 0,
+    "skipped": 0
+  }
+}
+```

ar/api-doc/record/update.mdx

@@ -4,6 +4,9 @@ description: "حدّث سجلاً عبر Teable API لتعيين قيم حقول
 ---
 
 {/* mintlify-resync: 2026-05-14 */}
+
+إذا كانت معرّفات السجلات معروفة لديك، فاستخدم واجهة التحديث أدناه. وللمطابقة بحقل فريد، مثل رقم الطلب أو رقم العميل، وإنشاء السجلات غير الموجودة، راجع [إنشاء السجلات أو تحديثها حسب حقل فريد](/ar/api-doc/record/create#upsert-by-unique-field).
+
 ### المسار
 
 PATCH /api/table/\{tableId\}/record/\{recordId\}

ar/api-doc/token.mdx

@@ -12,7 +12,7 @@ sidebarTitle: "رمز الوصول"
 
 ## إنشاء رمز وصول
 
-1. انتقل إلى [صفحة إدارة رموز الوصول](https://app.teable.ai/setting/personal-access-token) وانقر على **إنشاء رمز جديد** لإنشاء رمز وصول شخصي جديد.
+1. انقر على صورتك الرمزية أسفل الشريط الجانبي، ثم افتح **الإعدادات** ← **أدوات المطوّرين** ← **رموز الوصول الشخصية** (أو افتح [صفحة إدارة رموز الوصول](https://app.teable.ai/setting/personal-access-token) مباشرةً)، وانقر على **إنشاء رمز جديد**.
 
 2. اختر مدة صلاحية رمز الوصول. لاحظ أنه لا يمكن تعديل هذه المدة بعد تحديدها.
 

ar/basic/admin-panel/computed-outbox.mdx

@@ -8,25 +8,17 @@ sidebarTitle: "صندوق المهام المحسوبة"
 
 <Tip>متاح لخطة Business ذاتية الاستضافة والخطط الأعلى</Tip>
 
-المسار: إدارة النظام ← صندوق المهام المحسوبة
+المسار: إدارة النظام ← عمليات الجداول ← التحديثات المحسوبة
 
-استخدم **صندوق المهام المحسوبة** عندما تتوقف قيم الصيغ أو البحث أو غيرها من الحقول المحسوبة عن التحديث أو تستغرق وقتًا أطول بكثير من المتوقع. تعرض الصفحة السلامة العامة للمهام، والمهام التي تتحرك عبر قائمة الانتظار، والمهام التي قد تحتاج إلى استرداد، وأي مساحة أُوقفت مهامها المحسوبة مؤقتًا.
+افتح **التحديثات المحسوبة** عندما تتوقف الصيغ أو قيم البحث أو غيرها من القيم المحسوبة عن التحديث أو تصبح بطيئة. ابدأ من **نظرة عامة** لفحص التراكم في المثيل، ثم تتبّع التسليمات في **طابور BullMQ**. استخدم **الحالات الشاذة** لاستعادة الحسابات الفاشلة و**الإيقافات المؤقتة** لإيقاف مساحة مؤقتًا أو استئنافها.
 
 ## قراءة حالة السلامة
 
-توضح الحالة المجاورة لعنوان الصفحة ما إذا كانت المهام المحسوبة تحتاج إلى الانتباه:
-
-| الحالة | المعنى |
-| --- | --- |
-| **سليمة** | تعمل المهام المحسوبة بصورة طبيعية. |
-| **متدهورة** | عثر Teable على إخفاقات أو مهام انتهت مهلتها أو تراكم متزايد. |
-| **حرجة** | BullMQ غير متاح أو لا يوجد عامل متاح لمعالجة المهام. |
-
-عندما تتطلب الحالة الانتباه، تسرد الصفحة السبب.
+يلخّص **نظرة عامة** المهام المنتظرة والجارية والتراكم الموقوف والرسائل المتعذّر تسليمها. عند ظهور **يحتاج إلى انتباه**، اقرأ السبب أولًا. استعد بيئة التشغيل إذا كان الطابور غير متاح أو لم يوجد عامل؛ وابحث عن المهام المنتهية مهلتها أو المتراكمة في صفحات الطابور والحالات الشاذة.
 
 ## العثور على مهمة في قائمة الانتظار
 
-تعرض **قائمة BullMQ المباشرة** الوظائف التي لا يزال Teable يحتفظ بها، حتى تتمكن من متابعة مهمة محسوبة أو البحث عن المهام البطيئة.
+تعرض **طابور BullMQ** الوظائف التي لا يزال Teable يحتفظ بها، حتى تتمكن من متابعة مهمة محسوبة أو البحث عن المهام البطيئة.
 
 يمثل كل صف مهمة واحدة افتراضيًا، ويتنقل بين الحالات في موضعه أثناء إعادة Teable المحاولة. انتقل إلى **عمليات التسليم** عندما تحتاج إلى السجل الكامل لمحاولات مهمة أو تريد البحث عن عمليات التشغيل البطيئة.
 
@@ -57,11 +49,13 @@ sidebarTitle: "صندوق المهام المحسوبة"
 
 <Info>لا يسجل دفتر المسار إلا المهام التي أُنشئت بعد إصدار هذه الميزة، ويحتفظ بسجل لمدة 7 أيام. تعرض المهمة الأقدم بيانات قائمة الانتظار من دون رسم انتشار. ولا تعرض المهمة الأولية التي لم يخطط لها العامل بعد إلا حقول تشغيلها. عندما لا ينتج عن تغيير أي كتابات محسوبة لاحقة، يوضح الرسم ذلك: لم يعتمد شيء على تلك الحقول من خلال صيغة أو بحث أو تجميع أو عنوان ارتباط.</Info>
 
+تميّز حواف الرسم نطاق التأثير أيضًا: يتبع **via link** السجلات المرتبطة، ويختار **conditional** السجلات المستهدفة حسب شرط، ويشمل **whole table** كل سجلات الجدول المستهدف، ويمثل **depends** تبعيات تعريف الحقول. عند بطء التحديث، ابدأ بفحص إعادة حساب الجدول بالكامل والمسارات الطويلة بين الجداول.
+
 ## معالجة المهام الشاذة
 
 <Info>يعرض عدد **الفاشلة** وقسم **معالجة الحالات الشاذة** أنواعًا مختلفة من المشكلات، ولذلك قد تختلف أرقامهما.</Info>
 
-تجمع **معالجة الحالات الشاذة** الحالات في مجموعات مشكلات، واحدة لكل مشروع وجدول مصدر وخطأ، حتى يسهل اكتشاف السبب الجذري الواحد. راجع سبب الفشل وأصلح المشكلة الأساسية قبل استرداد أي شيء. وسّع مجموعة لقراءة تفاصيل الخطأ والمهام التي تشملها؛ هذه الصفوف للفحص، ويُنفذ الاسترداد دائمًا على المجموعة بأكملها.
+افتح **الحالات الشاذة** لإدارة مجموعات المشكلات هذه. تجمع **معالجة الحالات الشاذة** الحالات في مجموعات مشكلات، واحدة لكل مشروع وجدول مصدر وخطأ، حتى يسهل اكتشاف السبب الجذري الواحد. راجع سبب الفشل وأصلح المشكلة الأساسية قبل استرداد أي شيء. وسّع مجموعة لقراءة تفاصيل الخطأ والمهام التي تشملها؛ هذه الصفوف للفحص، ويُنفذ الاسترداد دائمًا على المجموعة بأكملها.
 
 تعتمد الإجراءات التي توفرها المجموعة على نوعها:
 
@@ -81,7 +75,7 @@ sidebarTitle: "صندوق المهام المحسوبة"
 
 ## إيقاف المهام المحسوبة مؤقتًا لمساحة
 
-عندما تؤدي المهام المحسوبة لإحدى المساحات إلى تفاقم حادثة، أوقف تلك المساحة مؤقتًا في **إيقافات المهام المحسوبة** بدلاً من إيقاف النسخة بأكملها.
+عندما تؤدي المهام المحسوبة لإحدى المساحات إلى تفاقم حادثة، أوقف تلك المساحة مؤقتًا في **الإيقافات المؤقتة** بدلاً من إيقاف النسخة بأكملها.
 
 <Steps>
   <Step title="فتح مربع حوار الإيقاف المؤقت">انقر على **إيقاف مساحة مؤقتًا**.</Step>

ar/basic/admin-panel/overview.mdx

@@ -36,11 +36,9 @@ sidebarTitle: "إدارة النظام للاستضافة الذاتية"
 ### العمليات والتدقيق
 
 - **[إدارة الأتمتة](/ar/basic/admin-panel/automation-management)**: عرض حالة تشغيل الأتمتة وسجل التشغيل
-- **[عمليات استعلام الجداول](/ar/basic/admin-panel/table-query-ops)**: ضبط تغطية البحث لكل جدول، وإنشاء الفهارس، ومتابعة النتائج
-- **[صندوق المهام المحسوبة](/ar/basic/admin-panel/computed-outbox)**: مراقبة تسليم المهام المحسوبة وسلامة قائمة الانتظار وتراكم قاعدة البيانات
+- **عمليات الجداول**: تنقّل بين **[البحث والفهارس](/ar/basic/admin-panel/table-query-ops)** و**[التعقيد](/ar/basic/admin-panel/table-query-ops#تقييم-أثر-التغييرات)** و**[سلامة المخطط](/ar/basic/admin-panel/schema-integrity)** و**[التحديثات المحسوبة](/ar/basic/admin-panel/computed-outbox)** لتشخيص الاستعلامات البطيئة وتقييم التغييرات وإصلاح البنية ومعالجة تراكم الحسابات.
 - **[قائمة انتظار توليد الذكاء الاصطناعي](/ar/basic/admin-panel/ai-generation-queue)**: مراجعة حالة توليد حقول الذكاء الاصطناعي في النسخة ذاتية الاستضافة الحالية
 - **[وكيل البيئة المعزولة](/ar/basic/admin-panel/sandbox-agent)**: تهيئة وكيل البيئة المعزولة وإدارته
-- **[Schema integrity](/ar/basic/admin-panel/schema-integrity)**: شغّل فحوص المخطط على أي مشروع وأصلح ما تكشفه
 - **[سجل التدقيق](/ar/basic/admin-panel/audit-log)**: مراجعة نشاط النسخة الأخير وتفاصيل العمليات
 
 ## أذونات المسؤول

ar/basic/admin-panel/schema-integrity.mdx

@@ -8,17 +8,19 @@ sidebarTitle: "Schema integrity"
 
 <Tip>متاح للاستضافة الذاتية بخطة Business فما فوق</Tip>
 
-المسار: إدارة النظام ← Schema integrity
+المسار: إدارة النظام ← عمليات الجداول ← سلامة المخطط
 
-يُفترض أن تتطابق تعريفات الحقول التي يحتفظ بها Teable مع البنية الفعلية في قاعدة البيانات. وحين يتباعد الاثنان، يرى المستخدمون حقولًا لا تُفتح، وحقول ربط لا تُرجع شيئًا، أو جدولًا يتعثّر فيه القراءة والكتابة باستمرار من دون سبب ظاهر. ويتولّى **Schema integrity** تحديد هذا النوع من المشكلات وإصلاحه.
+يُفترض أن تتطابق تعريفات الحقول التي يحتفظ بها Teable مع البنية الفعلية في قاعدة البيانات. وحين يتباعد الاثنان، يرى المستخدمون حقولًا لا تُفتح، وحقول ربط لا تُرجع شيئًا، أو جدولًا يتعثّر فيه القراءة والكتابة باستمرار من دون سبب ظاهر. ويتولّى **سلامة المخطط** تحديد هذا النوع من المشكلات وإصلاحه.
 
 يستطيع مسؤول النسخة فحص أي مشروع في النسخة من دون الانضمام إلى مساحته أولًا، بما في ذلك المستأجرون الذين يديرون قاعدة بياناتهم بأنفسهم (BYODB).
 
 ## تشغيل الفحص
 
-ابحث عن المشروع من مربّع البحث، بالمشروع أو المساحة أو معرّف الجدول أو الاسم. تعرض قائمة النتائج المساحة (**Space**) التي تنتمي إليها، وقاعدة البيانات المستخدمة (**Data DB**: الافتراضية أو BYODB)، وبيئة التشغيل (**Runtime**: v1 أو v2)، وبها تتأكّد أنك أمام المشروع الصحيح. فتكرار اسم المشروع نفسه في مساحات مختلفة أمر شائع.
+عند عدم اختيار جدول، تعرض الصفحة الفحوص حسب المشروع. ابحث بالمشروع أو المساحة أو معرّف الجدول أو الاسم، ثم أكّد النطاق عبر المساحة وقاعدة البيانات وبيئة التشغيل. قد تتكرر أسماء المشاريع بين المساحات.
 
-انقر **Check** في ذلك الصف، ثم **تشغيل الفحص** في نافذة **سلامة المخطط**.
+انقر **فحص المشروع** في ذلك الصف، ثم **تشغيل الفحص** في نافذة **سلامة المخطط**.
+
+إذا اقتصر الخلل على جدول واحد، فحدده باستخدام **اختر جدولًا** في الأعلى؛ يبدأ فحص الجدول تلقائيًا. استخدم **فحص المشروع بالكامل** لتوسيع الفحص إلى المشروع، أو **مراجعة** في صف المشكلة لمراجعة خيارات الإصلاح.
 
 ## قراءة النتائج