Files
upstream-twenty/packages/twenty-docs/l/ar/user-guide/data-model/overview.mdx
upstream-mirror e7da97194a
Some checks failed
App Prod-Parity E2E Dispatch / dispatch (push) Failing after 10s
CD Storybook UI / build (push) Failing after 3m25s
CD Storybook UI / dispatch (push) Has been skipped
CD deploy main / website-changed-files (push) Successful in 18m8s
CI Agent Skills / changed-files-check (push) Successful in 18m9s
CI Create App E2E minimal / changed-files-check (push) Successful in 24s
CI Create App / changed-files-check (push) Successful in 26s
CI Docs / changed-files-check (push) Successful in 26s
CI Emails / changed-files-check (push) Successful in 28s
CI Example App Hello World / changed-files-check (push) Successful in 23s
CI Front / changed-files-check (push) Has been skipped
CI Example App Postcard / changed-files-check (push) Successful in 27s
CI UI / changed-files-check (push) Has been skipped
CI Utils Test / changed-files-check (push) Successful in 45s
CI Twenty Apps / discover (push) Successful in 1m3s
CD deploy main / deploy-main (push) Failing after 3s
CI Agent Skills / agent-skills-validate (push) Has been skipped
CI Create App / create-app-test (lint) (push) Has been skipped
CI Emails / emails-test (push) Has been skipped
CI Front / front-task (lingui:compile) (push) Has been skipped
CI Front / front-task (lint) (push) Has been skipped
CI Example App Postcard / example-app-postcard (push) Has been skipped
CI UI / ui-task (lint) (push) Has been skipped
CI UI / ui-task (pack-size) (push) Has been skipped
CI UI / ui-task (size) (push) Has been skipped
CI UI / ui-task (test) (push) Has been skipped
CI UI / ui-task (typecheck) (push) Has been skipped
CI Utils Test / utils-test (push) Has been skipped
CI Twenty Apps / ${{ matrix.app.name }} (push) Has been skipped
CI Emails / ci-emails-status-check (push) Successful in 2s
CI Example App Hello World / ci-example-app-hello-world-status-check (push) Successful in 2s
CI Example App Postcard / ci-example-app-postcard-status-check (push) Successful in 3s
CI UI / ui-sb-test (push) Has been skipped
CI Utils Test / ci-utils-test-status-check (push) Successful in 2s
CI Twenty Apps / ci-twenty-apps-status-check (push) Successful in 2s
CI UI / ci-ui-status-check (push) Successful in 2s
CI Desktop / desktop (push) Failing after 1m8s
Push docs to Crowdin / Push documentation to Crowdin (push) Failing after 55s
Push translations to Crowdin / Extract and upload translations (push) Failing after 5s
Push website translations to Crowdin / Extract and upload website translations (push) Failing after 5s
CI Create App / create-app-test (test) (push) Has been skipped
CI Create App / create-app-test (typecheck) (push) Has been skipped
CI Docs / docs-lint (push) Has been skipped
CI Example App Hello World / example-app-hello-world (push) Has been skipped
CI Front / front-task (lingui:extract) (push) Has been skipped
CI Front / front-task (test) (push) Has been skipped
CI Front / front-task (typecheck) (push) Has been skipped
CI UI / ui-sb-build (push) Failing after 1m32s
CI Twenty Apps / ${{ matrix.app.name }} (${{ matrix.server-source }}) (push) Has been skipped
CI Agent Skills / agent-skills-publish (push) Has been skipped
CI Create App / ci-create-app-status-check (push) Successful in 2s
CI Agent Skills / agent-skills-remote-source (push) Has been skipped
CI Create App E2E minimal / create-app-e2e-minimal (push) Has been cancelled
CI E2E Main / e2e-test (push) Has been cancelled
CI Front / front-sb-build (push) Has been cancelled
CI Front / front-build (push) Has been cancelled
CI Create App E2E minimal / ci-create-app-e2e-minimal-status-check (push) Has been cancelled
CI E2E Main / ci-e2e-main-status-check (push) Has been cancelled
CI E2E Main / notify-main-ci-failure (push) Has been cancelled
CI E2E Main / qa-scout-comment (push) Has been cancelled
CI Front / front-sb-test (push) Has been cancelled
CI Front / front-sb-screenshots (push) Has been cancelled
CI Front / ci-front-status-check (push) Has been cancelled
DPA Sub-Processor Sync / sync-subprocessors (push) Failing after 3s
AI Catalog Sync / sync-catalog (push) Failing after 2s
snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)
2026-09-17 23:28:13 +05:00

