المتطلبات
خريطة البرنامج
اطّلع على كيفية ارتباط مشاريعك ببعضها، مع عدد الروابط لكل زوج من المشاريع، وتتبّع سلسلة روابط عنصر واحد عبر المشاريع الأخرى.
نظرة عامة
البرنامج الذي يمتد عبر عدة مشاريع (مشروع نظام، ومشاريع أنظمة فرعية، ومشروع اختبار، ومكتبات) تربطه معًا روابط إلى مشاريع أخرى. ويُخزَّن كل رابط في المشروع الذي ينشئه، فلا يعرض أي مشروع منفرد الصورة كاملة. أما خريطة البرنامج فتعرضها: ترسم مربعًا واحدًا لكل مشروع يمكنك فتحه وسهمًا واحدًا لكل زوج من المشاريع، موسومًا بالعلاقة وعدد الروابط.
للصفحة عرضان:
- المشاريع: كل مشروع يمكنك فتحه والروابط بينها، رسمًا بيانيًا أو جدولًا.
- تتبع العنصر: عنصر واحد في الوسط والعناصر المرتبطة به في مشاريع أخرى، حلقة بعد حلقة، حتى ست خطوات.
خريطة البرنامج متاحة لكل من سجّل الدخول. أما الروابط نفسها فتُنشأ في خطة Team؛ وتُرسم باللون الرمادي الروابط المخزنة في مشروع لا تشملها خطة مالكه. وتعمل الروابط بين المشروعين التجريبيين Hybrid Car وHybrid Car Battery Pack في كل خطة.
المفاهيم
ما تعرضه الخريطة
| العنصر | المعنى |
|---|---|
| المربع | مشروع يمكنك فتحه: اسمه ونوعه وعدد عناصره؛ ويضيف اسمه القابل للوصول الروابط التي يحملها ويتلقاها |
| السهم | روابط مخزنة في المشروع عند ذيل السهم تشير إلى عناصر في المشروع عند رأسه |
| تسمية السهم | العلاقة · الروابط · المحذوفة، مثل traced from · 12 · 1 محذوف |
| مشاريع لا يمكنك فتحها (N روابط) | مربع متقطع واحد يعدّ كل رابط إلى مشروع لا يمكنك فتحه |
| مربع إصدار مكتبة | إصدار مكتبة يمكنك قراءته، مرتبط من مشاريعك |
تشير الأسهم عادةً إلى الأعلى: تخزّن مشاريع الأنظمة الفرعية روابط traced from وsatisfies إلى مشروع النظام، وتخزّن مشاريع الاختبار روابط verifies. وتضع الخريطة المشاريع التي تحمل روابط تحت المشاريع التي تشير إليها.
من يرى ماذا
لا تُبنى الخريطة إلا من المشاريع التي يمكنك فتحها: مشروع أنت عضو فيه بأي دور، وليس في سلة المحذوفات، وتستوفي فيه قاعدة تسجيل الدخول بخطوتين لمؤسسته.
- يُحتسب الرابط إلى مشروع لا يمكنك فتحه في مشاريع لا يمكنك فتحها (N روابط). ولا يسمّي ذلك المربع المشروع أو العنصر أبدًا، ويبدو بالشكل نفسه سواء كان المشروع موجودًا أو في سلة المحذوفات أو لم يوجد قط.
- لا تُحتسب الروابط المخزنة في مشروع لا يمكنك فتحه في أي مكان، حتى عندما تشير إلى مشاريعك.
- لا يضيف كونك مسؤولًا عن مؤسسة شيئًا: تستخدم الخريطة عضوية المشروع.
- تحتوي الصادرات (CSV وSVG وPNG) بالضبط على ما تعرضه الصفحة.
الألوان
| اللون | المعنى |
|---|---|
| سهم أزرق | روابط بين مشاريع يمكنك فتحها |
| سهم كهرماني | بعض الأهداف محذوفة (في سلة المحذوفات أو زائلة) |
| سهم رمادي | روابط إلى مشاريع لا يمكنك فتحها، أو إلى إصدار مكتبة، أو مخزنة في مشروع لا تشمل خطة مالكه الروابط إلى مشاريع أخرى |
طريقة استخدامها
رؤية كيف ترتبط مشاريعك
- انقر إدارة المشاريع، ثم خريطة البرنامج. فيُفتح العرض المشاريع بكل مشروع يحمل روابط أو يتلقاها.
- اقرأ الأسهم. وأشر إلى مربع لتعتيم كل ما لا يتصل به.
- انقر سهمًا. فتسرد لوحة الخصائص روابطه، 100 في كل مرة: العنصر الذي يحمل كل رابط، والعلاقة، والعنصر الهدف. انقر أيًا من العنصرين لفتحه في مشروعه، أو إظهار المزيد للمئة التالية.
- انقر تصدير CSV في لوحة الخصائص لحفظ روابط ذلك السهم، أو تصدير ▾ في الشريط لحفظ الخريطة كلها بتنسيق CSV أو SVG أو PNG.
البدء من مشروع واحد
- افتح المشروع، ثم التحقق ← تغطية البرنامج، وانقر فتح خريطة البرنامج.
- لا تعرض الخريطة إلا ذلك المشروع والمشاريع المرتبطة به، مباشرة أو عبر غيرها.
- انقر إظهار كل المشاريع لرؤية كل ما يمكنك فتحه.
يمكنك أيضًا نقر مربع واختيار إظهار المشاريع المرتبطة فقط.
تتبع عنصر واحد عبر البرنامج
- حدّد العنصر. وفي قسم التتبع في لوحة الخصائص، افتح مشاريع أخرى ⋯ واختر عرض في Program Map. أو من قائمة روابط سهم، انقر تتبع هذا العنصر بدلًا من ذلك.
- يعرض العرض تتبع العنصر العنصر في الوسط والعناصر المرتبطة به في حلقات: الحلقة الأولى على بعد خطوة واحدة، والثانية على بعد خطوتين. وتُتبع الروابط في الاتجاهين.
- اختر الخطوات (من 1 إلى 6، والافتراضي 3) للابتعاد أكثر أو البقاء أقرب.
- تُلوَّن العناصر حسب المشروع، مع مربع متقطع حول عناصر كل مشروع. وألغِ تحديد التجميع حسب المشروع لإزالة المربعات.
- انقر عنصرًا لـ فتح العنصر والتتبع من هنا، الذي يضعه في الوسط.
مثال عملي: المشروع التجريبي CubeSat EO-1 ومشروع حمولة
- أنشئ المشروع التجريبي CubeSat EO-1، ثم مشروعًا ثانيًا EO-1 Payload فيه المتطلب PL.1 Imager resolution.
- في EO-1 Payload، حدّد PL.1. وفي التتبع ← مشاريع أخرى، انقر +، واختر traced from، ومشروع CubeSat ومتطلب التصوير فيه، وانقر إضافة رابط.
- أنشئ مشروعًا ثالثًا EO-1 Test Campaign فيه حالة الاختبار TC.4 Resolution test، واربطها بـ verifies إلى PL.1 في EO-1 Payload.
- افتح إدارة المشاريع ← خريطة البرنامج. فتعرض الخريطة EO-1 Test Campaign في الأسفل، وEO-1 Payload فوقه، ومشروع CubeSat في الأعلى، مع السهمين verifies · 1 وtraced from · 1.
- انقر PL.1 ← التتبع ⋯ ← عرض في Program Map: تقع حالة الاختبار ومتطلب CubeSat على بعد خطوة واحدة، على الجانبين.
مثال عملي: Hybrid Car وحزمة بطاريته
- في إدارة المشاريع، انقر ملفات المشروع ▾ ← مشروع توضيحي جديد ← Hybrid Car (SysML v2).
- ثم أنشئ ملفات المشروع ▾ ← مشروع توضيحي جديد ← Hybrid Car Battery Pack (SysML v2). فتكون متطلبات الحزمة لدى مورّد البطاريات PackCapacity وPackMass وChargeAcceptance مرتبطة بـ traced from بمتطلبات السيارة VR-3 وVR-6 وVR-5 في أحدث مشروع تجريبي Hybrid Car لديك، أيًا كان الذي تنشئه أولًا من الاثنين؛ وإعادة إنشاء المشروع التجريبي Hybrid Car تنقل الروابط إلى الجديد. وتعمل هذه الروابط التجريبية في كل خطة. ومن دون مشروع Hybrid Car لا روابط للمشروع التجريبي للحزمة.
- افتح إدارة المشاريع ← خريطة البرنامج. فتعرض الخريطة مشروعي SysML v2 مع السهم traced from · 3.
نصائح وممارسات جيدة
- اتفقوا على العلاقات التي تستخدمها المشاريع الفرعية (traced from أو satisfies للمتطلبات، وverifies للاختبارات) لتُقرأ الأسهم بالطريقة نفسها في كل مكان.
- أوقف تجميع العلاقات لرؤية سهم واحد لكل علاقة، مثلًا لتمييز روابط المتطلبات من روابط الاختبارات بين المشروعين أنفسهما.
- اسحب المربعات لترتيب الخريطة. وتُحفظ المواضع في هذا المتصفح لكل نطاق.
- استخدم العرض الجدول لفرز أزواج المشاريع حسب عدد الروابط أو الأهداف المحذوفة.
- يعني السهم الكهرماني روابط تحتاج إلى إصلاح: افتح قائمة روابطه، ثم أصلح الروابط أو أزلها في التتبع ← مشاريع أخرى للعنصر.
أخطاء شائعة
| المشكلة | السبب | الإصلاح |
|---|---|---|
| مشروع مفقود | لست عضوًا فيه، أو هو في سلة المحذوفات، أو لا روابط له | اطلب الوصول من مالكه؛ وحدّد إظهار المشاريع غير المرتبطة لسرد المشاريع التي بلا روابط |
| كل شيء يذهب إلى مشاريع لا يمكنك فتحها | تشير الروابط إلى مشاريع لست عضوًا فيها | اطلب الوصول من مالك المشروع |
| أسهم رمادية في وسط الخريطة | المشروع الذي يحمل الروابط مالكه ليس على خطة Team | يرقّي المالك خطته في إعدادات الحساب ← الخطة والفوترة |
| رابط جديد لا يظهر بعد | لا تزال الخريطة تقرأ التغييرات الأخيرة | انقر تحديث بعد دقيقة |
كيف يرتبط بالميزات الأخرى
- الروابط إلى مشاريع أخرى: تقرؤها الخريطة؛ ولا تضيف شيئًا ولا تغيّره. أنشئ الروابط في التتبع ← مشاريع أخرى لعنصر (انظر الروابط إلى مشاريع أخرى).
- تغطية البرنامج: العرض لكل عنصر للروابط إلى مشروع واحد، مع الفجوات (انظر تغطية البرنامج). ويبدأ فتح خريطة البرنامج هناك الخريطة من ذلك المشروع.
- المكتبات: تظهر الروابط إلى عنصر في إصدار مكتبة أسهمًا إلى مربع الإصدار (انظر المكتبات).
- مخطط Spider: التتبع داخل مشروع، مع مربعات متقطعة للعناصر المرتبطة في أماكن أخرى. ويستخدم تتبع العنصر تخطيط الحلقات نفسه.
- API وMCP: الخريطة والتتبع نفسيهما للأدوات (انظر API وMCP).
صفحة خريطة البرنامج
الشريط
| عنصر التحكم | ما الذي يفعله |
|---|---|
| المشاريع / تتبع العنصر | يبدّل العرض |
| النطاق | كل مشاريعي، أو مؤسسة واحدة (عندما تنتمي إلى واحدة)، أو مجلد واحد بمجلداته الفرعية (عندما تكون لديك مجلدات؛ انظر مجلدات المشاريع) |
| إظهار كل المشاريع | يظهر بعد فتح الخريطة من مشروع؛ ويغادر مجموعة ذلك المشروع المرتبطة |
| إظهار المشاريع غير المرتبطة | يعرض أيضًا المشاريع التي بلا روابط |
| تجميع العلاقات | سهم واحد لكل زوج من المشاريع (تسرد التسميات كل علاقة)، أو سهم واحد لكل علاقة |
| الخطوات | تتبع العنصر: من 1 إلى 6 خطوات |
| التجميع حسب المشروع | تتبع العنصر: مربعات متقطعة حول عناصر كل مشروع |
| الرسم البياني / الجدول | المخطط أو جدول قابل للفرز؛ وعلى شاشة ضيقة يُفتح الجدول أولًا |
| تحديث | يقرأ الروابط مرة أخرى |
| تصدير ▾ | تصدير CSV، تصدير SVG، تصدير PNG |
الرسم البياني
- انقر مربعًا لعرض مشروعه في لوحة الخصائص: فتح المشروع وإظهار المشاريع المرتبطة فقط. وانقر نقرًا مزدوجًا على مربع، أو اضغط Shift+Enter عليه، لفتح المشروع.
- انقر سهمًا لسرد روابطه في لوحة الخصائص.
- اسحب المربعات لتحريكها؛ ومرّر أو اقرص للتكبير والتصغير؛ واسحب الخلفية للتحريك.
- اضغط Tab للوصول إلى الخريطة، ثم مفاتيح الأسهم للتنقل بين المربعات والأسهم؛ وينتقل Enter إلى لوحة الخصائص. ولكل مربع وسهم اسم يقرؤه قارئ الشاشة، مثل “EO-1 Payload، مشروع LML، رابط واحد صادر، و1 وارد”.
الجدول
| العرض | الأعمدة |
|---|---|
| المشاريع | مشروع المصدر، العلاقة، المشروع الهدف، الروابط، المحذوفة |
| تتبع العنصر | المشروع، Number، الاسم، الفئة، الخطوات من العنصر، الحالة |
انقر عنوان عمود للفرز.
لوحة الخصائص
| التحديد | المحتويات |
|---|---|
| مربع المشروع | الاسم، والنوع، وعدد العناصر، والروابط الصادرة والواردة؛ فتح المشروع، إظهار المشاريع المرتبطة فقط |
| السهم | مشروعا المصدر والهدف، والروابط لكل علاقة، وقائمة الروابط (100 في كل مرة، إظهار المزيد)، وتصدير CSV، وتتبع هذا العنصر لكل صف |
| العنصر (تتبع العنصر) | الرقم والاسم، والفئة، والمشروع، والخطوات من العنصر المتتبَّع، والحالة؛ فتح العنصر، التتبع من هنا |
| مشاريع لا يمكنك فتحها | “روابط إلى مشاريع لا يمكنك فتحها. اطلب الوصول من مالك المشروع.” |
API وMCP
يقدّم REST API وMCP الإجابات نفسها بصلاحيات وصول الرمز المميز نفسه وقائمة مشاريعه. وتُستبعد مشاريع المؤسسة التي أوقفت الوصول عبر API، مثل المشاريع التي لا يمكنك فتحها.
| الاستدعاء | يُرجع |
|---|---|
GET /api/v1/program-map | المشاريع والإصدارات والأسهم (from، to، relation، links، deleted، plan) والعدد المخفي؛ وfrom وunlinked وorg كما في الصفحة |
GET /api/v1/projects/<project>/items/<item>/trace | تتبع العنصر: العقد بالمشروع والرقم والاسم والفئة والخطوات، والروابط بينها، والعدد المخفي؛ وsteps من 1 إلى 6 (الافتراضي 3) |
MCP program_map | مثل GET /program-map |
MCP trace_chain | مثل استدعاء التتبع؛ وتجيب العناصر في المشاريع ذات وسوم البيانات المنظَّمة بـ withheld |
انظر API وMCP.
الرسائل
| الرسالة | المعنى |
|---|---|
| لا روابط بين مشاريعك. أضف واحدًا من قسم التتبع لعنصر. | لا يحمل أي من مشاريعك رابطًا يمكنك رؤيته ولا يتلقاه |
| لا يحتوي هذا المشروع على روابط إلى مشاريع أخرى. أضف واحدًا من قسم التتبع لعنصر. | فُتحت الخريطة من مشروع بلا روابط |
| لا يحتوي هذا العنصر على روابط إلى مشاريع أخرى. أضف واحدًا من قسم التتبع الخاص به. | لا روابط للعنصر المتتبَّع |
| لا تزال بعض المشاريع قيد القراءة. حدّث بعد دقيقة. | لا تزال التغييرات الأخيرة في المشاريع الكبيرة قيد القراءة؛ وتعرض الخريطة ما هو جاهز |
| يُعرض أول 500 عنصر. قلّل الخطوات. | بلغ تتبع العنصر حده |
| لا تُتبع N روابط من مشاريع لا تشمل خطة مالكها الروابط إلى مشاريع أخرى. | تخطى تتبع العنصر روابط مخزنة في ظل خطة لا تشملها |
| تعذّرت قراءة خريطة البرنامج. أعد تحميل الصفحة. | فشل الطلب |
الحدود
| الحد | القيمة |
|---|---|
| خطوات تتبع العنصر | 1 إلى 6 |
| العناصر في تتبع العنصر | 500 |
| الروابط المسرودة لكل صفحة في قائمة السهم | 100 |
| الروابط لكل مشروع | 20,000 (انظر الروابط إلى مشاريع أخرى) |