تُنظَّم المنصة في طبقات، لكل منها مسؤولية مميزة، مترابطة لا معزولة.
كيفية بناء المنصة
كل طبقة — الحوكمة، المعايير، البنية المعمارية وغيرها — تخصص قائم بذاته، لكن كل طبقة مصممة للعمل مع الأخريات، لا بمعزل عنها.
الطبقات ومسؤولياتها
تحدد الحوكمة حقوق القرار وقواعد التشغيل؛ وتوثّق البنية المعمارية قرارات التصميم المهمة؛ ويجعل التسليم الإصدارات قابلة للتنبؤ وقابلة للتكرار.
كيفية توثيق قرارات البنية المعمارية
تُوثَّق قرارات التصميم المهمة عبر معيار Architecture Decision Record، مع سياقها والمفاضلات التي رافقتها، لا نتيجتها فقط.
أمثلة
تهيئة نموذجية، وجدول ملخّص للمكوّنات، ونظرة عامة موجزة بعلامات تبويب حول كيفية تقديم هذه البنية عادةً لفريق جديد.
تهيئة بيئة بسيطة لتشغيل نسخة محلية من ETES:
ETES_API_URL=https://api.etes.local
ETES_ENV=development
ETES_LOG_LEVEL=info| المكوّن | النوع | الوصف |
|---|---|---|
| API Gateway | خدمة | يوجّه طلبات المنصة الواردة ويتحقق من هويتها. |
| Standards Engine | خدمة | يقيّم المحتوى والتهيئة وفق المعايير الفعّالة. |
| Documentation Store | بيانات | يحتفظ بمحتوى المقالات المؤرشف بالإصدارات وبياناته الوصفية. |
تُنظَّم المنصة ضمن مجموعة صغيرة من الخدمات المتعاونة بدلاً من بنية متجانسة واحدة، بحيث يمكن لكل جانب أن يتطور بشكل مستقل.
تقرأ كل خدمة تهيئتها من متغيرات البيئة عند بدء التشغيل، دون وجود مخزن تهيئة قابل للتغيير مشترك بينها.
تعرض الخدمات واجهة HTTP مُرقَّمة بالإصدارات؛ وتستخدم الاستدعاءات الداخلية بين الخدمات نفس العقود المستخدمة في عمليات التكامل الخارجية.