الانتقال إلى المحتوى الرئيسي
في هذا الدليل التعليمي ستقوم بإنشاء مولِّد المستندات — تطبيق يحوِّل القوالب القابلة لإعادة الاستخدام إلى مستندات مخصَّصة باستخدام البيانات الموجودة مسبقًا في نظام إدارة علاقات العملاء (CRM) لديك. اكتب قالبًا مرة واحدة باستخدام {{placeholders}}، ثم أنشئ مستندًا مكتمل الحقول لأي شخص أو شركة بنقرة واحدة — من قائمة الأوامر، أو من وكيل ذكاء اصطناعي، أو من سير عمل.
مستند عرض مبيعات تم إنشاؤه

​
ما ستتعلّمه

يُضيف كل فصل قدرة واحدة. بنهاية الدليل ستكون قد تعاملت مع معظم حزمة تطوير البرمجيات (SDK).
الفصلالقدرةمرجع
١. نموذج البياناتالكائنات، الحقول، وعلاقة واحدةالبيانات
٢. إنشاء المستنداتدالة منطقية (أداة ذكاء اصطناعي + خطوة سير عمل) تملأ قالب Markdown وتُرفِق ملف PDF مصقولًاالوظائف المنطقية
٣. مسارات HTTPتقديم JSON وصفحة HTML قابلة للمشاركة من المساراتالوظائف المنطقية
4. بناء واجهة المستخدمالعروض، التنقل، قائمة الأوامر، ومكوّنات الواجهة الأمامية التي تُعاين مستندًا وتحرّر قالبًاالتخطيط
5. وكيل ذكاء اصطناعيوكيل + مهارةالمهارات والوكلاء
6. النشرإطلاقه في السوقالنشر

​
المتطلبات الأساسية

يجب أن تكون قد أنهيت قسم البدء السريع: خادم Twenty محلي يعمل على المنفذ 2020 وواجهة سطر أوامر (CLI) موثَّقة عليه. إذا لم تكن قد فعلت ذلك، فقم بتهيئة واحد وتشغيله الآن: 
npx create-twenty-app@latest document-generator
cd document-generator
yarn twenty dev
تفضّل قراءة الكود النهائي؟ يوجد التطبيق الكامل في packages/twenty-apps/examples/document-generator. كل مقتطف أدناه منسوخ منه.

​
كيف تتكامل مكوّنات التطبيق معًا

يُحوَّل قالب يحتوي على عناصر نائبة إلى مستند مصقول مع ملف PDF، ويتم تشغيل ذلك من قائمة الأوامر، أو وكيل ذكاء اصطناعي، أو سير عمل، أو رابط قابل للمشاركة
تكتب قالبًا مرة واحدة في محرّر نص منسّق، مع {{placeholders}}. يؤدي اختيار قالب وسجل في نظام إدارة علاقات العملاء إلى ملء العناصر النائبة وتخزين مستند مصقول (مع ملف PDF). كل ما عدا ذلك — قائمة الأوامر، وكيل الذكاء الاصطناعي، خطوة سير العمل، الرابط القابل للمشاركة — ما هو إلا طريقة مختلفة لتشغيل هذا المولّد الواحد.

​
أبقِ هذه الحلقة قيد التشغيل

اترك الأمر yarn twenty dev يعمل في أحد الطرفيات طوال الدرس التطبيقي. في كل مرة تُضيف أو تعدّل ملفًا ضمن src/، تُعاد مزامنته مع خادمك خلال بضع ثوانٍ، لكي تتمكّن من مشاهدة كل قدرة تظهر في واجهة المستخدم أثناء بنائها.

ابدأ البناء →

الفصل 1: نمذجة المستندات والقوالب.