الإضافات¶

يقوم متجر الإضافات (الإدارة ← الإضافات) بتثبيت إضافات موقّعة من المورّد تضيف قدرات خاصة بالعميل — محتوى إضافيًا للنموذج الفوقي، وتكاملات، ومهام خلفية، وحتى صفحات جديدة — دون تغيير نواة Turbo EA (مبدأ «clean core»).

يمكن تثبيت الإضافات بطريقتين: بنقرة واحدة من المتجر المدمج (إذا كان المثيل متصلاً بالإنترنت) أو عبر رفع الملفات مباشرةً — الإضافة حزمة .teax موقّعة، والترخيص ملف نصي موقّع، ويُرسَل كلاهما عادةً عبر البريد الإلكتروني. لا يتطلب المسار المعتمد على الملفات حساب متجر أو اتصالاً خارجيًا، لذا تعمل العملية بالكامل بالشكل نفسه على الأنظمة المعزولة عن الإنترنت (air-gapped).

تحتوي الصفحة على تبويبين: المتجر لتصفح كتالوج ملحقات المورّد مع تثبيت بنقرة واحدة، والمثبَّتة لإدارة الرخص والتثبيت من الملفات.

تُبنى الإضافات وتُوقَّع من قِبل Turbo EA — فهي ليست ذاتية البناء ولا مفتوحة لأطراف ثالثة. إذا كنت بحاجة إلى ميزة مُصمَّمة خصيصًا لمؤسستك، يمكننا بناؤها وترخيصها لك. راجع استشارات Turbo EA.

كيف تعمل الثقة¶

تحمي نظامك عمليتا تحقق مستقلتان:

المصدر (التوقيع). تحمل كل حزمة توقيع Ed25519 بمفتاح المورّد. يتحقق Turbo EA منه عند الرفع ومرة أخرى عند كل تشغيل للخادم الخلفي. تُرفض الحزم غير الموقّعة أو المعدّلة أو الصادرة عن طرف ثالث — فالإضافة المثبّتة مضمونة بأنها تمامًا ما بناه المورّد.
التفعيل (الترخيص). يسرد ملف الترخيص الموقّع استحقاقاتك — واحد لكل إضافة، ولكل منها تاريخ انتهاء خاص. لا تعمل الإضافة المثبّتة إلا ما دام هناك استحقاق صالح. الرخص مرتبطة بمعرّف مثيلك — تُرفض أي رخصة صادرة لمثيل آخر.

معرّف المثيل الخاص بك¶

تولّد كل عملية تثبيت مرة واحدة معرّف مثيل فريدًا (TEA-XXXX-XXXX-XXXX) يظهر أعلى صفحة الإدارة ← الإضافات مع زر نسخ. إنه هويتك الترخيصية: اذكره عند الشراء (يرسله المتجر المدمج تلقائيًا؛ وتطلبه صفحة الدفع في المتجر الإلكتروني) بحيث تجتمع كل إضافة تُشترى لهذا المثيل — من أي مسؤول وبأي بريد إلكتروني — في رخصة واحدة موحّدة. وهو يعرّف مثيلك فحسب؛ وليس بيانات اعتماد أبدًا، لذا يمكن مشاركته مع المورّد بأمان.

ينتقل المعرّف مع نقل مساحة العمل، لذا يبقى الترخيص صالحًا عند الانتقال إلى مضيف جديد. بعد إعادة تثبيت كاملة يحصل المثيل على معرّف جديد — اطلب من المورّد إعادة إصدار الرخصة له (عملية «re-key» سريعة من جانبه).

تبويب المتجر¶

يعمل تبويب المتجر دون أي تكوين ويعرض الملحقات المنشورة من المورّد مع الوصف والسعر:

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

تبويب المتجر للقراءة فقط ومجهول الهوية: لا حساب ولا رمز، ولا يُرسل أي شيء عن مثيلك — تُقرأ فقط قائمة المورّد العامة. أما المثيلات المعزولة فلا تحتاج إلى أي تكوين — يعرض التبويب عندها ببساطة تلميحًا وديًا — وتستخدم المسار المعتمد على الملفات أدناه؛ ويوفر موقع متجر المورّد نفس عمليات الشراء والتنزيل من أي متصفح متصل بالإنترنت.

