كتالوج المبادئ

يأتي Turbo EA مزوّدًا بـ كتالوج مبادئ هندسة المؤسسة المرجعي — وهو مجموعة منسَّقة من مبادئ الهندسة المستمدّة من TOGAF والمراجع الصناعية المجاورة، تتم صيانتها إلى جانب كتالوجات القدرات والعمليات وتدفّق القيمة على github.com/vincentmakes/turbo-ea-capabilities. تتيح لك صفحة كتالوج المبادئ تصفّح هذا المرجع واستيراد المبادئ المطابقة إلى نموذجك الفوقي الخاص بالجملة، بدلًا من كتابة كل بيان ومبرّر ومجموعة تبعات يدويًا.

فتح الصفحة

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

ما تراه

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

تحديد المبادئ

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

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

استيراد المبادئ بالجملة

عند تحديد مبدأ واحد أو أكثر، يظهر زر ثابت استيراد N مبدأ في أسفل الصفحة. وهو يستخدم إذن admin.metamodel نفسه كباقي الصفحة.

عند التأكيد، يقوم Turbo EA بما يلي:

• ينشئ صفّ EAPrinciple واحدًا لكل إدخال كتالوج محدَّد، ناسخًا العنوان والوصف والمبرّر والتبعات حرفيًا.
• يطبع على كل مبدأ جديد catalogue_id وcatalogue_version لتتمكّن من تتبّع مصدره ولتبقى مطابقة علامة الصحّ الخضراء قائمة حتى بعد التعديلات اللاحقة.
• يتجاوز المطابقات الموجودة بصمت. يعرض مربّع حوار النتائج عدد المبادئ التي تم إنشاؤها وعدد ما تم تجاوزه.

تكرار نفس الاستيراد آمن — فهو عملية غير قابلة للتكرار التأثير (idempotent).

بعد الاستيراد، عدّل المبادئ من الإدارة ← النموذج الفوقي ← المبادئ لتكييف الصياغة أو ترتيب الفرز مع منظمتك. النص المستورَد هو نقطة انطلاق؛ وقائمة المبادئ في صفحة المسؤول تلك هي المكان الذي ستواصل فيه صيانة الكتالوج مستقبلًا.

تحديث الكتالوج (المسؤولون)

يأتي الكتالوج مضمّنًا كتبعية Python، لذا تعمل الصفحة دون اتصال / في عمليات النشر المعزولة. ويمكن للمسؤولين سحب إصدار أحدث عند الطلب من صفحات كتالوج القدرات أو العمليات أو تدفّق القيمة — يُحمِّل تنزيل العجلة نفسه ذاكرة المبادئ المؤقّتة في الوقت نفسه، لذا فإن تحديث أي واحد من الكتالوجات المرجعية الأربعة من أي من الصفحات الأربع يُحدِّثها جميعًا.

عنوان URL لفهرس PyPI قابل للتهيئة عبر متغيّر البيئة CAPABILITY_CATALOGUE_PYPI_URL (اسم المتغيّر مشترك بين الكتالوجات الأربعة جميعًا — تغطّيها العجلة جميعًا).