82 lines
6.2 KiB
Plaintext
82 lines
6.2 KiB
Plaintext
---
|
|
title: تطبيقات Twenty
|
|
description: أنشئ وأدِر تخصيصات Twenty على هيئة كود.
|
|
---
|
|
|
|
<Warning>
|
|
التطبيقات حاليًا في مرحلة الألفا. الميزة تعمل لكنها لا تزال قيد التطور.
|
|
</Warning>
|
|
|
|
## ما هي التطبيقات؟
|
|
|
|
تتيح لك التطبيقات توسيع Twenty باستخدام كائنات وحقول مخصّصة ووظائف منطقية ومكوّنات الواجهة الأمامية ومهارات الذكاء الاصطناعي وغير ذلك — جميعها تُدار ككود. بدلًا من تكوين كل شيء عبر واجهة المستخدم، تعرّف نموذج بياناتك ومنطقك في TypeScript وتقوم بنشره إلى مساحة عمل واحدة أو أكثر.
|
|
|
|
**ما الذي يمكنك بناؤه:**
|
|
|
|
* **الكائنات والحقول المخصّصة** — وسّع نموذج بياناتك بكيانات جديدة أو أضف حقولًا إلى الكائنات الموجودة مثل Company أو Person
|
|
* **الوظائف المنطقية** — وظائف على جانب الخادم يتم تشغيلها بواسطة أحداث قاعدة البيانات، أو جداول cron، أو مسارات HTTP
|
|
* **مكوّنات الواجهة الأمامية** — مكوّنات React تُعرَض داخل واجهة مستخدم Twenty (صفحات السجل، قائمة الأوامر، اللوحات الجانبية)
|
|
* **مهارات ووكلاء الذكاء الاصطناعي** — وسّع ذكاء Twenty الاصطناعي بقدرات مخصّصة
|
|
* **العروض والتنقّل** — عروض محفوظة مُعدّة مسبقًا وروابط الشريط الجانبي
|
|
|
|
## البدء السريع
|
|
|
|
```bash filename="Terminal"
|
|
npx create-twenty-app@latest my-twenty-app
|
|
cd my-twenty-app
|
|
yarn twenty dev
|
|
```
|
|
|
|
يُنشئ هذا هيكل تطبيق جديدًا، ويبدأ اختياريًا خادم Twenty محليًا، ويبدأ في مراقبة ملفاتك لاكتشاف التغييرات. اطّلع على دليل [البدء](/l/ar/developers/extend/apps/getting-started) للحصول على شرح كامل.
|
|
|
|
## أدلة تفصيلية
|
|
|
|
| دليل | الوصف |
|
|
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
|
|
| [البدء](/l/ar/developers/extend/apps/getting-started) | إنشاء هيكل تطبيق، إعداد خادم محلي، بنية المشروع، التكامل المستمر |
|
|
| [بناء التطبيقات](/l/ar/developers/extend/apps/building) | تعريفات الكيانات (`defineObject`, `defineLogicFunction`, `defineFrontComponent`، إلخ)، عملاء API، حزم npm، الأصول العامة، الاختبار |
|
|
| [النشر](/l/ar/developers/extend/apps/publishing) | النشر إلى خادم، النشر إلى npm، السوق |
|
|
|
|
## المفاهيم الأساسية
|
|
|
|
### اكتشاف الكيانات
|
|
|
|
يكتشف SDK الكيانات عبر فحص ملفات TypeScript لديك بحثًا عن استدعاءات `export default define<Entity>({...})`. تسمية الملفات وبنية المجلدات مرنة — يعتمد الاكتشاف على AST وليس على المسارات.
|
|
|
|
### أنواع الكيانات المتاحة
|
|
|
|
| دالة | الغرض |
|
|
| ---------------------------------- | ------------------------------------------------ |
|
|
| `defineApplication()` | بيانات التعريف للتطبيق (مطلوبة، واحدة لكل تطبيق) |
|
|
| `defineObject()` | كائنات مخصّصة مع حقول |
|
|
| `defineField()` | حقول على الكائنات الموجودة |
|
|
| `defineLogicFunction()` | منطق على جانب الخادم مع مشغّلات |
|
|
| `defineFrontComponent()` | مكوّنات React ضمن واجهة مستخدم Twenty |
|
|
| `defineRole()` | أدوار الصلاحيات |
|
|
| `defineView()` | تكوينات العروض المحفوظة |
|
|
| `defineNavigationMenuItem()` | روابط التنقّل في الشريط الجانبي |
|
|
| `defineSkill()` | مهارات وكيل الذكاء الاصطناعي |
|
|
| `defineAgent()` | وكلاء ذكاء اصطناعي مع موجّهات |
|
|
| `definePageLayout()` | تخطيطات صفحات السجل المخصّصة |
|
|
| `definePreInstallLogicFunction()` | يعمل قبل تثبيت التطبيق |
|
|
| `definePostInstallLogicFunction()` | يعمل بعد تثبيت التطبيق |
|
|
|
|
### سير عمل التطوير
|
|
|
|
1. **`yarn twenty dev`** — يراقب ملفات المصدر، ويعيد البناء عند التغيير، ويُزامن مع الخادم، ويولّد عملاء API بأنواع محددة
|
|
2. **`yarn twenty build`** — ينتج إصدارًا قابلًا للتوزيع
|
|
3. **`yarn twenty deploy`** — ينشر إلى خادم Twenty بعيد
|
|
4. **`yarn twenty add`** — ينشئ هيكلًا لكيان جديد تفاعليًا
|
|
|
|
### مرجع CLI
|
|
|
|
```bash filename="Terminal"
|
|
yarn twenty help # عرض جميع الأوامر
|
|
yarn twenty server start # بدء خادم التطوير المحلي
|
|
yarn twenty remote add # الاتصال بخادم Twenty
|
|
yarn twenty exec -n fn # تنفيذ دالة المنطق
|
|
yarn twenty logs -n fn # بث سجلات الدالة
|
|
```
|
|
|
|
اطّلع على دليل [البدء](/l/ar/developers/extend/apps/getting-started) للاطلاع على مرجع CLI الكامل.
|