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

قالب واحد، يتم إنشاؤه لشخص محدد، وفتحه كصفحة قابلة للطباعة.

ما ستتعلّمه

يُضيف كل فصل قدرة واحدة. بنهاية الدليل ستكون قد تعاملت مع معظم حزمة تطوير البرمجيات (SDK).

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

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

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

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

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

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

ابدأ البناء →

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