ما ستبنيه
في هذا الدليل التعليمي ستقوم بإنشاء مولِّد المستندات — تطبيق يحوِّل القوالب القابلة لإعادة الاستخدام إلى مستندات مخصَّصة باستخدام البيانات الموجودة مسبقًا في نظام إدارة علاقات العملاء (CRM) لديك. اكتب قالبًا مرة واحدة باستخدام{{placeholders}}، ثم أنشئ مستندًا مكتمل الحقول لأي شخص أو شركة بنقرة واحدة — من قائمة الأوامر، أو من وكيل ذكاء اصطناعي، أو من سير عمل.
قالب واحد، يتم إنشاؤه لشخص محدد، وفتحه كصفحة قابلة للطباعة.
ما ستتعلّمه
يُضيف كل فصل قدرة واحدة. بنهاية الدليل ستكون قد تعاملت مع معظم حزمة تطوير البرمجيات (SDK).المتطلبات الأساسية
ينبغي أن تكون قد أنهيت البدء السريع: مساحة عمل Twenty (سحابية أو محلية) وواجهة سطر الأوامر CLI مُصادَق عليها للوصول إليها. إذا لم يكن الخادم أو المصادقة جاهزًا، فأكمل البدء السريع أولًا. ثم أنشئ تطبيق الدرس التطبيقي وثبّته:تفضّل قراءة الكود النهائي؟ يوجد التطبيق الكامل في
packages/twenty-apps/examples/document-generator.
كل مقتطف أدناه منسوخ منه.كيف تتكامل مكوّنات التطبيق معًا
{{placeholders}}. يؤدي اختيار قالب وسجل في نظام إدارة علاقات العملاء إلى ملء العناصر النائبة وتخزين مستند مصقول (مع ملف PDF). كل ما عدا ذلك — قائمة الأوامر، وكيل الذكاء الاصطناعي،
خطوة سير العمل، الرابط القابل للمشاركة — ما هو إلا طريقة مختلفة لتشغيل هذا
المولّد الواحد.
أبقِ هذه الحلقة قيد التشغيل
اتركtwenty app dev يعمل في أحد الطرفيات طوال الدرس التطبيقي. في كل مرة تُضيف أو تعدّل ملفًا ضمن src/، تُعاد مزامنته مع خادمك خلال بضع ثوانٍ، لكي تتمكّن من مشاهدة كل قدرة تظهر في واجهة المستخدم أثناء بنائها.
ابدأ البناء →
الفصل 1: مستندات نموذجية وقوالب.