178 lines
9.3 KiB
Plaintext

---
title: نموذج البيانات
description: تعرّف إلى نموذج البيانات وكيفية تصميم نموذج يناسب نشاطك التجاري.
---
## ما هو نموذج البيانات؟
نموذج البيانات هو الهيكل الذي يحدّد كيفية تنظيم المعلومات في نظام إدارة علاقات العملاء (CRM) لديك. فكّر فيه باعتباره **المخطط** لبيانات عملائك — تصمّمه مرة واحدة، ثم تملؤه ببياناتك الفعلية.
## المفاهيم الأساسية
### كائنات
**الكائنات** هي الفئات الرئيسية للبيانات في نظام إدارة علاقات العملاء (CRM) لديك. يمثّل كل كائن نوعًا من الأشياء التي تريد تتبّعها.
يوفّر Twenty كائنات قياسية:
* **الأشخاص** — أفراد (جهات اتصال، عملاء محتملون، شركاء)
* **الشركات** — مؤسسات
* **الفرص** — صفقات أو مبيعات
* **ملاحظات** - الملاحظات المرفقة بالسجلات
* **المهام** — عناصر قائمة المهام المرتبطة بالسجلات
يمكنك أيضًا إنشاء **كائنات مخصّصة** لأي شيء خاص بنشاطك التجاري (مثل: المشروعات، الاشتراكات، الأحداث).
### الحقول
**الحقول** هي الخصائص أو السمات التي تصف كل كائن. إنها تخزّن المعلومات الفعلية.
على سبيل المثال، يحتوي كائن **الأشخاص** على حقول مثل:
* الاسم
* البريد الإلكتروني
* هاتف
* المسمى الوظيفي
* الشركة (علاقة بكائن الشركات)
للحقول **أنواع** مختلفة: نص، رقم، تاريخ، اختيار، اختيار متعدد، علاقة، وغير ذلك. يمكنك إضافة حقول مخصّصة إلى أي كائن.
### السجلات
**السجلات** هي الإدخالات الفردية داخل الكائن — البيانات الفعلية التي تنشئها وتديرها.
على سبيل المثال:
* "John Smith" هو **سجل** في كائن الأشخاص
* "Acme Corp" هو **سجل** في كائن الشركات
**تشبيه:**
| مفهوم نموذج البيانات | تشبيه من الواقع |
| -------------------- | --------------------------------------- |
| **الكائنات** | أقسام في كتاب (الفئات) |
| **حقول** | أعمدة في جدول بيانات (الخصائص) |
| **السجلات** | صفوف في جدول بيانات (الإدخالات الفعلية) |
تصمّم نموذج البيانات (الكائنات + الحقول) مرة واحدة، ثم تنشئ العديد من السجلات ضمن تلك البنية.
## لماذا تخصّص نموذج البيانات الخاص بك؟
كل شركة تعمل بطريقة مختلفة. يعني تخصيص نموذج البيانات أنك تستطيع تكييف Twenty حول عملياتك بدلاً من فرض عملياتك داخل نظام جامد.
توفر Twenty مرونة كاملة:
* أنشئ عددًا من الكائنات المخصّصة بقدر ما تحتاج
* أضِف حقولًا مخصّصة غير محدودة
* لا يتغيّر السعر بناءً على التخصيص
## نصائح لتصميم نموذج البيانات الخاص بك
### 1. ابدأ بكائناتك الأساسية
حدّد المفاهيم الرئيسية التي تعمل بها. توفّر Twenty مسبقًا:
* **الأشخاص** — جهات الاتصال لديك
* **الشركات** — حساباتك
* **الفرص** — صفقاتك
فكّر فيما قد تحتاج إليه أيضًا:
* ستحتاج Stripe إلى كائن `Subscriptions`
* ستحتاج Airbnb إلى كائن `Trips`
* ستحتاج مُسرِّعة أعمال إلى كائن `Batches`
### ٢. استخدم الحقول للاختلافات، وليس كائنات جديدة
إذا كان الشيء مجرد سمة لكائن موجود، فاجعله **حقلًا**.
**استخدم الحقول من أجل:**
* الفئات والوسوم (مثل `Industry` للشركات)
* قيم الحالة (مثل `Stage` للفرص)
* السمات والخصائص
### ٣. أنشئ كائنًا عندما يكون قائمًا بذاته
إذا كان للمفهوم دورة حياة أو خصائص أو علاقات خاصة به، فهو يستحق كائنًا مستقلًا.
**أنشئ كائنًا من أجل:**
* **المشروعات** — لها مواعيد نهائية ومالكون ومهام
* **الاشتراكات** — تربط بين الشركات والمنتجات والفواتير
* **الأحداث** — تتضمن الحضور وإجراءات المتابعة
تتجاوز هذه الأشياء مجرد ما يمكن تضمينه في حقل واحد لأنها تحمل بياناتها وعلاقاتها الخاصة.
### 4. أنشئ كائنًا عندما تكون السجلات مفتوحة وغير محددة العدد
إذا كان بالإمكان ربط الشيء مراتٍ متعددة ولا تعرف عددها، فاستخدم كائنًا.
**نهج غير جيد:**
إنشاء حقول مثل `Product 1`، `Product 2`، `Product 3`...
**نهج جيد:**
أنشئ كائنًا `Products` واربطه بالسجلات. يسمح ذلك بدعم منتج واحد أو اثنين أو حتى مائة منتج دون تغيير نموذجك.
### 5. حافظ على البساطة أولًا
ابدأ بالحقول. انتقل إلى كائنات جديدة فقط عندما تشعر بالقيود:
* عدد كبير جدًا من الحقول في كائن واحد
* سجلات مكررة يجب أن تكون منفصلة
* علاقات لا تتلاءم بسلاسة
## ملاحظة خاصة على الأشخاص، والشركات، والفرص
<Warning>
**تعمل مزامنة البريد الإلكتروني والتقويم فقط مع الأشخاص والشركات والفرص.**
هذه هي الكائنات الوحيدة التي يمكنك من خلالها الوصول إلى رسائل البريد الإلكتروني والاجتماعات المتزامنة من علبة البريد/التقويم لديك. نوصي باستخدامها قدر الإمكان.
</Warning>
**أفضل الممارسات:**
* إذا كنت بحاجة إلى تصنيفات للأشخاص، فاستخدم الحقول (وليس كائنات جديدة)
* مثال: استخدم حقل `Person Type` بقيم "عميل محتمل" و"شريك" بدلاً من إنشاء كائنات منفصلة
* أنشئ **عروضًا** مختلفة من أجل التصفية: أحدها يعرض الشركاء، وآخر يعرض العملاء المحتملين
**لا بأس بوجود حقول لا تنطبق على كل سجل.** على سبيل المثال، حقل `Referral Link` على الأشخاص ينطبق فقط عندما يكون `Person Type = Partner`. أخفِ هذا الحقل من العروض التي لا تكون ذات صلة.
## أسئلة لتوجيه اختيارك
اسأل نفسك:
<Check>هل هذه مجرد خاصية لشيء لدي بالفعل، أم أنها تحتاج إلى خصائص خاصة بها؟</Check>
<Check>هل سأحتاج يومًا إلى تتبّع عدة منها لكل سجل، دون معرفة عددها؟</Check>
<Check>هل يرتبط هذا المفهوم بعدة كائنات مختلفة، وليس بواحد فقط؟</Check>
<Check>هل ستكون له دورة حياة خاصة به (مراحل، تواريخ بدء/انتهاء)؟</Check>
إذا كانت الإجابة "نعم" على واحد أو أكثر، فربما حان الوقت لإنشاء كائن جديد.
## الوصول إلى نموذج البيانات الخاص بك
1. انتقل إلى **الإعدادات** في الشريط الجانبي الأيسر
2. انقر على **نموذج البيانات**
3. اعرض جميع كائناتك (القياسية والمخصصة)
4. انقر على أي كائن لعرض حقوله وتحريرها
<Note>
**لا ترى نموذج البيانات ضمن الإعدادات؟**
يكون الوصول إلى نموذج البيانات عادةً مقصورًا على المسؤولين. تواصل مع مشرف مساحة العمل إذا كنت بحاجة إلى الوصول.
</Note>
## الخطوات التالية
بعد أن تخطّط لنموذج البيانات الخاص بك:
* [كيفية إنشاء كائنات مخصصة](/l/ar/user-guide/data-model/how-tos/create-custom-objects)
* [كيفية إنشاء حقول مخصصة](/l/ar/user-guide/data-model/how-tos/create-custom-fields)
* [كيفية إنشاء حقول العلاقات](/l/ar/user-guide/data-model/how-tos/create-relation-fields)
## هل تحتاج إلى مساعدة؟
<Tip>
هل تريد مساعدة في تصميم نموذج البيانات الخاص بك؟ [اعثر على عشرين شريكا معتمدا](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-data-model) لتصميم وبناء الكائنات والحقول والعلاقات الخاصة بك.
</Tip>