Skip to main content

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 الاصطناعي بقدرات مخصّصة
  • العروض والتنقّل — عروض محفوظة مُعدّة مسبقًا وروابط الشريط الجانبي

البدء السريع

npx create-twenty-app@latest my-twenty-app
cd my-twenty-app
yarn twenty dev
يُنشئ هذا هيكل تطبيق جديدًا، ويبدأ اختياريًا خادم 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()يعمل بعد تثبيت التطبيق

سير عمل التطوير

  1. yarn twenty dev — يراقب ملفات المصدر، ويعيد البناء عند التغيير، ويُزامن مع الخادم، ويولّد عملاء API بأنواع محددة
  2. yarn twenty build — ينتج إصدارًا قابلًا للتوزيع
  3. yarn twenty deploy — ينشر إلى خادم Twenty بعيد
  4. yarn twenty add — ينشئ هيكلًا لكيان جديد تفاعليًا

مرجع CLI

yarn twenty help          # عرض جميع الأوامر
yarn twenty server start  # بدء خادم التطوير المحلي
yarn twenty remote add    # الاتصال بخادم Twenty
yarn twenty exec -n fn    # تنفيذ دالة المنطق
yarn twenty logs -n fn    # بث سجلات الدالة
اطّلع على دليل البدء للاطلاع على مرجع CLI الكامل.