المفاهيم

كيف تعمل التطبيقات

التطبيق عبارة عن مجموعة من الكيانات يتم إعلانها باستخدام دوال defineEntity() من حزمة twenty-sdk. يكشف CLI هذه الإعلانات عن طريق تحليل AST في وقت البناء وينتج مظاهر - وصف كامل لما يضيفه التطبيق إلى مساحة عمل. تتحقق هذه الدوال من تكوينك وقت البناء وتوفّر إكمالًا تلقائيًا في بيئة التطوير وأمان الأنواع.

your-app/
├── src/
│   ├── application-config.ts    ← defineApplication (required, one per app)
│   ├── roles/                   ← defineRole
│   ├── objects/                 ← defineObject
│   ├── fields/                  ← defineField
│   ├── validation-rules/        ← defineValidationRule
│   ├── logic-functions/         ← defineLogicFunction
│   ├── front-components/        ← defineFrontComponent
│   ├── skills/                  ← defineSkill
│   ├── agents/                  ← defineAgent
│   ├── mcp-servers/             ← defineMcpServer
│   ├── views/                   ← defineView
│   ├── navigation-menu-items/   ← defineNavigationMenuItem
│   ├── settings-menu-items/     ← defineSettingsMenuItem
│   └── page-layouts/            ← definePageLayout
├── public/                      ← Static assets (images, icons)
└── package.json

