Holarch
فصول الدورة

التدريب · المسار 2. المتطلبات والتحقق · الفصل 2.4 من 6

2.4 خطوط الأساس والروابط المطلوب مراجعتها 2:40

جمّد المواصفة في خط أساس، وغيّر متطلبًا، وراجع ما يمسّه التغيير.

يعرض Holarch 2.13.

ما ستتعلمه

  • احفظ خط أساس لمستند مع سجل اعتماد
  • اشرح ما يفعله تغيير متطلب معتمد بحالته وروابطه
  • راجع رابطًا معلَّمًا باستخدام «الفرق» وعلّمه كمُراجَع مع ملاحظة
  • قارن خط أساس بالإصدار الحالي وصدّر التغييرات

جمّد مواصفة Bike-Share Dock في خط أساس مع اعتماد، وغيّر متطلبًا معتمدًا، وشاهده يعود إلى المراجعة وروابطه معلَّمة للمراجعة، وراجع الرابط وعلّمه كمُراجَع مع ملاحظة، واعرض كل تغيير منذ خط الأساس.

ملفات المشاريع

  • مشروع البداية (.holarch.json؛ إدارة المشاريع ← ملفات المشروع ▾ ← استيراد مشروع (.json)…)
  • المشروع المكتمل (.holarch.json؛ إدارة المشاريع ← ملفات المشروع ▾ ← استيراد مشروع (.json)…)

يُشغَّل الفيديو من holarch.app؛ راجع سياسة الخصوصية.

التطبيق العملي

نفّذ هذا بنفسك في Holarch، على المشروع التوضيحي CubeSat EO-1.

  1. افتح مشروع EO-1 التوضيحي الخاص بك (أو أنشئه: إدارة المشاريع ← ملفات المشروع ▾ ← مشروع توضيحي جديد ← CubeSat (هندسة أنظمة موجّهة)).
  2. افتح EO-1 System Requirements Specification، وانقر الإصدار ▾ في كتلة العنوان واختر حفظ خط الأساس…. سمّه PDR Baseline، واملأ صف معتمِد واحدًا باسمك ودورك، ثم انقر إنشاء.
  3. غيّر 3.3 Depth of Discharge من 30% إلى 25% في وصفه، واقرأ الإشعار المنبثق: عاد المتطلب إلى «قيد المراجعة» وروابطه تحتاج إلى مراجعة.
  4. افتح الاحتياجات والمتطلبات ← روابط للمراجعة. في صف خاص بـ 3.3، انقر الفرق، ثم تعليم كمُراجَع…، واكتب ما تحققت منه ثم انقر تعليم كمُراجَع.
  5. في المستند، اختر الإصدار ▾ ← مقارنة النسخ… مع من PDR Baseline وإلى الإصدار الحالي، ثم انقر التغييرات (Excel).
  6. افتح التحكم والمراجعات ← خطوط الأساس والإصدارات واعثر على PDR Baseline بجوار SRR Baseline. ولتجميد النموذج كله بدلًا من مستند واحد، تستخدم + حفظ خط الأساس… في رأس هذه الصفحة.

تكون قد انتهيت عندما يذكر تقرير التغييرات من PDR Baseline تعديل 3.3 ولا يعود الرابط الذي راجعته ظاهرًا في «روابط للمراجعة».

اختبر نفسك

  1. لماذا يعلّم تغيير متطلب الروابط التي تعتمد عليه، لا المتطلب وحده؟
  2. ما الفرق بين خط أساس المستند وخط أساس المشروع؟
  3. عندما تعلّم رابطًا كمُراجَع، لماذا تكتب ملاحظة؟
إظهار الإجابات
  1. لماذا يعلّم تغيير متطلب الروابط التي تعتمد عليه، لا المتطلب وحده؟

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

  2. ما الفرق بين خط أساس المستند وخط أساس المشروع؟

    يجمّد خط أساس المستند مستندًا واحدًا واعتماداته (الإصدار ▾ ← حفظ خط الأساس…). ويجمّد خط أساس المشروع كل عنصر وعلاقة (خطوط الأساس والإصدارات ← + حفظ خط الأساس…).

  3. عندما تعلّم رابطًا كمُراجَع، لماذا تكتب ملاحظة؟

    تسجّل الملاحظة ما فُحص ولماذا يظل الرابط صحيحًا. وتُضاف إلى تعليقات العنصر المرتبط، فيستطيع المراجع تتبع القرار لاحقًا.

قراءة المزيد

النص المكتوب

إظهار النص المكتوب (التعليق الصوتي وما يظهر على الشاشة)

Introduction

Chapter four: baselines and links to review. Once a specification is agreed, changes need control: everyone should know what changed, and what the change might break.

We baseline the Bike-Share Dock specification, then change one of its requirements.

Change control

A baseline is a read-only snapshot of a document, with its approvals. After it, every change is visible, and a change to a requirement marks the links that depend on it for review, until someone checks them.

On screen: Card: baselines and links to review.

First, give Show Available Bikes a link to depend on. In the Database, select it, and in its Trace section link it with satisfied by to the rental kiosk, which shows the numbers.

On screen: 4.1.1 → Trace → satisfied by + → Link existing… → Rental Kiosk.

Baseline

Open the specification, and the version menu in its title block. Choose Save Baseline, name it SRR Baseline for the requirements review, add your role, and click Create.

On screen: SRS → Current version ▾ → Save Baseline… → SRR Baseline → Create.

A change

Now a change. The team wants the kiosk to show the charge level of each e-bike too. Select Show Available Bikes, and update its statement in the inspector.

On screen: 4.1.1 → Item → new description.

The message says what happened, in the same undo step as the edit: the approved requirement went back to In Review, and its link to the rental kiosk now needs review.

On screen: The toast and the status.

Links to review

Open Needs and Requirements, then Links to Review. Each row is a link to check. Diff shows exactly how the text changed.

On screen: Links to Review → Diff.

The rental kiosk can show charge levels too, so the link still holds. Click Mark Reviewed, write what you checked, and click Mark Reviewed. The link no longer needs review.

On screen: Mark Reviewed… → note → Mark Reviewed.

Changes since the baseline

To see everything that changed since the review, open the specification's version menu again, and choose Compare Versions: from SRR Baseline to the current version.

On screen: SRS → version ▾ → Compare Versions… → SRR Baseline → Current.

The report lists each addition, removal and edit, ready to export to Excel or as a Word redline for a change board.

On screen: The change report.

Recap

Let's recap. You baselined the specification with an approval, changed an approved requirement, saw it return to review with its link flagged, marked the link reviewed with a note, and listed the changes since the baseline.

Next, you plan and run the tests that verify the requirements.