تثبيت إضافة¶

إن لم تكن قد فعلت ذلك بعد، طبّق ترخيصك أولًا (انظر أدناه).
افتح الإدارة ← الإضافات، واختر التثبيت من ملف… في تبويب المتجر، ثم ارفع ملف .teax الذي تلقيته.
يتحقق Turbo EA من التوقيع ويعرض معاينة: للإضافات الحاملة للمحتوى تكون تجربة جافة لكل نوع بطاقة ومجموعة وسوم وبطاقة وعلاقة ستنشئها الإضافة أو تحدّثها — لا يُكتب شيء بعد.
راجع المعاينة ثم اضغط تثبيت الإضافة.
إذا كانت الإضافة تحمل شيفرة خلفية أو واجهة، يطلب شريط تنبيه إعادة تشغيل حاوية الخادم الخلفي (docker compose restart backend). أما إضافات المحتوى فقط فتصبح فعّالة فورًا.

رفع الحزمة نفسها مرة أخرى آمن — تعرض المعاينة كل شيء كـ«تم تخطيه» ولا يغيّر التطبيق شيئًا.

التراخيص والتجديد¶

طبّق الترخيص عبر إدخال الترخيص… في تبويب المثبَّتة (الصق النص أو ارفع الملف) — يظهر الزر أيضًا على كل صف إضافة تحتاج إلى ترخيص. تعرض الصفحة بعدها اسم المرخَّص له وشارة لكل حق مع تاريخ انتهائه.

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

التراخيص المشتراة عبر المتجر تتجدد تلقائيًا على المثيلات المتصلة: بعد كل عملية دفع ناجحة يجلب مثيلك الترخيص الممدد تلقائيًا — لا حاجة للصق أي شيء. أما في نظام معزول فيكون التجديد: الصق ملف الترخيص المحدّث من رسالة التجديد (أو اطلبه من المورّد) — لا شيء آخر.

التفعيل والتعطيل والإزالة¶

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

الصلاحيات¶

الصفحة بأكملها وجميع مسارات API الخاصة بها محمية بالصلاحية المخصصة admin.manage_extensions (الممنوحة لدور المسؤول المدمج). يمكن للإضافات تعريف مفاتيح صلاحيات خاصة بها (ext.<الاسم>.…) تظهر في الإدارة ← المستخدمون والأدوار بعد تحميل الإضافة.

ميزات الحقول المتقدمة¶

تتيح بعض الإضافات طرقًا متقدمة لوصف بياناتك لا توفرها النواة بمفردها:

نص مساعدة الحقل — إرشاد قابل للطي يظهر أسفل الحقل أثناء إدخال البيانات، بحيث يشرح النموذج نفسه.
أنواع حقول مخصصة — أنواع جديدة تتجاوز المجموعة المدمجة (مثل تقييم قابل للتهيئة من ١ إلى ٥ أو من ٠ إلى ١٠).

تظهر هذه الخيارات في محرر حقول النموذج الفوقي فقط طالما أن الإضافة التي توفرها مثبَّتة ومرخَّصة. إذا تم تعطيل هذه الإضافة لاحقًا أو انتهت صلاحية ترخيصها، فستستمر القيم التي أدخلتها بالفعل في الظهور كنص للقراءة فقط — لا يُمحى أو يُحذف شيء — وتختفي خيارات التحرير ببساطة حتى تصبح الإضافة نشطة مرة أخرى.

أين تظهر صفحات الإضافات¶

تظهر صفحات الإضافات في التنقّل بمجرد تثبيت الإضافة وترخيصها — عادةً كعنصر قائمة خاص بها في المستوى الأعلى، رغم أن بعض التقارير تُوضع ضمن قائمة التقارير إلى جانب المدمجة.