---
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 الكامل.