كتالوج القدرات¶

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

كتالوج القدرات

فتح الصفحة¶

انقر على أيقونة المستخدم في الزاوية العلوية اليمنى من التطبيق، ثم كتالوج القدرات. الصفحة متاحة لأي شخص يمتلك إذن inventory.view.

ما تراه¶

الترويسة — إصدار الكتالوج النشط، وعدد القدرات التي يحتويها، و(للمسؤولين) عناصر التحكّم للتحقّق من التحديثات وجلبها.
شريط التصفية — بحث نصّي كامل عبر المعرّف والاسم والوصف والأسماء البديلة، إضافةً إلى شرائح المستوى (Macro → L1 → L4)، وقائمة اختيار متعدّد للصناعات، ومفتاح تبديل "إظهار المهمَلة". يبقى مثبَّتًا أسفل شريط التنقّل العلوي أثناء التمرير.
شريط الإجراءات — عدّادات المطابقة، ومنظّم المستوى العام (توسيع/طيّ جميع قدرات L1 مستوى واحدًا في كل مرة)، وتوسيع/طيّ الكل، وتحديد المرئي، ومسح التحديد. يبقى ثابتًا بجانب شريط التصفية لتظلّ عناصر التحكّم في المتناول حتى من داخل شجرة فرعية عميقة من L1.
شبكة L1 — بطاقة واحدة لكل قدرة عُليا المستوى، مجمّعة تحت عناوين الصناعات. تُثبَّت القدرات العابرة للصناعات في الأعلى؛ تليها الصناعات الأخرى أبجديًا؛ وتقع القدرات التي لا تحمل وسم صناعة في سلّة عامة في النهاية. يقع اسم L1 في شريط ترويسة أزرق فاتح؛ وتُسرَد القدرات الفرعية تحته، مع مسافة بادئة وقضيب رأسي خافت لإيصال العمق — وهو نفس أسلوب التسلسل الهرمي المستخدَم في أماكن أخرى من التطبيق، بحيث لا تحمل الصفحة هويتها البصرية الخاصة. تلتفّ الأسماء على عدّة أسطر بدلًا من اقتطاعها. كما تعرض كل ترويسة L1 شارة منظّم − / + الخاصة بها: يفتح + المستوى التالي من الفروع لتلك القدرة L1 فقط، ويُغلق − أعمق مستوى مفتوح. الزرّان مرئيان دائمًا (يُعطَّل الاتجاه غير النشط)، والإجراء مقتصر على تلك القدرة L1 فقط — تبقى الفروع الأخرى على حالها — ولا يتأثّر منظّم المستوى العام في أعلى الصفحة.
زر العودة إلى الأعلى — بمجرّد التمرير لما بعد الترويسة، يظهر سهم عائم دائري في الزاوية السفلية اليمنى. انقر عليه للانزلاق عائدًا إلى أعلى الصفحة. ينزلق تلقائيًا للأعلى لإفساح المجال لشريط إنشاء N قدرة الثابت كلما كان لديك قدرات محدَّدة، بحيث لا يتداخل الاثنان أبدًا.

تحديد القدرات¶

ضع علامة في مربّع الاختيار بجانب أي قدرة لإضافتها إلى التحديد. ينحدر التحديد عبر الشجرة الفرعية في كلا الاتجاهين لكنه لا يمسّ السلف أبدًا:

وضع علامة على قدرة غير محدَّدة يضيفها مع كل فرع قابل للتحديد.
إزالة العلامة عن قدرة محدَّدة يزيلها مع كل فرع قابل للتحديد.

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

تلتقط الصفحة سمة الفاتح/الداكن على مستوى التطبيق تلقائيًا — يعرض الوضع الداكن نفس التخطيط المحايد على ورقة #1e1e1e بنصّ وألوان مميزة بلون الخزامى المرتفع.

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

إنشاء البطاقات بالجملة¶

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

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

