Documentation Index
Fetch the complete documentation index at: https://docs.twenty.com/llms.txt
Use this file to discover all available pages before exploring further.
ما هي التطبيقات؟
تتيح لك التطبيقات توسيع Twenty باستخدام كائنات وحقول مخصّصة ووظائف منطقية ومكوّنات الواجهة الأمامية ومهارات الذكاء الاصطناعي وغير ذلك — جميعها تُدار ككود. بدلًا من تكوين كل شيء عبر واجهة المستخدم، تعرّف نموذج بياناتك ومنطقك في TypeScript وتقوم بنشره إلى مساحة عمل واحدة أو أكثر. ما الذي يمكنك بناؤه:- الكائنات والحقول المخصّصة — وسّع نموذج بياناتك بكيانات جديدة أو أضف حقولًا إلى الكائنات الموجودة مثل Company أو Person
- الوظائف المنطقية — وظائف على جانب الخادم يتم تشغيلها بواسطة أحداث قاعدة البيانات، أو جداول cron، أو مسارات HTTP
- مكوّنات الواجهة الأمامية — مكوّنات React تُعرَض داخل واجهة مستخدم Twenty (صفحات السجل، قائمة الأوامر، اللوحات الجانبية)
- مهارات ووكلاء الذكاء الاصطناعي — وسّع ذكاء Twenty الاصطناعي بقدرات مخصّصة
- العروض والتنقّل — عروض محفوظة مُعدّة مسبقًا وروابط الشريط الجانبي
البدء السريع
أدلة تفصيلية
| دليل | الوصف |
|---|---|
| البدء | إنشاء هيكل تطبيق، إعداد خادم محلي، بنية المشروع، التكامل المستمر |
| بناء التطبيقات | تعريفات الكيانات (defineObject, defineLogicFunction, defineFrontComponent، إلخ)، عملاء API، حزم npm، الأصول العامة، الاختبار |
| النشر | النشر إلى خادم، النشر إلى npm، السوق |
المفاهيم الأساسية
اكتشاف الكيانات
يكتشف SDK الكيانات عبر فحص ملفات TypeScript لديك بحثًا عن استدعاءاتexport default define<Entity>({...}). تسمية الملفات وبنية المجلدات مرنة — يعتمد الاكتشاف على AST وليس على المسارات.
أنواع الكيانات المتاحة
| دالة | الغرض |
|---|---|
defineApplication() | بيانات التعريف للتطبيق (مطلوبة، واحدة لكل تطبيق) |
defineObject() | كائنات مخصّصة مع حقول |
defineField() | حقول على الكائنات الموجودة |
defineLogicFunction() | منطق على جانب الخادم مع مشغّلات |
defineFrontComponent() | مكوّنات React ضمن واجهة مستخدم Twenty |
defineRole() | أدوار الصلاحيات |
defineView() | تكوينات العروض المحفوظة |
defineNavigationMenuItem() | روابط التنقّل في الشريط الجانبي |
defineSkill() | مهارات وكيل الذكاء الاصطناعي |
defineAgent() | وكلاء ذكاء اصطناعي مع موجّهات |
definePageLayout() | تخطيطات صفحات السجل المخصّصة |
definePreInstallLogicFunction() | يعمل قبل تثبيت التطبيق |
definePostInstallLogicFunction() | يعمل بعد تثبيت التطبيق |
سير عمل التطوير
yarn twenty dev— يراقب ملفات المصدر، ويعيد البناء عند التغيير، ويُزامن مع الخادم، ويولّد عملاء API بأنواع محددةyarn twenty build— ينتج إصدارًا قابلًا للتوزيعyarn twenty deploy— ينشر إلى خادم Twenty بعيدyarn twenty add— ينشئ هيكلًا لكيان جديد تفاعليًا