مؤسسة الملفات متروكة لك. الكشف عن الكيان يستند إلى AST-SDK العثور على ‘تصدير افتراضي تعريف الكيانتي(. .))` مكالمات بغض النظر عن المكان الذي يعيش فيه الملف . بنية المجلدات أعلاه هي اصطلاح وليست متطلبًا.

أنواع الكيانات

كيان	الغرض	وثائق
تطبيق	هوية التطبيق، الدور الافتراضي، والمتغيرات	تهيئة التطبيق
دور	مجموعات الأذونات للكائنات والحقول	الأدوار والأذونات
الكائن	أنواع سجلات مخصّصة مع حقول	الكائنات
الحقل	إضافة حقول إلى الكائنات من تطبيقات أخرى	توسيع الكائنات
علاقة	روابط ثنائية الاتجاه بين الكائنات	العلاقات
قاعدة التحقق	الشروط التي يجب أن يستوفيها السجل قبل أن يمكن حفظه	قواعد التحقق
دالة منطقية	TypeScript على جانب الخادم مع مشغّلات	الوظائف المنطقية
مهارة	تعليمات قابلة لإعادة الاستخدام لوكلاء الذكاء الاصطناعي	المهارات والوكلاء
وكيل	مساعدو الذكاء الاصطناعي بموجهات مخصّصة	المهارات والوكلاء
سير العمل	سير العمل الجاهزة مع تشغيل و خطوات	Workflows
موفر الاتصال	تسجيل الدخول عبر OAuth أو تسجيل دخول مخصص لحسابات تابعة لجهات خارجية	الاتصالات
موفر المراسلة	يرسل الردود من قنوات رسائل التطبيق عبر اتصال	قنوات المراسلة
خادم MCP	خادم MCP خارجي يمكن للذكاء الاصطناعي لمساحة العمل استدعاؤه	المهارات والوكلاء
عرض	عروض قوائم السجلات المكوّنة مسبقًا	العروض
عنصر قائمة التنقّل	عناصر الشريط الجانبي المخصّصة	عناصر قائمة التنقّل
تخطيط الصفحة	علامات التبويب وعناصر الواجهة في صفحة تفاصيل السجل	تخطيطات الصفحات
مكوّن أمامي	واجهة مستخدم React معزولة داخل Twenty	المكوّنات الأمامية
التبعيات المشتركة	التبعيات المشتركة بين مكوّنات الواجهة الأمامية للتطبيق، والمُعرَّفة في package.json	التبعيات المشتركة
عنصر قائمة الأوامر	إجراءات سريعة ومدخلات Cmd+K	عناصر قائمة الأوامر
عنصر قائمة الإعدادات	الإدخالات في قائمة إعدادات التطبيق، كل منها يقدم عنصر واجهة	عناصر قائمة الإعدادات

العزل

الدوال المنطقية تعمل في عمليات Node.js معزولة على الخادم. يمكنهم الوصول إلى البيانات فقط من خلال عميل API المكتوب، الذي يعمل إما كشخص قام بتشغيل التشغيل أو كتطبيق نفسه. انظر الذين وصلوا إلى استخدامات المكالمة.
المكوّنات الأمامية تعمل ضمن Web Workers باستخدام Remote DOM — معزولة عن الصفحة الرئيسية لكنها تعرض عناصر DOM الأصلية (وليس iframes). تتواصل مع Twenty عبر واجهة API للمضيف تعتمد تمرير الرسائل.
الأذونات تُطبَّق على مستوى واجهة API. يتم حقن رمزين لوقت التشغيل، وكلاهما مستمد من الدور المعلن مع defineApplicationRole()؛ يتم تضييق المجال الافتراضي أكثر إلى ما يمكن أن يفعله الشخص المحرك عندما يكون شخص ما وراء اللعب.

دورة حياة التطبيق

┌─────────────────────────────────────────────────────────┐
│ Development                                             │
│   twenty app init → twenty app dev (live sync)   │
├─────────────────────────────────────────────────────────┤
│ Build & Deploy                                          │
│   twenty app build → twenty app publish        │
├─────────────────────────────────────────────────────────┤
│ Install flow                                            │
│   upload → [pre-install] → metadata migration →         │
│   generate SDK → [post-install] → … → [uninstall]       │
├─────────────────────────────────────────────────────────┤
│ Publish                                                 │
│   npm publish → appears in Twenty marketplace           │
└─────────────────────────────────────────────────────────┘

20 تطبيق dev - يشاهد الملفات المصدرية الخاصة بك والمزامنة المباشرة التغييرات على خادم عشرين متصل. بعد مزامنة ناجحة، يعيد إنشاء عميل API مضبوط الأنواع عند تغيير المخطط أو حزمة المُولِّد المثبّتة، أو عند فقدان ملفات العميل المُنشأة أو تغييرها. لتحديث الأنواع بعد تغيير مساحة العمل في واجهة المستخدم، شغّل twenty app generate-client.
بناء عشرين تطبيق - تجميع TypeScript، وحزم الدوال المنطقية والمكونات الأمامية مع esbuild، وإنتاج بيان بياني.
خطّافات ما قبل/ما بعد التثبيت وإلغاء التثبيت — دوال اختيارية تعمل أثناء التثبيت أو مباشرة قبل الإزالة. راجع خطّافات التثبيت للتفاصيل.

الخطوات التالية

تكوين

هوية التطبيق، الدور الافتراضي، والتثبيت وإلغاء روابط التثبيت.

البيانات

كائنات وحقول وعلاقات ثنائية الاتجاه.

المنطق

دوال المنطق، والمهارات، والوكلاء، والاتصالات، وقنوات المراسلة.

تخطيط

مشاهدات، تصفح، تخطيطات الصفحات، المكونات الأمامية.

العمليات

CLI ، اختبار ، إزالة ، CI ونشر التطبيق الخاص بك.

المطورون

التطبيقات

واجهة برمجة التطبيقات

الاستضافة الذاتية

المساهمة

مكتبة واجهة المستخدم

كيف تعمل التطبيقات

أنواع الكيانات

العزل

دورة حياة التطبيق

الخطوات التالية

​كيف تعمل التطبيقات

​أنواع الكيانات

​العزل

​دورة حياة التطبيق

​الخطوات التالية

كيف تعمل التطبيقات

أنواع الكيانات

العزل

دورة حياة التطبيق

الخطوات التالية