ينشئ بطاقة BusinessCapability واحدة لكل إدخال كتالوج محدَّد.
يحافظ على التسلسل الهرمي للكتالوج تلقائيًا — عندما يكون كل من الأصل والطفل محدَّدًا (أو يكون الأصل موجودًا بالفعل محليًا)، يُربَط parent_id للبطاقة الفرعية الجديدة بالبطاقة الصحيحة.
يتجاوز المطابقات الموجودة بصمت. يعرض مربّع حوار النتائج عدد ما تم إنشاؤه وعدد ما تم تجاوزه.
يطبع على attributes كل بطاقة جديدة catalogueId وcatalogueVersion وcatalogueImportedAt وcapabilityLevel لتتمكّن من تتبّع مصدرها.

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

الربط ثنائي الاتجاه. يُصلَح التسلسل الهرمي في كلا الاتجاهين، لذا فإن ترتيب الاستيراد لا يهمّ:

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

القدرات الكبرى (المستوى 0)¶

فوق طبقات L1 / L2 / L3 / L4، يأتي الكتالوج بطبقة كبرى (Macro) إضافية — مجموعة صغيرة من التجميعات على مستوى الأعمال تؤطّر عائلات L1 بأكملها. تشمل الأمثلة Customer Engagement (يؤطّر قدرات L1 للمبيعات والتسويق والخدمة) أو Talent & Workforce (يؤطّر قدرات L1 للموارد البشرية).

القدرات الكبرى هي إدخالات كتالوج من الدرجة الأولى:

تصل إلى مخزونك كبطاقات BusinessCapability مع attributes.capabilityLevel = "Macro" وcatalogueId مسبوق بـ MC- (مثل MC-10).
تقع فوق أطفالها من L1 — يُخفَّف حدّ عمق التسلسل الهرمي من 5 إلى 6 لاستيعاب الطبقة الإضافية (Macro → L1 → L2 → L3 → L4 → L5).
عند استيراد قدرة كبرى، يُعاد تلقائيًا إسناد أي أطفال L1 موجودين مُعلَّمين بانتمائهم إلى تلك القدرة الكبرى تحت البطاقة الجديدة — نفس الربط ثنائي الاتجاه الذي ينطبق بين L1 والطبقات الأدنى.
لا تطابق القدرات الكبرى البطاقات الموجودة بالاسم أبدًا — بل بـ catalogueId فقط. وهذا يتجنّب التصادمات العرضية مع مجموعات القدرات المسمّاة من قِبل العميل والتي يصادف أن تتشارك تسمية مع قدرة كبرى في الكتالوج.

القدرات الكبرى قابلة للتحديد من صفحة الكتالوج تمامًا مثل قدرات L1 — ضع علامة في مربّع الاختيار فتتحدّد الشجرة الفرعية تبعًا لذلك.

عرض التفاصيل¶

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

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

يأتي الكتالوج مضمّنًا كتبعية Python، لذا تعمل الصفحة دون اتصال / في عمليات النشر المعزولة. ويمكن للمسؤولين (admin.metamodel) سحب إصدار أحدث عند الطلب:

انقر على التحقّق من وجود تحديث. يستعلم Turbo EA من واجهة JSON الخاصة بـ PyPI على https://pypi.org/pypi/turbo-ea-capabilities/json ويخبرك بما إذا كان هناك إصدار منشور أحدث متاح. PyPI هو مصدر الحقيقة وقت النشر، لذا تُكتشَف على الفور أي عجلة (wheel) أصبحت متاحة قبل بضع دقائق.
إذا كان الجواب نعم، انقر على زر جلب الإصدار … الذي يظهر. يقوم Turbo EA بتنزيل أحدث عجلة من PyPI، واستخراج حمولة الكتالوج من داخلها، وتخزينها بصفتها تجاوزًا من جانب الخادم، ليصبح ساري المفعول على الفور لجميع المستخدمين.

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

عنوان URL لفهرس PyPI قابل للتهيئة عبر متغيّر البيئة CAPABILITY_CATALOGUE_PYPI_URL لعمليات النشر المعزولة أو المرايا الخاصة.