// tier: serverfactory-tertiary · order 33

Server Factory — Additional Components mixedlicense: UNVERIFIED

Kotlin (service factories, on Core Framework)Shell (Utils, Definitions packs)GradleDocker (target runtime)SSH / OpenSSH (Utils bootstrap)SonarQube

Source

Server Factory — Additional Components Family tree Data vs engine · bootstrap Maturity: solid = flagship (Mail) · dashed = early-stage service factories (UNVERIFIED) Core Framework Kotlin engine Mail Factory flagship Web Service Factory early-stage SonarQube Factory early-stage Caching-Proxy Factory early-stage Definitions packs Docker · Stack · Software Utils init_ssh_access.sh bootstrap
// architecture

الشخصيات الداعمة في سلسلة أدوات التزويد Server Factory

إلى جانب Mail Server Factory وإطار العمل الأساسي، تضم منظمة Server-Factory العديد من المكونات الأصغر: "مصانع" لكل خدمة على حدة (خدمة الويب، SonarQube، خادم البروكسي للتخزين المؤقت)، وحزم التكوين التقريري (Docker/Stack/تعريفات البرمجيات)، وأدوات مساعدة مشتركة (Utils). تجمع هذه الصفحة كل هذه المكونات بعرض صادق—إذ إن بعضها في مراحل مبكرة أو مجرد وثائق أولية—بدلاً من تقديمها كمنتجات مكتملة المواصفات.

مجموعة من المستودعات الداعمة لـ Server Factory: Web-Service-Factory، وSonarQube-Factory، وCaching-Proxy-Factory (أدوات تزويد لكل خدمة، معظمها في مراحل مبكرة)؛ وDocker/Stack/Software-Definitions (حزم التكوين التقريري التي يستهلكها الإطار)؛ وUtils (مساعدات الوصول لـ SSH وأدوات عامة). جميعها مبنية على إطار العمل الأساسي.

تجمع هذه الصفحة بقية مستودعات Server-Factory لأن معظمها، بشكل فردي، صغير أو مقصود به أن يكون غير موثق بشكل كامل، وعرض كل منها كمنتج نهائي قد يوحي بنضجه أكثر مما هو عليه في الواقع. تندرج هذه المكونات في ثلاث مجموعات. مصانع الخدمات تتبع نمط Mail Server Factory لأدوار الخوادم الأخرى: Caching-Proxy-Factory ("شغّل خادم البروكسي للتخزين المؤقت الخاص بك") يسرد البروكسي للتخزين المؤقت، وشهادة موقعة ذاتياً، ونقطة نهاية HTTP للحصول على شهادة الأمان كميزات رئيسية؛ أما SonarQube-Factory ("شغّل خادم SonarQube الخاص بك") فموجهة لاستخدامات تطوير البرمجيات؛ وWeb-Service-Factory تنشئ وتضبط خادم ويب لنشر أهداف مثل المواقع الإلكترونية والخدمات المصغرة. جميعها مشاريع Kotlin مبنية على إطار العمل الأساسي، لكن ملفات README العامة فيها غالباً ما تكون مجرد نصوص مؤقتة ("سيتم تحديده لاحقاً" بالنسبة للتوافق والمواصفات والإعداد والاستخدام)—لذا فإن قدراتها الفعلية تتجاوز ما هو مذكور في الغرض المعلن غير مؤكدة. حزم التعريفاتDocker-Definitions، وStack-Definitions، وSoftware-Definitions—هي مستودعات تكوين تقريري يستهلكها الإطار لمعرفة كيفية بناء/نشر صور Docker، والمكدسات، والبرمجيات؛ وهي حزم بيانات مرتبطة بإصدارات محددة وليست تطبيقات. أما Utils فتوفر مساعدات عامة للعائلة، بما في ذلك نص init_ssh_access.sh الذي يولد مفتاح SSH وينصبه على مضيف بعيد لتمكين الوصول الجذري بدون كلمة مرور لأغراض التزويد اللاحقة. معاً، تكمل هذه المكونات سلسلة أدوات التزويد حول الرائد Mail Server Factory.

نموذج Server Factory مصمم للتعميم: فبمجرد أن تتمكن من تزويد خادم بريد من وصف تقريري، ينبغي للمحرك نفسه أن يكون قادراً على تزويد خوادم الويب، وخوادم البروكسي للتخزين المؤقت، وخوادم جودة الكود أيضاً—باستخدام حزم تعريفات قابلة لإعادة الاستخدام وأدوات مشتركة بدلاً من منطق مخصص لكل دور. هذه المستودعات هي هذا التعميم قيد التنفيذ، حيث توسع النمط المثبت ليشمل أنواعاً جديدة من الخوادم. قيمتها هنا تكمن في كونها دليلاً على مدى وصول النموذج؛ أما نضجها فيختلف، وهذه الصفحة واضحة عمداً بشأن أي منها يمثل توجهاً وأي منها مكتمل.

المحتوى

كمجموعة، تُظهر هذه العناصر قابلية إعادة استخدام الإطار الأساسي عبر أنواع الخوادم المختلفة، وتفصل بين البيانات التصريحية (التعريفات) والتنفيذ (المصانع). أما على المستوى الفردي، فإن مصانع الخدمات لا تزال في مراحلها الأولى ويجب تقديمها كوجهة نظر، لا كمنتجات نهائية.

  • إطار توفير واحد مُعمَّم عبر أدوار البريد الإلكتروني، الويب، الخادم الوكيل للتخزين المؤقت، ودور SonarQube.
  • حزم التعريفات التصريحية (Docker/المكدس/البرمجيات) منفصلة عن محرك التنفيذ.
  • أدوات مشتركة (مثل أداة الإقلاع بدون كلمة مرور SSH بضغطة زر واحدة) تُعاد استخدامها عبر المصانع.

  • إعادة استخدام محرك واحد عبر أدوار الخوادم المختلفة: تم التعامل معها من خلال بناء كل مصنع على الإطار الأساسي.
  • فصل التهيئة عن الكود: تم التعامل معها عبر مستودعات التعريفات كحزم بيانات مرتبطة بإصدارات محددة.
  • (غير مُتحقق منه): ملفات README الخاصة بمصانع الخدمات هي مجرد نصوص مؤقتة؛ ولا يمكن التحقق من اكتمال تنفيذها من الوثائق العامة — يجب تقديمها كمراحل أولية.

  • Kotlin — مصنع خدمة الويب، مصنع SonarQube، ومصنع الخادم الوكيل للتخزين المؤقت (مبني على الإطار الأساسي).
  • Shell — الأدوات وحزم التعريفات (سكريبتات/تهيئة).
  • Gradle — تدفق البناء والاختبار عبر المصانع باستخدام ./gradlew test.
  • Docker — بيئة التشغيل المستهدفة الموصوفة بتعريفات Docker.
  • SSH / OpenSSH — أداة الإقلاع للوصول بدون كلمة مرور.
  • SonarQube — الخادم الذي يُهيئه مصنع SonarQube (والذي يُظهر Mail Server Factory بوابة نظيفة أمامه).

ملاحظة حول الشفافية: معظم هذه المستودعات هي نسخ فرعية داخل المؤسسة؛ ومصانع الخدمات موثقة بشكل مؤقت ومُعلّمة بأنها غير مُتحقق منها وفقاً للمادة 11.4.6 من الدستور. وتُصنّف بوضوح دون مستوى Mail Server Factory والإطار الأساسي.