المتطلبات
المتطلبات
اكتب المتطلبات وافحصها واعتمدها وضع لها خط أساس واستوردها، وتتبّع بنود TBD/TBR المفتوحة والروابط للمراجعة.
في هذه الصفحة
نظرة عامة
استخدم صفحات المتطلبات لكتابة المتطلبات وفحصها واعتمادها ووضع خطوط أساس لها، ولتتبع ما لا يزال مفتوحًا. والمتطلب كيان من فئة LML Requirement: قدرة أو خاصية أو عامل جودة يجب أن يمتلكه النظام.
توجد المتطلبات عادة في مستند متطلبات (انظر المستندات). ويبقى كل منها كيانًا في النموذج. لذا يظهر المتطلب نفسه في قاعدة البيانات، وفي المخططات، وفي مصفوفة التتبع، وفي RVTM.
تضم مجموعة الاحتياجات والمتطلبات في شريط التنقل كل صفحات المتطلبات:
| الصفحة | ما تعرضه |
|---|---|
| المستندات | المواصفات ومخططاتها التفصيلية. وتُكتب المتطلبات هنا. |
| المتطلبات | كل متطلب في جدول واحد (قاعدة البيانات مصفّاة على class:Requirement). |
| الجودة | جودة المتطلبات: درجة على تسعة معايير لكل متطلب. |
| TBD/TBR | سجل القيم المفتوحة التي لا يزال يتعين تحديدها أو مراجعتها. |
| روابط للمراجعة | الروابط التي تغيّر متطلبها في المنبع بعد آخر مراجعة للرابط. |
| الاعتمادات | المتطلبات التي حالتها In Review. |
| الاستيراد والتصدير | الاستيراد لملفات Word وExcel وCSV وReqIF والنص العادي وXMI وملفات المشاريع، عبر منطقة إفلات واحدة، وصادرات النموذج. |
خطوط الأساس لقطات مجمّدة للمراجعات. أنشئها من مستند أو من التحكم والمراجعات ← خطوط الأساس والإصدارات. وتتناول التتبع الروابط إلى الوظائف والأصول والاختبارات.
المفاهيم
Requirement وStatement
Statement هي الفئة الأصل لـ Requirement.
- استخدم Statement للنص غير الملزِم: عناوين الأقسام، والافتراضات، والسياق.
- استخدم Requirement لكل عبارة “shall” ملزِمة.
لا يقيّم فحص الجودة إلا الـ Requirements، ولا يسرد سجل TBD/TBR غيرها، ولا يعلّم للمراجعة عند التغيير غيرها، ولا يعدّ RVTM غيرها. وتُتخطى الـ Statements.
للمتطلب حقول الكيان المشتركة الرقم والاسم والوصف. والوصف هو نص المتطلب نفسه، نصًا منسَّقًا. وتضيف السمات أدناه الباقي.
سمات المتطلب
| السمة | النوع والقيم | المعنى |
|---|---|---|
| المبرّر | نص طويل | السبب وراء المتطلب. |
| الحالة | Draft، In Review، Approved، Rejected | موضع المتطلب في سير عمل الموافقة. |
| Priority | High، Medium، Low | مدى أهمية المتطلب لأصحاب المصلحة. |
| Criticality | High، Medium، Low | العاقبة على المهمة أو السلامة إذا لم يُستوفَ المتطلب. |
| المالك | النص | الشخص أو الفريق المسؤول عن المتطلب. |
| المصدر | النص | صاحب المصلحة أو المستند أو المعيار الذي يأتي منه المتطلب. |
| Verification Method | تحديد متعدد: Analysis، Demonstration، Inspection، Test | كيف يُتحقق من المتطلب. |
| Verification Level | Component، Subsystem، System | مستوى التجميع الذي يُتحقق عنده من المتطلب. |
| Success Criteria | نص طويل | نتيجة قابلة للقياس تُظهر أن المتطلب مستوفى. |
| TBD/TBR | None، TBD، TBR | TBD = قيمة لا يزال يتعين تحديدها؛ TBR = قيمة يجب مراجعتها. أعدها إلى None عند الإغلاق. |
| TBD Owner | النص | الشخص المسؤول عن إغلاق TBD/TBR. |
| TBD Due Date | التاريخ والوقت | التاريخ الذي يجب إغلاق TBD/TBR بحلوله. ويُظهر تاريخ الاستحقاق في مجموعة سير العمل التاريخ نفسه ويضبطه (انظر سجل TBD/TBR). |
| Quality Score | نسبة مئوية، محسوبة | نتيجة آخر فحص للجودة. |
| Appropriate، Complete، Conforming، Correct، Feasible، Necessary، Singular، Unambiguous، Verifiable | نعم/لا، محسوبة أو مضبوطة يدويًا | معايير الجودة التسعة. |
تجمّع لوحة الخصائص حقول المتطلب (انظر لوحة الخصائص): Requirement (Number وName وDescription وLabels وRationale وSource وSuccess Criteria)، وسير العمل (شريط المراجعة مع Status وPriority وCriticality وOwner وAssignee وDue date وTBD/TBR وTBD Owner وTBD Due Date)، والتحقق (Verification Method وLevel، وVerified by، وحقول الإغلاق مع البرنامج الرسمي)، والقيم (Budget Quantity وThreshold وObjective وValue الحالية، وUnits)، والامتثال (البرنامج الرسمي) والجودة.
تقع الدرجة والمعايير التسعة في مجموعة الجودة، مطوية في البداية. ويقرأ عنوانها مثلًا “89% · 8 من 9 مستوفاة”، أو “لم يُفحص بعد”. ويتذكر Holarch ما إذا تركت المجموعة مفتوحة، لكل فئة.
يمكن للمشاريع إضافة سمات وخيارات خاصة بها للمتطلبات؛ انظر امتدادات المخطط الهيكلي.
تسميات المتطلبات
تصنّف التسميات المتطلبات دون تغيير فئتها. وتسميات المتطلبات المدمجة هي:
- Functional Requirement، Performance Requirement، Interface Requirement.
- Environmental Requirement، Reliability Requirement، Safety Requirement.
- Verification Requirement.
- Stakeholder Need: حاجة يذكرها صاحب مصلحة، قبل أن تُحوَّل إلى متطلبات نظام.
Verification Method مجموعة تسميات أيضًا، فيها التسميات Analysis وDemonstration وInspection وTest. وتبقى التسمية والسمة متزامنتين، في خطوة التراجع نفسها:
- إضافة التسمية Test تضبط Verification Method على Test.
- اختيار Test في السمة يضيف التسمية.
تُدمج المشاريع الأقدم والاستيرادات التي لا تحمل إلا التسميات في السمة عند فتح المشروع.
سير عمل المتطلبات
ينتقل كل متطلب عبر أربع حالات:
- Draft: قيد الكتابة.
- In Review: بانتظار قرار. ومدرج في صفحة الموافقات.
- Approved أو Rejected: تقرر. ويسجّل كل قرار من اتخذه، ومتى، وسببًا اختياريًا.
بعد الموافقة، تحافظ ثلاث آليات على صدق السجل:
- إعادة المراجعة عند التحرير. تحرير اسم متطلب Approved أو وصفه يعيده إلى In Review، مع الملاحظة “تغيّر النص بعد الموافقة”.
- الجودة القديمة. تحرير الاسم أو الوصف يعلّم نتائج جودته قديمة ويمسح تجاوزات الجودة اليدوية.
- روابط للمراجعة. تحرير الاسم أو الوصف أو سمة رئيسية يعلّم الروابط إلى العناصر التي في المصب منه للمراجعة.
الثلاثة كلها جزء من التحرير، فيعكسها تراجع واحد (⌘Z / Ctrl+Z) معًا.
البنود المفتوحة: TBD وTBR وTBS
البند المفتوح قيمة لم تُحسم بعد. ويكون المتطلب بندًا مفتوحًا حين يصح أي مما يلي:
- سمة TBD/TBR الخاصة به هي TBD أو TBR.
- يحوي اسمه أو وصفه الكلمة TBD أو TBR أو TBS.
تظهر البنود المفتوحة في سجل TBD/TBR حتى تُغلق.
خطوط الأساس
خط الأساس لقطة للقراءة فقط. وله نوعان:
- خط أساس المستند يحوي مستندًا واحدًا. ويشمل مادة المستند، وعناصره وسماتها، والعلاقات التي تمسها، والكيانات على بُعد قفزة واحدة، وإعدادات المخطط التفصيلي للمستند.
- خط أساس المشروع يحوي كل كيان وعلاقة في المشروع.
يمكن أن تحمل خطوط الأساس سجلات موافقة (الاسم، والدور، والبيان، والتاريخ). وتُقفل السجلات بمجرد حفظها.
طريقة استخدامها
متى ولماذا
يمتد عمل المتطلبات على الجانب الأيسر من V هندسة النظم:
- التقط احتياجات أصحاب المصلحة.
- اشتق متطلبات النظام.
- تحقق من أن كل عبارة مصوغة جيدًا.
- احصل على اعتماد المتطلبات.
- جمّدها في مراجعة (SRR، PDR، CDR).
بعد خط الأساس، يتحول العمل إلى التحكم في التغيير. فيُعاد مراجعة كل تغيير ويُفحص أثره في المصب. وتُغلق قيم TBD/TBR المفتوحة قبل الالتزام بالتصميم.
تجيب صفحات المتطلبات عن هذه الأسئلة:
| السؤال | الصفحة |
|---|---|
| هل كل متطلب مكتوب جيدًا؟ | الجودة |
| ما القيم التي لا تزال مجهولة، ومن يملكها، وهل هي متأخرة؟ | TBD/TBR |
| ما الذي يجب إعادة فحصه لأن متطلبًا تغيّر؟ | روابط للمراجعة |
| ما الذي ينتظر قرارًا؟ | الاعتمادات |
| ما الذي تغيّر منذ المراجعة؟ | الإصدار ▾ ← مقارنة النسخ… في المستند، وخطوط الأساس والإصدارات |
| هل كل متطلب مخصَّص ومتحقَّق منه؟ | مصفوفة التتبع وRVTM |
تقع صفحات الجودة وروابط للمراجعة وTBD/TBR والموافقات بجانب بعضها تحت الاحتياجات والمتطلبات في شريط التنقل. ومن هناك امرر بالفحوص الأربعة كلها بالتتابع.
كتابة متطلب
- افتح الاحتياجات والمتطلبات ← المستندات.
- افتح مستند المتطلبات.
لبدء مستند جديد، انقر + مستند جديد (انظر المستندات).
- في شريط إضافة سريعة تحت المستند، اختر أين يذهب العنصر، مثل تحت 3 Electrical Power.
- اكتب نص المتطلب واضغط Enter.
يضيف Holarch عنصرًا من الفئة الافتراضية للمستند (Requirement في مستند متطلبات). ويُرقَّم بعد أشقائه.
- والمتطلب محدد، افتح لوحة الخصائص على اليسار.
- املأ المبرر والمصدر ومعايير النجاح في مجموعة Requirement، وPriority وCriticality وOwner في سير العمل، وVerification Method ومستوى التحقق في التحقق.
- أضف تسمية نوع بـ + تسمية في مجموعة Requirement في لوحة الخصائص، مثل Performance Requirement. (عمود التسميات تحت عرض ▾ ← الأعمدة ▸.)
حالة المتطلب Draft ويظهر في الاحتياجات والمتطلبات ← المتطلبات.
إذا لم تكن قيمة معروفة بعد:
- اكتب أفضل تقدير لديك في العبارة.
- اضبط TBD/TBR على TBD.
- املأ TBD Owner، واضبط التاريخ في تاريخ الاستحقاق في مجموعة سير العمل.
يظهر المتطلب الآن أيضًا في سجل TBD/TBR، بتاريخ الاستحقاق ذلك.
فحص الصياغة
- افتح الاحتياجات والمتطلبات ← الجودة.
من مستند، اختر الفحص ▾ ← فحص الجودة بدلًا من ذلك.
- في شريط النطاق، اختر كل المتطلبات أو المستند: <name>.
- انقر فحص الجودة في رأس الصفحة.
يقرأ الإشعار “فُحص 32 متطلبًا” (أو عددك). ويحصل كل متطلب على درجة من 0 إلى 100% وعلى ✔ أو ✘ لكل معيار.
مع أكثر من 2,000 متطلب يجري الفحص في الخلفية: تُظهر بطاقة التقدم “جارٍ فحص المتطلبات” والعدد والوقت المتبقي، ويمكنك متابعة العمل. انقر إلغاء على البطاقة للإيقاف؛ فلا يتغير شيء. ثم تقرأ البطاقة “جارٍ حفظ نتائج الجودة” مع العدد المحفوظ؛ وأثناء الحفظ، تُرفض التعديلات الأخرى بالرسالة “جارٍ حفظ نتائج الجودة. حاول مجددًا عند انتهائه.” ولا تُحفظ إلا المتطلبات التي تغيّرت نتائجها، فالفحص مجددًا دون تغييرات لا يحفظ شيئًا. والفحص كله خطوة واحدة: يزيله ⌘Z / Ctrl+Z واحد.
- اقرأ المربعات: المتطلبات، ومتوسط الدرجة، وجيد (≥ 67%)، ويحتاج إلى إعادة عمل (< 67%)، وحين توجد، قديم (تغيّر النص).
- لكل متطلب دون 67%، اقرأ عمود اقتراحات.
أو أشر إلى ✘ لرؤية رسائل ذلك المعيار.
- انقر اسم المتطلب لفتحه، وأصلح النص.
- شغّل الفحص مجددًا.
يحتاج Correct وFeasible دائمًا إلى حكم شخص. ولا يعلّمهما الفحص مستوفيين أبدًا، أيًا كانت نتائج الفحوص الأخرى. لذا يبلغ الفحص التلقائي 7 من 9 معايير على الأكثر (78%). ويبلغ المتطلب الذي ليس له اختبار أو متطلب يتحقق منه 6 من 9 (67%). لكل متطلب، قرّرهما بنفسك:
- بعد مراجعة المتطلب، انقر ✘ لتعليم المعيار بنعم.
- لرأي أولي، استخدم ✦ الذكاء الاصطناعي ▾ ← التحقق بالذكاء الاصطناعي (N متطلبات)… (فحص المتطلبات بالذكاء الاصطناعي).
ملاحظة: قد تحتسب الدرجات المخزَّنة بإصدارات سابقة Correct أو Feasible مستوفيًا حين يفشل فحص آخر. شغّل الفحص مجددًا لتحديثها.
الكتابة بقوالب EARS
تكتب EARS (Easy Approach to Requirements Syntax) كل متطلب جملة واحدة: شرط اختياري، ثم “the [system] shall [response]”. وتحدد الكلمة الأولى في الشرط النمط.
| النمط | القالب | مثال |
|---|---|---|
| Ubiquitous | The [system] shall [response]. | يجب (shall) على وحدة التحكم في المضخة تسجيل كل أمر تشغيل مع وقته. |
| Event-driven | When [trigger], the [system] shall [response]. | عندما (When) ينخفض مستوى الخزان إلى أقل من 20 %، يجب (shall) على وحدة التحكم في المضخة تشغيل المضخة الاحتياطية. |
| State-driven | While [state], the [system] shall [response]. | أثناء (While) شحن المركبة، يجب (shall) على مدير البطارية إبقاء كل خلية دون 45 °C. |
| Unwanted behavior | If [unwanted condition], then the [system] shall [response]. | إذا (If) انخفض جهد التغذية إلى أقل من 10 V، فعندئذ (then) يجب (shall) على حاسوب الطيران التحويل إلى البطارية الاحتياطية. |
| Optional feature | Where [feature is included], the [system] shall [response]. | حيث (Where) يُركَّب زجاج أمامي مُدفأ، يجب (shall) على وحدة التحكم في المناخ إزالة الصقيع في غضون 5 دقائق. |
| Complex | While [state], when [trigger], the [system] shall [response]. | أثناء (While) وجود المثقاب في وضع الاستعداد، عندما (when) يضغط المشغّل Start، يجب (shall) على وحدة التحكم في المثقاب بلوغ السرعة القصوى في غضون 3 s. |
- افتح متطلبًا في لوحة الخصائص أو عرض العنصر.
- انقر EARS ▾ بجانب الوصف.
يُظهر السطر الأول نمط العبارة (✓ Event-driven) أو ما يجب إصلاحه (لا يوجد نمط EARS: 1 للإصلاح).
- اختر نمطًا.
يصبح قالبه هو الوصف. وإذا كان للمتطلب وصف بالفعل، فأكّد بـ استبدال؛ وتبقى العبارة القديمة في سجل العنصر. ويتراجع عنه ⌘Z / Ctrl+Z واحد.
- استبدل الكلمات التي بين الأقواس المربعة.
لفحص كل متطلب، اضبط Requirement.11 على تحذير أو خطأ في فحوص النموذج ← الإعدادات. وهو معطَّل افتراضيًا.
في مشروع SysML v2، يقع EARS ▾ تحت التوثيق الخاص بالمتطلب في لوحة الخصائص ويكتب تعليق doc الخاص به.
الموافقة على المتطلبات
- حين يجهز متطلب، اضبط Status الخاص به على In Review.
افعل ذلك في لوحة الخصائص (الحالة في شريط المراجعة في مجموعة سير العمل)، أو قاعدة البيانات، أو عمود في مستند.
- يفتح المراجع الاحتياجات والمتطلبات ← الموافقات.
تسرد الصفحة كل متطلب حالته In Review.
- انقر صفًا.
تُظهر مجموعة سير العمل في لوحة الخصائص شريط المراجعة: الحالة، ومن ضبطها ومتى (“بواسطة J. Rivera · 9 مارس 2026 الساعة 9:58 ص”) والأزرار.
- انقر اعتماد.
أو انقر رفض… وأدخل سببًا اختياريًا.
يقرأ الإشعار “تم الاعتماد” أو “تم الرفض”. ويُسجَّل القرار باسمك والوقت، ويغادر المتطلب قائمة الموافقات.
حين يكون المتطلب في خط أساس وتتتبع إليه عناصر تحقق أو مستندات، يفتح اعتماد أولًا مربع حوار يسردها تحت تحتاج إلى مراجعة جديدة (الأثر). انقر صفًا للنظر فيه، ثم انقر اعتماد للتأكيد.
لإعادة متطلب تقرر إلى المراجعة، انقر إعادة فتح. ويقرأ الإشعار “نُقل إلى In Review”.
إذا كان للمشروع سير عمل على Status المتطلبات (المخطط الهيكلي ← سير العمل)، يُظهر شريط المراجعة انتقالات سير العمل ذلك بدلًا من اعتماد ورفض… وإعادة فتح. والانتقال الذي يحتاج إلى موافقة ينتهي بـ … ويفتح طلب الموافقة: انظر طلب الموافقة على تغيير حالة. ولمتطلب مدرج في خط أساس، يُظهر طلب الموافقة ومربع حوار اعتماد… في طلب التغيير قائمة تحتاج إلى مراجعة جديدة نفسها.
تجميد مستند لمراجعة
- في كتلة عنوان المستند، انقر الإصدار ▾.
- اختر حفظ خط الأساس….
أو اختر التسليم ▾ ← الإصدار ▸ حفظ خط الأساس….
- أبقِ الاسم أو غيّره. والافتراضي “<document> Baseline <n>”.
- تحت الموافقات، املأ صفًا لكل معتمِد: الاسم والدور والبيان (الافتراضي “معتمد للإصدار.”).
يضيف + إضافة معتمِد صفًا؛ ويزيل × صفًا.
- انقر إنشاء.
يقرأ الإشعار “تم حفظ خط الأساس”. ويقرأ الإصدار ▾ “الحالي · آخر خط أساس <name>”.
من الآن، يحصل كل صف على شريط تغيير حين يختلف عن أحدث خط أساس.
التعامل مع تغيير بعد خط الأساس
- حرّر نص المتطلب في المستند.
يلخّص إشعار ما حدث، مثل “نُقل متطلب معتمد واحد إلى In Review؛ وعُلِّم 6 روابط للمراجعة.” وضمن تحريرك (ويُلغي تراجع واحد ذلك كله):
- ينتقل المتطلب Approved إلى In Review.
- تصبح نتائج جودته قديمة (“الجودة: قديمة — أعد التشغيل”).
- تُعلَّم روابطه في المصب للمراجعة.
- افتح الاحتياجات والمتطلبات ← روابط للمراجعة.
- لكل صف، انقر الفرق لرؤية تغيير النص، وراجع العنصر المرتبط.
- حين يظل العنصر المرتبط صالحًا، انقر تعليم كمُراجَع… على صفه.
لتعليم عدة صفوف دفعة واحدة، حدّد صفوفها وانقر تعليم المحدد كمُراجَع….
- اكتب ما فحصته وانقر تعليم كمُراجَع.
- شغّل فحص الجودة مجددًا.
- أرسل المتطلب مجددًا عبر الموافقة.
- انقر الإصدار ▾ ← مقارنة النسخ…، واختر خط الأساس تحت من والإصدار الحالي تحت إلى.
يسرد التقرير كل تغيير منذ خط الأساس.
- انقر التغييرات (Excel) لمجلس التغيير.
إغلاق بنود TBD وTBR
- افتح الاحتياجات والمتطلبات ← TBD/TBR.
- اقرأ المربعات: TBD/TBR المفتوحة، ومتأخرة، وبلا مالك، والعدد لكل مستند.
- تعامل مع الصفوف المتأخرة أولًا. فهي ملوّنة، مع “متأخر” تحت تاريخ الاستحقاق.
- حيث يُظهر المالك “—”، عيّن TBD Owner.
- حين تُحسم قيمة، حرّر نص المتطلب إلى القيمة النهائية.
- انقر إغلاق على الصف.
يضبط الإغلاق TBD/TBR على None، ويغادر الصف السجل.
لإرسال السجل إلى المالكين، انقر تصدير XLSX.
استيراد مواصفة موجودة
- افتح الاحتياجات والمتطلبات ← الاستيراد والتصدير.
- أفلت الملف على منطقة الإفلات، أو انقرها لاختيار الملف: Word (.docx) أو Excel أو CSV أو ReqIF أو نص عادي.
يقرأ سطر الحالة مثلًا “حُلِّل “SRS.docx”: 48 صفًا، 5 أعمدة.” ويُظهر التنسيق الصيغة المكتشفة.
- انقر متابعة.
- تحقق مما يُربط به كل عمود، واضبط فئة الصفوف التي ليست لها فئة على Requirement.
- انقر متابعة.
- أبقِ إنشاء مستند متطلبات من هذه المتطلبات البالغ عددها N محددًا، وتحقق من نوع المستند واسمه، وتحقق من العناصر الجديدة والمحدَّثة والتحذيرات.
- انقر استيراد N عناصر.
من دون تحذيرات، يفتح Holarch المستند الجديد. ومع تحذيرات، تسردها بطاقة اكتمل الاستيراد.
في بطاقة اكتمل الاستيراد أزرار لفتح المستند، أو قاعدة البيانات، أو مخطط Spider أو شجري، أو فحص الجودة. ويزيل ⌘Z / Ctrl+Z واحد الاستيراد كله.
مثال عملي: المشروع التوضيحي CubeSat EO-1
أنشئ المشروع التوضيحي CubeSat EO-1 — Earth Observation Demo من إدارة المشاريع. وفيه مواصفة من 32 متطلبًا، SRS-001 EO-1 System Requirements Specification، مع خط أساس SRR وتغييرات أُجريت بعده.
الجودة.
- افتح الاحتياجات والمتطلبات ← الجودة وانقر فحص الجودة.
تُظهر المربعات 32 متطلبًا، بمتوسط 92%، و29 جيدًا و3 تحتاج إلى إعادة عمل.
المتطلبات الثلاثة الضعيفة مكتوبة بهذه الطريقة عمدًا. ودرجة كل منها 44%:
- 2.5 Safe Mode Recovery: “The spacecraft should recover from safe mode quickly and resume imaging as appropriate”. وتشمل الاقتراحات:
- “R34 - مصطلحات أداء لا يمكن قياسها: [quickly]”
- “R8 - عبارات تحفّظ تُضعف المتطلب: [as appropriate]”
- “R19 - تجمع متطلبين؛ قسّمها إلى متطلبات منفصلة: [and]”
- “أنهِ العبارة بنقطة.”
- “اربط Test Case أو Requirement يتحقق منه.”
- 3.5 Battery Thermal Control: “…keep the battery warm enough (TBD).” والاقتراحات “R21 - تحتوي على أقواس؛ انقل النص بين الأقواس إلى Rationale.” و“استبدل عناصر TBD/TBR النائبة.”
- 6.4 Operator Interface: “…shall be user friendly and/or easy to use.” والاقتراحات “R34 - مصطلحات أداء لا يمكن قياسها: [user friendly, easy to use]” و“R19 - “and/or” غامضة؛ حدّد هل المقصود الاثنان معًا أم أحدهما: [and/or]”.
لإصلاح 2.5:
- أعد كتابته هكذا: “The spacecraft shall resume imaging within 6 hours of a safe mode entry.”
- اربط حالة اختبار بـ verified by.
- شغّل الفحص مجددًا.
تختفي رسائل أداة الربط وعبارة التحفّظ والمصطلح الغامض.
TBD/TBR. افتح TBD/TBR. وتُظهر ثلاثة بنود مفتوحة:
- 3.5 Battery Thermal Control: بند TBD يملكه Thermal Engineer. وهو متأخر.
- 2.4 Target Slew (ADCS Lead) و5.3 Downlink Link Margin (Comms Lead): بنود TBR مستحقة لاحقًا.
التغيير بعد خط الأساس. يسرد الإصدار ▾ في المستند SRR Baseline. واعتمده J. Rivera (Systems Lead) وR. Okafor (Mission Principal Investigator) وL. Brandt (Program Manager).
بعد SRR، تغيّر المتطلب 3.1 Orbit Average Power من 28 W إلى 30 W. ولأن 3.1 كان Approved، فقد عاد إلى In Review مع الملاحظة “تغيّر النص بعد الموافقة”.
يسرد روابط للمراجعة ستة روابط من 3.1:
- 1.3.1 Solar Arrays
- F3 Generate and Store Power وF3.1 Convert Sunlight to Power
- EQ-1.1 Solar Power Generation وEQ-1.4 Power Margin Check
- TC-06 Solar Array Power Test
انقر الفرق على أي صف: “28 W” مشطوبة و“30 W” مُدرجة. ثم راجع العناصر:
- يتوقع TC-06 قدرة قصوى ≥ 72 W وقاس 75.1 W. ومن خلال EQ-1.3 Orbit-Average Array Power (القدرة القصوى × 0.62 نسبة التعرض للشمس × 0.6 كفاءة مسار القدرة)، فإن 75.1 W تعادل 27.9 W متوسطًا مداريًا، أقل من 30 W الجديدة. اترك ذلك الرابط دون مراجعة وأضف التعليق “75.1 W peak = 27.9 W orbit average; re-test against about 80.6 W peak”. ويحتاج الاختبار إلى نتيجة متوقعة جديدة وتشغيل جديد.
- تحقق من أن تحجيم المصفوفة الشمسية لا يزال يغلق قبل أن تعلّم 1.3.1 كمُراجَع.
المقارنة بالحالي. اختر SRR Baseline في الإصدار ▾، ثم انقر المقارنة بالحالي في شريطه. ويسرد التقرير:
- تغييرات Description وRationale وStatus وQuality Score في 3.1.
- تغيير Status في 2.4 Target Slew (Draft ← In Review).
- المتطلب الجديد 4.4 Downlink Encryption، مع رابطَي satisfies الجديدين.
الموافقات. افتح الموافقات. تسعة متطلبات في In Review، منها 3.1 و1.5 Daily Collection Volume و5.3 Downlink Link Margin.
نصائح وممارسات جيدة
- اكتب “shall” واحدة لكل متطلب، بالمبني للمعلوم، مع رقم ووحدة وشرط. وفحص الجودة يكافئ ذلك بالضبط.
- ضع السبب في المبرر، لا في العبارة. وتُعلَّم عبارات الغرض (“so that”، “in order to”) والأقواس بـ R20 وR21.
- املأ Verification Method أثناء الكتابة. فيظهر المتطلب الذي له طريقة وليس له حالة اختبار بوصفه Planned-only في RVTM، بدلًا من Unverified.
- اضبط TBD/TBR مع مالك وتاريخ استحقاق، بدلًا من كتابة “TBD” في النص فقط. فالسمة تمنح السجل مالكًا وتاريخ استحقاق لتتبعهما.
- ضع خط أساس قبل كل مراجعة. فأشرطة التغيير والمقارنة بالحالي لا تعمل إلا مقابل خط أساس.
- علّم الروابط كمُراجَعة مع تعليق. فيُضاف التعليق إلى العنصر المرتبط ويُسجَّل على الرابط، فتترك المراجعة أثرًا للتدقيق.
أخطاء شائعة
| العَرَض | السبب | الإصلاح |
|---|---|---|
| متطلب لا يُقيَّم، أو ليس في السجل، أو ليس في RVTM. | إنه Statement، وليس Requirement. | غيّر فئته إلى Requirement في لوحة الخصائص. |
| يُظهر Correct وFeasible ✘ على كل متطلب. | يحتاجان إلى حكم شخص (“يحتاج إلى حكم مراجع”). | راجع كل واحد وانقر ✘ لتعليمه بنعم، أو شغّل فحص المتطلبات بالذكاء الاصطناعي. |
| تُظهر الدرجة “قديم — أعد التشغيل”. | تغيّر النص بعد آخر فحص. | انقر فحص الجودة، أو فعّل إعادة الفحص تلقائيًا عند تغيّر النص. |
| اختفت تجاوزات نعم/لا اليدوية. | تحرير النص يمسحها. | اضبطها مجددًا بعد المراجعة؛ ويستعيدها التراجع، وتبقى في السجل. |
| متطلب غادر Approved بعد إصلاح خطأ مطبعي. | أي تحرير للاسم أو الوصف يعيد فتح متطلب معتمد. | اعتمده مجددًا. وأصلح الأخطاء المطبعية قبل الاعتماد. |
| “إغلاق” مفقود على صف TBD/TBR. | البند المفتوح يأتي من النص فقط. | حرّر النص لإزالة TBD أو TBR أو TBS. |
| أنشأ استيراد نسخًا بدلًا من التحديث. | لم يطابق مطابقة الكيانات الموجودة بواسطة. | صدّر مع عمود المعرّف، وحرّر، واستورد مع مطابقة الكيانات الموجودة بواسطة: المعرّف العام (انظر تحديث المتطلبات من جدول بيانات). |
كيف يرتبط بالميزات الأخرى
- يتغذى من: مدخلات أصحاب المصلحة والمواصفات الموجودة عبر استيراد، والمستندات المكتوبة في المستندات.
- يغذّي:
- التحليل الوظيفي: الوظائف المستخرجة من المتطلبات.
- مصفوفة التتبع: satisfied by، verified by.
- RVTM ومركز الاختبار: حالة التحقق.
- فحوص النموذج: القواعد من Requirement.1 إلى Requirement.10.
- الرئيسية: أعداد الموافقات والتحقق.
- صادرات المستندات: نتائج الجودة (Excel)، وRVTM، وVCRM، والتغييرات.
- المراجعات.
- الذكاء الاصطناعي: تحوي قائمة ✦ الذكاء الاصطناعي ▾ في المستند وعرض العنصر إعادة صياغة واضحة… وإضافة معايير قابلة للقياس… وتبسيط… وتقسيم متطلب مركّب… وصياغة المبرر… واقتراح اسم… والتحقق بالذكاء الاصطناعي (فحص المتطلبات بالذكاء الاصطناعي). وتُعاين تغييرات الذكاء الاصطناعي قبل تطبيقها. انظر اسأل الذكاء الاصطناعي وأدوات الذكاء الاصطناعي.
صفحة المتطلبات
استخدم صفحة المتطلبات لرؤية كل متطلب وتحريره في جدول واحد. والاحتياجات والمتطلبات ← المتطلبات هي قاعدة البيانات مصفّاة على class:Requirement.
كل ميزة في قاعدة البيانات تعمل هنا:
- افرز الأعمدة وصفّها، وحرّر الخلايا في مكانها.
- حدّد صفوفًا لشريط الإجراءات المجمّعة، لضبط السمات أو التسميات على متطلبات كثيرة دفعة واحدة.
- صدّر، وافتح مصفوفة التتبع للصفوف المحددة.
انقر صفًا لإظهار المتطلب في لوحة الخصائص. وانقره نقرًا مزدوجًا لفتح عرض العنصر الخاص به. والمتطلب الذي له رابط للمراجعة يُظهر شارة ⚠ مراجعة على صفه. وانقر صفًا بالزر الأيمن لقائمته: حتى ثلاثة إجراءات مقترحة مع أسبابها (مثل ✦ إضافة معايير قابلة للقياس… حين يفشل المتطلب في Unambiguous، و✦ إنشاء حالة اختبار… حين لا يكون متحقَّقًا منه)، و✦ المزيد من الذكاء الاصطناعي ▸، ثم فتح، وإعادة تسمية…، وتكرار، وإضافة عنصر فرعي…، والحالة ▸، والأولوية ▸، وربط بـ ▸، وإضافة إلى مستند ▸، وإظهار في المخطط ▸، ونسخ الرابط، ونسخ الرقم وحذف… (انظر قائمة النقر بالزر الأيمن).
انظر النموذج وقاعدة البيانات للجدول والاستعلامات والتحرير المجمّع.
استعلامات مفيدة:
| الاستعلام | يعرض |
|---|---|
class:Requirement | كل متطلب. |
Requirement:"Status=In Review" | قائمة الموافقات. |
Requirement:"Status=Draft" | المتطلبات التي لم تُرسل للمراجعة بعد. |
class:Requirement AND is:leaf | المتطلبات الورقية (بلا متطلبات فرعية). |
class:Requirement AND NOT relationship:"verified by" | المتطلبات التي بلا عنصر يتحقق منها. |
جودة المتطلبات
استخدم صفحة الجودة (العنوان “جودة المتطلبات”) للعثور على المتطلبات سيئة الصياغة. وهي تقيّم كل متطلب مقابل تسعة معايير.
تتبع المعايير التسعة وأرقام القواعد في الاقتراحات (R2 وR19 وهكذا) الخصائص والقواعد في Guide to Writing Requirements من INCOSE. وقوائم الكلمات والأنماط في Holarch تقارب تلك القواعد؛ وليست نص الدليل، وبعض القواعد يحتاج إلى حكم مراجع.
- الدرجة = 100 × (المعايير المستوفاة) / 9، مقرّبة. والمعيار الذي لم يُفحص (–، انظر المتطلبات بلغات أخرى) يُستبعد: 100 × المستوفاة / 8.
- 67% أو أكثر جيد. وأقل من 67% يحتاج إلى إعادة عمل.
- الشريط أحمر دون 34%، وأصفر من 34% إلى 66%، وأخضر من 67%.
تخطيط الصفحة
- رأس الصفحة:
- المزيد ▾: يعيد مسح التقييمات اليدوية تعيين كل نعم/لا يدوية للمتطلبات المعروضة ويعيد تشغيل الفحص. ويفتح فتح في المتطلبات المتطلبات المعروضة في جدول المتطلبات. ويظهر فتح المستند حين يكون النطاق مستندًا.
- تصدير ▾: Excel (.xlsx) وCSV، للمتطلبات المعروضة.
- فحص الجودة: يفحص كل متطلب في النطاق، أيًا كان ما تُظهره عوامل التصفية (تقارن قاعدة التكرار كل متطلب بالمتطلبات الأخرى في النطاق).
- ✦ الذكاء الاصطناعي ▾ (في الشريط العلوي): التحقق بالذكاء الاصطناعي (N متطلبات)…، فحص المتطلبات بالذكاء الاصطناعي للمتطلبات المعروضة.
- شريط النطاق: النطاق (كل المتطلبات أو المستند: <name>) ومربع الاختيار إعادة الفحص تلقائيًا عند تغيّر النص. وروابط للمراجعة وTBD/TBR والموافقات بجانب الجودة في شريط التنقل.
- شريط الاستعلام: + عامل تصفية، وشرائح التصفية ونص البحث، ومسح، و? (صيغة البحث) والعروض ▾: الشريط نفسه الذي في صفحة المتطلبات (انظر تصفية صفحة الجودة).
- المربعات: المتطلبات (“12 من 40” تحت المتطلبات المعروضة حين تُخفي عوامل التصفية بعضها)، ومتوسط الدرجة، وجيد (≥ 67%)، ويحتاج إلى إعادة عمل (< 67%)، وقديم (تغيّر النص) حين يكون بعضها قديمًا. وتُستبعد الدرجات القديمة من المتوسط.
- الملاحظة تحت المربعات: “تصل الفحوص الآلية إلى 7 من 9 سمات كحد أقصى (78%)؛ يتطلب Correct وFeasible تحققًا بشريًا — انقر ✘ لتعليمه بنعم. تدور كل نقرة بين نعم يدوية ولا يدوية والعودة إلى التلقائي.”
- الجدول: الرقم، والاسم (مع الوصف تحته)، ودرجة الجودة، وعمود لكل معيار، واقتراحات. وتسرد الاقتراحات كل رسالة، مسبوقة بمعيارها. وتُفرز الصفوف بالرقم. وانقر صفًا بالزر الأيمن، أو اضغط Shift+F10 عليه، لقائمة صف قاعدة البيانات: إجراءات مقترحة مع أسبابها (تأتي أولًا إعادة الصياغة التي تصلح معيارًا فاشلًا)، و✦ المزيد من الذكاء الاصطناعي ▸، وفتح، وإعادة تسمية…، وتكرار، وإضافة عنصر فرعي…، والحالة ▸، والأولوية ▸، وربط بـ ▸، وإضافة إلى مستند ▸، وإظهار في المخطط ▸، ونسخ الرابط، ونسخ الرقم وحذف…. ويصبح الصف هو التحديد.
- عدة صفوف: يبدّل ⌘ / Ctrl-النقر (Ctrl-النقر في Windows وLinux) صفًا، ويحدد ⇧ / Shift-النقر النطاق من آخر صف نُقر، ويضيف ⌘ / Ctrl+⇧ / Shift-النقر ذلك النطاق، ويحدد ⌘A / Ctrl+A أو ⇧ / Shift+↑ / ⇧ / Shift+↓ على صف مركَّز عليه كل الصفوف أو يوسّع التحديد. ويُظهر شريط الأدوات العدد؛ ويمسحه Esc. وانقر صفًا محددًا بالزر الأيمن للعمل عليها كلها: ✦ التحقق بالذكاء الاصطناعي (n متطلبات)…، و✦ إعادة صياغة (n) ▸، و✦ توليد حالات اختبار (n)…، و✦ اسأل الذكاء الاصطناعي عن هذه (n)…، و✦ اقتراح روابط التتبع (n)… (لكل منها معاينة واحدة؛ انظر الذكاء الاصطناعي على عدة عناصر محددة)، وتكرار n كيانات، وضبط الحالة ▸، وضبط الأولوية ▸، وإضافة إلى مستند ▸ وحذف n عنصر…؛ ويُلغي تراجع واحد كلًّا منها. ويعمل سجل TBD/TBR وروابط للمراجعة بالطريقة نفسها؛ وفي روابط للمراجعة يحدد التحديد أيضًا الصفوف لـ تعليم المحدد كمُراجَع….
حالات خاصة:
- الصف الذي بلا نتيجة يُظهر “لم يُشغَّل” في عمود الدرجة.
- الصف القديم يُظهر “قديم — أعد التشغيل”.
- حين لا تكون في النطاق متطلبات، تُظهر الصفحة “لا متطلبات” و“لا تُقيَّم إلا كيانات الفئة Requirement؛ وتُتخطى الـ Statements.”
- حين تُخفي عوامل التصفية أو نص البحث كل متطلب، تُظهر الصفحة “لا متطلبات مطابقة” و“لا متطلبات تطابق البحث أو عوامل التصفية. امسحها لعرض كل المتطلبات.”
تصفية صفحة الجودة
يعمل شريط الاستعلام كما في صفحة المتطلبات (انظر كيف تصبح عوامل التصفية المكتوبة شرائح): تصبح مصطلحات التصفية المكتوبة شرائح حين تضغط Enter، ويطابق باقي النص الاسم والرقم والوصف، ويزيل Backspace في بحث فارغ آخر شريحة، ويزيلها مسح كلها. وتتبع المربعات والجدول وتصدير ▾ و✦ الذكاء الاصطناعي ▾ ← التحقق بالذكاء الاصطناعي عوامل التصفية.
يسرد + عامل تصفية، مع أعداد للنطاق:
| المجموعة | عوامل التصفية | المصطلح |
|---|---|---|
| الجودة | جيد (≥ 67%)، يحتاج إلى إعادة عمل (< 67%)، لم يُشغَّل، قديم (تغيّر النص)، التقييمات اليدوية، نتيجة الذكاء الاصطناعي | quality:good, quality:rework, quality:notrun, quality:stale, quality:manual, quality:ai |
| يفشل في معيار | واحد لكل معيار: مقيَّم بلا | quality:Verifiable=no (=yes: مقيَّم بنعم) |
| نتيجة قاعدة | القواعد الموجودة في النطاق، مثل R7 صياغة غير دقيقة أو R30 تشابه وثيق (تكرارات محتملة) | quality:R7 |
| البنية، الفئة، سمات المتطلب، التسمية، العلاقة، المخطط | كما في صفحة المتطلبات؛ وتُسرد سمات المتطلب دون شريحة فئة | is:tbd, Requirement:"Status=Draft", label:"…" |
تتجمع عوامل تصفية المجموعة الواحدة بـ أو؛ وتتجمع المجموعات المختلفة بـ و. وتستخدم نطاقات الدرجات السمة: Requirement:"Quality Score>=50". وتعمل مصطلحات quality: أيضًا في صفحة المتطلبات وفي قاعدة البيانات.
يطبّق العروض ▾ عرضًا مدمجًا (يحتاج إلى إعادة عمل، لم يُفحص بعد، نتائج قديمة، غامض، غير قابل للتحقق، تكرارات محتملة، التقييمات اليدوية) أو أحد عروضك المحفوظة. ويحفظ حفظ العرض… عوامل التصفية الحالية ونص البحث في هذا المتصفح، لكل مشروع؛ ويظهر حذف “<name>” ما دام عرض محفوظ مستخدمًا. ويمسح كل المتطلبات عوامل التصفية. ويفتح العنوان quality?q=<query> الصفحة مصفّاة.
تقرأ التصفية النتائج المخزَّنة ولا تفحص مجددًا. وعلى 50,000 متطلب يستغرق تغيير عامل تصفية أو بحث أقل بكثير من عُشر ثانية.
المعايير والفحوص
يُظهر كل معيار واحدة من ثلاث علامات:
- ✔ (نعم): لا رسائل.
- ✘ (لا): رسالة واحدة على الأقل.
- –: لم يُفحص.
تطابق الفحوص الكلمات والعبارات الكاملة، دون مراعاة حالة الأحرف. ولا تُحتسب إلا الصيغ المدرجة: “effective” و“effectively” مدرجتان كلتاهما، أما “effectiveness” فليست مدرجة. وتُحتسب الكلمات داخل علامات الاقتباس أيضًا. والرسائل أدناه هي النص المعروض بالضبط. وتسمّي القائمة بين الأقواس في نهاية الرسالة الكلمات التي عُثر عليها.
غير ملتبس
| القاعدة | الرسالة | يُطلَق عند |
|---|---|---|
| R6 | R6 - وحدات غير معروفة؛ استخدم وحدات SI القياسية أو الأمريكية أو الإمبراطورية: [...] | رقم يليه كلمة ليست وحدة معروفة (مثل “12 sorties”). وتشمل الوحدات المعروفة وحدات SI والوحدات الأمريكية والإمبراطورية واختصاراتها، و% والدرجات و°C و°F. |
| R2 | R2 - استخدم المبني للمعلوم: [...] | “shall/must/will/should be” يليها اسم مفعول (“shall be measured”). |
| R5 | R5 - استخدم أدوات التعريف (“the”) بدلًا من: [...] | “a” أو “an”. |
| R7 | R7 - صياغة غير دقيقة: [...] | some، many، several، few، little، much، various، appropriate(ly)، adequate(ly)، efficient(ly)، effective(ly)، sufficient(ly)، reasonable، reasonably، suitable، suitably، significant(ly)، minimal(ly)، maximal(ly)، approximately، almost، nearly، generally، usually، typically، normally، robust(ly)، flexible، flexibly، easy، easily، etc، similar، relevant، substantial(ly)، large، small، good، bad، better، best، worst، proper، properly، acceptable، acceptably، accurate(ly)، extreme، high-contrast، high contrast. |
| R8 | R8 - عبارات تحفّظ تُضعف المتطلب: [...] | if necessary، where possible، as appropriate، as practicable، as far as possible، if practical، as required، as needed، to the extent possible، if possible. |
| R10 | R10 - عبارات مصدر غير ضرورية: [...] | to be designed to، to be able to، to be capable of، to enable، to allow، be able to، be capable of. |
| R16 | R16 - تجنّب النفي: [...] | not، n't، never. |
| R17 | R17 - تجنّب الشرطة المائلة (“/”). | شرطة مائلة بين كلمتين، باستثناء km/h وm/s وand/or ومكافئاتها في الألمانية والفرنسية والإسبانية والإيطالية والهولندية. |
| R24 | R24 - ضمائر بدلًا من أسماء صريحة: [...] | it، its، they، them، their، he، she، him، her، someone، something، anyone، anything، anybody، somebody، this، these، those. |
| R32 | R32 - استخدم “each” بدلًا من أدوات التعميم: [...] | all، any، both، every، everything، everyone. |
| R34 | R34 - مصطلحات أداء لا يمكن قياسها: [...] | fast، quick، quickly، user friendly، user-friendly، high speed(s)، high-speed، best practice(s)، state of the art، state-of-the-art، seamless(ly)، intuitive(ly)، easy to use، timely، rapid، rapidly، real-time، real time. ولا تُحتسب “Real-time clock”: فهي تسمّي مكوّنًا. |
| R35 | R35 - كلمات زمنية غير واضحة: [...] | as، eventually، before، after، until، meanwhile، simultaneous(ly)، soon، later، sometimes، occasionally، often، subsequently، previously. |
| — | استبدل عناصر TBD/TBR النائبة. | TBD أو TBR أو TBS في الوصف (بأحرف كبيرة). |
| — | الذكاء الاصطناعي: غامض — <reason> | نتيجة ذكاء اصطناعي مقبولة من فحص المتطلبات بالذكاء الاصطناعي. |
| — | تذكر حدًا أقصى (“up to”)؛ إذا كان المقصود حدًا أدنى، فاستخدم “at least”. | “up to” يليها رقم، بالأرقام أو بالكلمات (“up to 72 hours”، “up to five tonnes”). ولا تُحتسب “Up to date”. |
مكتمل
| القاعدة | الرسالة | يُطلَق عند |
|---|---|---|
| — | الوصف مفقود. | وصف فارغ. |
| — | الاسم مفقود. | اسم فارغ. |
| R9 | R9 - صياغة قوائم مفتوحة: [...] | including but not limited to، etc، and so on، and so forth، such as، among others. |
مفرد
| القاعدة | الرسالة | يُطلَق عند |
|---|---|---|
| R18 | R18 - اكتب جملة واحدة (وُجد: N). | أكثر من جملة واحدة (وكذلك الجمل اليابانية والصينية المنتهية بـ 。 أو ! أو ?). |
| — | أنهِ العبارة بنقطة. | وصف لا ينتهي بـ “.” (أو 。). |
| R19 | R19 - تجمع متطلبين؛ قسّمها إلى متطلبات منفصلة: [...] | and أو or أو but أو however أو whereas تربط فعلين أو التزامين (“shall log and report each fault”، “… and the operator shall …”)، و“nor shall”، وجملة ثانية بعد “;”؛ و“and/or” قبل فعل ثانٍ. انظر متطلبان في واحد (R19). |
| R19 | R19 - “and/or” غامضة؛ حدّد هل المقصود الاثنان معًا أم أحدهما: [and/or] | “and/or” بين قيم أو في شرط. |
| R19 | R19 - تجمع قيمتين؛ قسّمها إذا كانت كل قيمة تُتحقَّق منها على حدة: [...] | and أو or تربط مفعولين أو قيمتين بعد فعل واحد (“measure the temperature and the humidity”). وهي ملاحظة: يبقى Singular بنعم. |
| R20 | R20 - تحتوي على عبارات غرض؛ انقلها إلى Rationale: [...] | purpose of، in order to، so that، for the purpose of، so as to. |
| R21 | R21 - تحتوي على أقواس؛ انقل النص بين الأقواس إلى Rationale. | “(” أو “[” (وكذلك الأقواس كاملة العرض). |
مطابق
| الرسالة | يُطلَق عند |
|---|---|
| استخدم فعلًا مساعدًا: [need, shall, will, should, must] | لا تظهر أي من هذه الكلمات. |
ملائم
| القاعدة | الرسالة | يُطلَق عند |
|---|---|---|
| R31 | R31 - تفرض حلًا: [...] | using، by means of، utilizing، utilising، implemented in، implemented with، via a، via the، built with، written in. |
ضروري
| القاعدة | الرسالة | يُطلَق عند |
|---|---|---|
| R30 | R30 - تشابه وثيق: [3.2 Battery Capacity (81.3% similar), ...] | متطلب آخر في النطاق يتشابه وصفه بنسبة 75% على الأقل (تشابه أزواج الأحرف). وتسمّي النتيجة حتى خمسة وتعدّ الباقي (“and 3 more”). ولا يُقارن الأصل المباشر للمتطلب وأبناؤه (decomposed by، decomposes): فالتنقيح كثيرًا ما يكرر صياغة أصله. أما الأشقاء والمتطلبات غير المرتبطة فتُقارن. |
قابل للتحقق
| الرسالة | يُطلَق عند |
|---|---|
| اربط Test Case أو Requirement يتحقق منه. | ليس للمتطلب رابط verified by إلى Requirement أو Test Case. |
| الذكاء الاصطناعي: غير قابل للتحقق بصيغته الحالية — <reason> | نتيجة ذكاء اصطناعي مقبولة من فحص المتطلبات بالذكاء الاصطناعي. |
قابل للتحقيق
| القاعدة | الرسالة | يُطلَق عند |
|---|---|---|
| R26 | R26 - مصطلحات مطلقة يندر تحقيقها: [...] | always، never، 100%، 100 percent، all the time، totally، completely، absolutely، zero defects، forever، continuous، continuously، uninterrupted. |
| — | يحتاج إلى حكم مراجع | لم يُعثر على مصطلحات مطلقة ولا على شبه تكرارات؛ ويجب أن يقرر شخص. |
صحيح
| الرسالة | يُطلَق عند |
|---|---|
| يحتاج إلى حكم مراجع | اجتاز كل فحص نصي (Appropriate، Complete، Conforming، Necessary، Singular، Unambiguous)؛ ويجب أن يقرر شخص. |
لأن Correct وFeasible ينتهيان بـ “يحتاج إلى حكم مراجع” حتى يقرر أحد، فإن أعلى درجة تلقائية هي 7 من 9 (78%).
متطلبان في واحد (R19)
يذكر المتطلب أمرًا واحدًا. وينظر R19 في كل “and” و“or” و“nor” و“but” و“however” و“whereas” و“as well as” و“and/or” ويصنّفها في أحد هذه الأنواع:
| النوع | مثال | النتيجة |
|---|---|---|
| متطلبان | “The unit shall log and report each fault.” “The pump shall stop, and the operator shall be alerted.” “… to acknowledge alarms and to silence the horn.” “…; it shall also …” | نتيجة. وSingular بلا. |
| “and/or” غامضة | “The log shall record the user ID and/or the badge number.” | نتيجة: حدّد هل المقصود الاثنان معًا أم أحدهما. وSingular بلا. |
| قيمتان | “The station shall measure the temperature and the humidity.” | ملاحظة: قسّمها إذا كانت كل قيمة تُتحقَّق منها على حدة. ويبقى Singular بنعم؛ وتُعرض الملاحظة بالرمادي ولا تخفض الدرجة. |
| لا نتيجة | “between 5 °C and 30 °C”؛ “When A and B, the unit shall …”؛ “… when the door is open and the fan is off”؛ “requirements 2.1 and 2.2”؛ النص المقتبس؛ “The command and control unit shall …”؛ “ASME Boiler and Pressure Vessel Code”؛ “5 Nm at 3000 rpm and 24 V”؛ “including batteries and strap”؛ “either open or closed” | لا شيء. |
قيمتان لكمية واحدة (“at -20 °C and 60 °C”) تحصلان على الملاحظة. و“, and” تنهي شرطًا: “… when the level falls below 10 %, and restart when …” نتيجة. والفاعل الذي يعمل كواحد (“The Owner and the Contractor shall agree …”، “The power and data connector shall …”) لا يحصل على ملاحظة؛ والفاعلان اللذان يعمل كل منهما (“The pump and the valve shall close …”) يحصلان على الملاحظة. ولا تُعلَّم أدوات المقارنة (“12 or more”). ولا يمكن تمييز اسم بعد الفعل من قيمتين، لذا أدرجه تحت الأسماء المركبة.
الأسماء المركبة. في صفحة الجودة، يفتح المزيد ▾ ← الأسماء المركبة… قائمة المشروع بالأسماء التي تحوي “and” أو “or” لكنها تسمّي شيئًا واحدًا، اسمًا في كل سطر (مثل “power and data connector”). ولا يعلّمها R19. وتُحتسب أيضًا التوسعات في مسرد الاختصارات في المشروع (عبارات Acronym، انظر العثور على الاختصارات)، وبعض الأسماء الشائعة مدمجة (“command and control”، “research and development”، “operations and maintenance”، …). وتُحفظ القائمة مع المشروع ويمكن التراجع عنها. انقر فحص الجودة مجددًا لتطبيق تغيير.
المتطلبات بلغات أخرى
يكتشف Holarch لغة كل متطلب من نصه. وتقيّم قواعد الكلمات (R2–R10 وR16 وR19 وR20 وR24 وR26 وR31–R35 و“up to” والفعل المساعد والوحدات) المتطلبات الإنجليزية.
الألمانية والفرنسية والإسبانية (تجريبي). تحصل هذه المتطلبات على القواعد نفسها بلغتها، مثل “angemessen” أو “bei Bedarf” في الألمانية، و“approprié” أو “si possible” في الفرنسية، و“adecuado” أو “según corresponda” في الإسبانية. وما دامت قواعد لغة ما تجريبية:
- كل نتيجة اقتراح معلَّم بـ (تجريبي). وتُعرض بالرمادي مع الملاحظات الأخرى ولا تخفض أبدًا معيارًا ولا الدرجة؛
- تُعرض الملاحظة “قواعد الصياغة لهذه اللغة تجريبية: اقتراحات فقط بلا تسجيل درجات. تُطبَّق فحوص البنية.”، ويكون Unambiguous – (لم يُفحص) حتى تُفحص الصياغة بالذكاء الاصطناعي أو تُقيَّم يدويًا؛
- الكلمات المقابلة لـ “each” (jede، chaque، cada) هي الاختيار الصحيح ولا تُعلَّم، ولا “alle 5 s” أو “tous les 5 s” (every 5 s).
لا تبدأ قاعدة بالاحتساب للغة إلا بعد قياسها على 300 عبارة على الأقل مكتوبة بتلك اللغة ومراجعتها من مهندس متطلبات ناطق بها أصلًا (90 % على الأقل من نتائجها صحيحة)، واعتماد المراجع لها. وحين يحدث ذلك، قد تتغير درجات تلك اللغة في الفحص التالي؛ وتذكر ملاحظات الإصدار ذلك.
اللغات الأخرى (اليابانية والإيطالية والصينية والبقية) تحصل على:
- الملاحظة “قواعد الصياغة تشمل الإنجليزية. تُطبَّق فحوص البنية.” و– (لم يُفحص) لـ Unambiguous: يُستبعد من الدرجة حتى تُفحص الصياغة أو تُقيَّم يدويًا. ولا تزال نتيجة Unambiguous أخرى، مثل TBD، تُفشله؛
- الفحوص لأي لغة: R18 (وكذلك 。)، والنقطة الختامية (وكذلك 。)، وR17، وR21، وTBD/TBR، وR30، والاسم، والوصف، ورابط التحقق.
كل لغة، تجريبية أو لا، تحصل أيضًا على تلك الفحوص. وتُخزَّن الاقتراحات بالإنجليزية مع الكلمات مقتبسة كما كُتبت (“R7 - Imprecise wording: [angemessen] (beta)”)، فيعمل عامل التصفية quality:R7 والصادرات بالطريقة نفسها في كل لغة. وتعيدها الواجهة البرمجية العامة مع قاعدتها وكلماتها ووضعها (findings).
التحقق من الصياغة بالذكاء الاصطناعي. يطبّق ✦ الذكاء الاصطناعي ▾ ← التحقق من الصياغة بالذكاء الاصطناعي… في صفحة الجودة (أو ✦ المزيد من الذكاء الاصطناعي ▸ على متطلب واحد) القواعد نفسها عبر الذكاء الاصطناعي المهيأ بلغة كل متطلب. وتسرد المعاينة النتائج وإعادة صياغة اختيارية بتلك اللغة (غير محددة). ويضيف تطبيق المحدد النتائج بوصفها نتائج ذكاء اصطناعي ويزيل الملاحظة (تبقى الاقتراحات التجريبية ملاحظات)، في خطوة تراجع واحدة. وتحرير النص يمسحها. ويحتاج ذلك إلى خطة فيها ذكاء اصطناعي.
التجاوزات اليدوية
تجاوز معيارًا حين تختلف مع النتيجة التلقائية، أو لتسجيل قرار مراجع.
- في صفحة الجودة: انقر خلية معيار لتدويرها: تضبط النقرة الأولى نعم يدوية (✔)، والتالية لا يدوية (✘)، وتمسح الثالثة القيمة اليدوية فيقرر الفحص التلقائي مجددًا. وتُظهر الخلية اليدوية علامة يدوية؛ ويقول تلميحها “(معيّن يدويًا)” وما تفعله النقرة التالية.
- في لوحة الخصائص أو عرض العنصر: كل معيار قائمة فيها نعم ولا. والمعيار المضبوط يدويًا يعرض أيضًا تلقائي (افحص مجددًا)، الذي يعيده إلى النتيجة التلقائية. وتُظهر القيم المضبوطة يدويًا “يدوي”.
تُحفظ القيمة اليدوية حين يُعاد تشغيل الفحص. وتُظهر “لا” اليدوية التي ليس معها رسالة أخرى “عُلِّم بلا يدويًا.”
تُمسح التجاوزات في حالتين:
- يتغير اسم المتطلب أو وصفه. وتبقى التجاوزات في السجل، ويعيدها التراجع.
- تختار المزيد ▾ ← مسح التقييمات اليدوية. ويمسح هذا أيضًا نتائج الذكاء الاصطناعي المقبولة.
النتائج القديمة
حين يتغير اسم متطلب أو وصفه بعد فحص، تُعلَّم نتائجه قديمة:
- تُظهر صفحة الجودة “قديم — أعد التشغيل” مع التلميح “تغيّر النص بعد آخر فحص. شغّل فحص الجودة مجددًا.”
- يُظهر عمود درجة الجودة في المستند وسم قديم مع أيقونة ساعة (أشر إليه لمعرفة السبب).
- تُظهر لوحة الخصائص “الجودة: قديمة — أعد التشغيل”.
فعّل إعادة الفحص تلقائيًا عند تغيّر النص لتجنب النتائج القديمة. فيعيد Holarch حينئذ تشغيل فحص القواعد على المتطلب المحرَّر فورًا. ويُحفظ الإعداد في هذا المتصفح.
فحص الجودة من مستند
في مستند، اختر الفحص ▾ ← فحص الجودة. ومع تحديد متطلب، يقرأ العنصر فحص جودة هذا المتطلب ويفحص ذلك المتطلب. ومن دون تحديد متطلب، يفحص كل متطلب ظاهر في المستند.
تُفتح النتائج في مربع الحوار فحص الجودة — <name>، مع المربعات والجدول. وأزراره تصدير CSV وتصدير XLSX وفتح في الجودة وإغلاق.
يُظهر المستند الذي لا متطلبات فيه “لا يحتوي هذا المستند على Requirements لفحصها. لا تُقيَّم Statements.”
فحص المتطلبات بالذكاء الاصطناعي
استخدم فحص المتطلبات بالذكاء الاصطناعي لرأي أولي في المعايير التي لا تستطيع قاعدة تقريرها: Correct وFeasible وNecessary. ويبحث أيضًا عن صياغة تفوت القواعد تحت Unambiguous (مثل “up to 72 hours” حيث يبدو أن المقصود حد أدنى، أو “accurately” دون مقياس) وVerifiable (لا يمكن لأي اختبار أو تحليل أو فحص أو عرض إثبات استيفاء المتطلب بصيغته الحالية). ويتلقى الذكاء الاصطناعي نتائج القواعد ولا يبلغ إلا عما تفوته.
- اختر ✦ الذكاء الاصطناعي ▾ ← التحقق بالذكاء الاصطناعي (N متطلبات)….
لمتطلب واحد، اختر التحقق بالذكاء الاصطناعي (هذا المتطلب)… في قائمة ✦ الذكاء الاصطناعي ▾ الخاصة به، أو ✦ المزيد من الذكاء الاصطناعي ▸ ← ✦ التحقق بالذكاء الاصطناعي… في قائمة النقر بالزر الأيمن.
يراجع Claude المتطلبات. وتُرسل في مجموعات من 20، مع ما يصل إلى 300 متطلب آخر لفحوص التكرار. وعلى الذكاء الاصطناعي المضمَّن يحتسب الفحص طلبًا واحدًا لكل 100 متطلب (مقرّبًا للأعلى)؛ وقبل تشغيل فحص لأكثر من 100 متطلب، يذكر مربع حوار عدد الطلبات التي يستخدمها، مثل “تستخدم هذه المراجعة 3 من 52 طلب ذكاء اصطناعي مضمَّنًا متبقيًا هذا الشهر (طلب واحد لكل 100 متطلب).” ولا يبدأ الفحص الذي يحتاج إلى طلبات أكثر مما تبقى.
- راجع كل متطلب في مربع الحوار.
يذكر السطر في الأعلى ما يبدأ محددًا: “تُطبَّق العناصر المحددة. تبدأ إعادات الصياغة دون تحديد لتقرأها أولًا. تبدأ المتطلبات المقفلة والمعتمدة والمدرجة في خط أساس دون تحديد.”
- حدّد التغييرات وإعادات الصياغة التي تقبلها.
يعدّ السطر فوق الأزرار ما يفعله التطبيق، مثل “يطبّق 7 قيم وإعادتي صياغة على 5 متطلبات.” ومن دون تحديد يقرأ “لم يُحدد شيء.” ويُعتَّم تطبيق المحدد.
- انقر تطبيق المحدد.
تُطبَّق العناصر المحددة، ويُلغي تراجع واحد ذلك كله. ويقرأ الإشعار “طُبِّق N تغييرات بالذكاء الاصطناعي”.
لكل متطلب، يُظهر مربع الحوار:
- حكمًا بنعم/لا وسببًا لـ Correct وFeasible وNecessary وUnambiguous وVerifiable.
- تحت كل حكم، مربع اختيار عنوانه ما يغيّره تطبيقه، أو “بلا تغيير” دون مربع اختيار حين تطابق القيمة المخزَّنة بالفعل:
- Correct وFeasible وNecessary: “لا ← نعم” أو “نعم ← لا” حين يختلف الحكم عن القيمة المخزَّنة، و“الضبط على نعم” أو “الضبط على لا” حين لا توجد قيمة.
- Unambiguous وVerifiable: “يضيف نتيجة” حيث وجد الذكاء الاصطناعي مشكلة، و“يمسح النتيجة السابقة” حيث لم تعد نتيجة ذكاء اصطناعي سابقة صالحة.
- تعليقًا اختياريًا.
- حيث يقترح الذكاء الاصطناعي إعادة صياغة، مربع الاختيار تطبيق إعادة الصياغة: مع فرق على مستوى الكلمات.
ما يبدأ محددًا:
- يبدأ كل تغيير في القيم محددًا.
- تبدأ إعادات الصياغة دون تحديد، لتقرأها أولًا.
- تبدأ المتطلبات المعتمدة والمدرجة في خط أساس والمقفلة دون تحديد وتُعلَّم.
تحديد إعادة صياغة يعتّم مربعي Unambiguous وVerifiable لذلك المتطلب ويسمّيهما “أُعيد الفحص بعد إعادة الصياغة”: إذ تُشغَّل فحوص القواعد مجددًا على النص الجديد. وإلغاء تحديد إعادة الصياغة يعيد المربعين كما كانا. ولا تزال Correct وFeasible وNecessary تُطبَّق.
| الزر | الأثر |
|---|---|
| تحديد كل تغييرات القيم | يحدد كل تغيير في القيم، إلا في المتطلبات المعتمدة والمدرجة في خط أساس والمقفلة. |
| تحديد كل إعادات الصياغة | يحدد كل إعادة صياغة، إلا المعلَّمة. |
| عدم تحديد أي شيء | يلغي تحديد كل شيء. |
ما يفعله التطبيق:
- تصبح Correct وFeasible وNecessary قيم نعم/لا يدوية.
- تصبح “لا” في Unambiguous أو Verifiable نتيجة ذكاء اصطناعي: تسردها صفحة الجودة مع نتائج القواعد، بوصفها “الذكاء الاصطناعي: غامض — <reason>” أو “الذكاء الاصطناعي: غير قابل للتحقق بصيغته الحالية — <reason>”، ويُظهر المعيار ✘. وتزيل “نعم” نتيجة ذكاء اصطناعي سابقة.
- تُمسح نتائج الذكاء الاصطناعي حين يتغير اسم المتطلب أو وصفه (ومنه بإعادة صياغة مقبولة) وبـ المزيد ▾ ← مسح التقييمات اليدوية.
ما يفعله تطبيق المحدد:
- تصبح الأحكام قيمًا يدوية، مع الرسالة “الذكاء الاصطناعي: <reason>”. وتُحفظ حين يُعاد تشغيل الفحص.
- تستبدل إعادات الصياغة الوصف وتعيد تشغيل الفحص.
صادرات الجودة
| تصدير | المحتوى |
|---|---|
تصدير ▾ ← CSV (quality_report.csv) | صف لكل متطلب ومعيار: Number وName وDescription وQuality Score وAttribute وMessage وResult. |
تصدير ▾ ← Excel (.xlsx) (quality_report.xlsx) | Number وName وDescription وRationale وQuality Score وAttribute وMessage وResult، مع دمج خلايا المتطلب عبر صفوفه التسعة، وYes بالأخضر وNo بالأحمر، ودرجة التقرير (إجابات Yes على كل الإجابات) في النهاية. |
| التسليم ▾ ← كل الصادرات… ← نتائج الجودة (Excel) في المستند | التخطيط نفسه لمستند واحد، مع أعمدة العرض الخاصة بالمستند. |
الاعتمادات
استخدم الاحتياجات والمتطلبات ← الموافقات لرؤية كل ما ينتظر قرارًا. وهي تفتح قاعدة البيانات بالاستعلام Requirement:"Status=In Review".
فيها كل ميزة في قاعدة البيانات:
- حدّد عدة صفوف واستخدم شريط الإجراءات المجمّعة لضبط Status أو التسميات معًا.
- صدّر القائمة.
- انقر صفًا نقرًا مزدوجًا لعرض العنصر والسجل الكامل.
مربع الموافقة
يظهر مربع الموافقة في لوحة الخصائص وعرض العنصر لكل متطلب. ويُظهر:
- الحالة الحالية شريحةً ملونة (Draft حين لا تكون مضبوطة).
- آخر قرار مسجَّل: “<status> بواسطة <name> · <date and time>”، يتبعه “— <note>” حين توجد (مثل “— تغيّر النص بعد الموافقة”)، أو “لم تُسجَّل موافقة”.
- الأزرار التي تنطبق على الحالة الحالية:
| الزر | يظهر حين | الأثر |
|---|---|---|
| اعتماد | الحالة ليست Approved ولا Rejected | يضبط Approved ويسجّلك والوقت. الإشعار: “تم الاعتماد”. |
| رفض… | الحالة ليست Approved ولا Rejected | يطلب السبب (اختياري) في مربع الحوار رفض المتطلب، ثم يضبط Rejected. الإشعار: “تم الرفض”. |
| إعادة فتح | الحالة Approved أو Rejected | يضبط In Review. الإشعار: “نُقل إلى In Review”. |
الاسم المسجَّل هو اسم حسابك. وضبط Status يدويًا في جدول أو في لوحة الخصائص يسجّل أيضًا قرارًا باسمك والوقت. ويرى المشاهدون المربع دون أزرار.
حين يرسل سير عمل الانتقال إلى Approved عبر طلب تغيير، يُظهر المربع الطلب المفتوح وعدده بدلًا من ذلك، مثل CR-4: موافقة واحدة من 3. وبمجرد تطبيقه، يسمّي القرار كل موافِق والطلب: “اعتمده Ann Lead وBob Discipline · <date and time> · CR-4”.
ملاحظة: تحرير اسم متطلب Approved أو وصفه يضبطه على In Review، مع الملاحظة “تغيّر النص بعد الموافقة”. ويبلغ الإشعار “نُقل N متطلب معتمد إلى In Review.” وتغيير السمات الأخرى لا يعيد فتحه.
سجل TBD/TBR
استخدم السجل لتتبع كل بند مفتوح حتى يُغلق. افتح الاحتياجات والمتطلبات ← TBD/TBR. ومن مستند، اختر الفحص ▾ ← سجل TBD/TBR لفتح السجل مقصورًا على ذلك المستند.
- رأس الصفحة: تصدير XLSX (معطَّل حين يكون السجل فارغًا).
- شريط النطاق: النطاق (كل المتطلبات أو المستند: <name>).
- المربعات: TBD/TBR المفتوحة، ومتأخرة، وبلا مالك، وشرائح لكل مستند (“<document>: <count>”) التي تفتح كل مستند.
- العناصر المفتوحة عبر الزمن: مخطط إنجاز متبقٍّ للعدد المفتوح. ويُعاد بناؤه من سجل المتطلبات، بما يصل إلى 60 نقطة من أقدم متطلب حتى الآن. وأشر إلى نقطة لمعرفة تاريخها وعددها. ومع سجل غير كافٍ يُظهر “لا يوجد سجل كافٍ لمخطط الإنجاز المتبقي بعد.”
- أعمدة الجدول:
- الرقم، والاسم مع الوصف.
- المستند.
- النوع: TBD أو TBR أو TBS، مع “سمة” أو “في النص” أو كليهما.
- المالك: TBD Owner، وإلا Owner المتطلب، وإلا “—”.
- تاريخ الاستحقاق: تاريخ الاستحقاق الوحيد للمتطلب، وهو التاريخ نفسه الذي في تاريخ الاستحقاق في مجموعة سير العمل في لوحة الخصائص وفي عرض العنصر. وهو سمة TBD Due Date حين تحوي تاريخًا، وإلا تاريخ استحقاق المتطلب. ويُظهر “متأخر” تحت تاريخ مضى. والصفوف المتأخرة ملوّنة.
- العمر: الأيام منذ فتح البند.
- إغلاق.
انقر صفًا بالزر الأيمن، أو اضغط Shift+F10 عليه، لقائمة الصف نفسها التي في قاعدة البيانات: إجراءات مقترحة مع أسبابها، و✦ المزيد من الذكاء الاصطناعي ▸، وفتح، وإعادة تسمية…، وتكرار، وإضافة عنصر فرعي…، والحالة ▸، والأولوية ▸، وربط بـ ▸، وإضافة إلى مستند ▸، وإظهار في المخطط ▸، ونسخ الرابط، ونسخ الرقم وحذف…. وفي قوائم النقر بالزر الأيمن الأخرى، يبدأ المتطلب الذي فيه TBD أو TBR مفتوح بـ حل TBD…، الذي يفتح هذا السجل مع تحديد المتطلب.
السجل للقراءة فقط. ولتغيير تاريخ استحقاق، حدّد الصف واضبط تاريخ الاستحقاق في لوحة الخصائص. ويضبط Holarch تاريخ استحقاق المتطلب، وحين تحوي سمة TBD Due Date تاريخًا، تلك السمة أيضًا (مع الإبقاء على وقتها من اليوم)، ويُلغي تراجع واحد ذلك كله. ومسح تاريخ الاستحقاق يمسح كليهما.
لا يظهر إغلاق إلا حين تكون سمة TBD/TBR مضبوطة. ويضبط السمة على None:
- حين لا يتبقى شيء في النص، يقرأ الإشعار “أُغلق”.
- حين يبقى TBD أو TBR أو TBS في النص، يقرأ الإشعار “أُغلقت السمة؛ لا يزال النص يحتوي على TBD.”
- البند النصي فقط ليس له زر إغلاق؛ حرّر النص لإغلاقه.
حين لا يكون شيء مفتوحًا، تُظهر الصفحة “لا بنود TBD/TBR مفتوحة. اضبط سمة TBD/TBR لمتطلب، أو اكتب TBD أو TBR أو TBS في نصه، لإدراجه هنا.”
يكتب تصدير XLSX الملف TBD-TBR Register.xlsx مع Number وName وDocument وType وSource (attribute أو text أو كليهما) وOwner وDue Date وOpened وAge (days) وOverdue (Yes بالأحمر) وDescription.
روابط للمراجعة
استخدم روابط للمراجعة (وتُسمّى أيضًا الروابط المشبوهة في أدوات أخرى) للعثور على ما يجب إعادة فحصه بعد تغيّر متطلب. ويحتاج الرابط إلى مراجعة حين يتغير العنصر في طرفه الآخر بعد آخر مراجعة للرابط: تحقق من أن الرابط لا يزال صالحًا، ثم علّمه كمُراجَع. ويسردها الاحتياجات والمتطلبات ← روابط للمراجعة. ومن مستند، استخدم الفحص ▾ ← روابط للمراجعة.
ما الذي يعلّم رابطًا للمراجعة
هذه التغييرات على متطلب تعلّم روابطه للمراجعة:
- الاسم أو الوصف.
- Priority أو Criticality أو Verification Method أو Verification Level.
- أي سمة رقمية أو نسبة مئوية أو مدة.
يعلّم Holarch حينئذ كل رابط للمتطلب من هذه الأنواع: decomposed by وderived by وrefined by وsatisfied by وverified by وtraced to.
تغيير Verification Method أو Verification Level لا يعلّم إلا روابط verified by. وضبط أول طريقة أو مستوى لمتطلب لا يعلّم شيئًا: فهو يخطط التحقق ولا يغيّر شيئًا تمت مراجعته.
الطرف الآخر لكل رابط هو العنصر المراد مراجعته: المتطلب الفرعي، أو الوظيفة أو الأصل الذي يستوفيه، أو حالة الاختبار التي تتحقق منه، وهكذا. والتغييرات الإضافية على المتطلب نفسه تُضاف إلى قائمة الحقول المتغيرة في العلامة نفسها.
أين تظهر الروابط للمراجعة
- صفحة روابط للمراجعة: صف لكل رابط للمراجعة.
- المستندات وقاعدة البيانات: شارة ⚠ مراجعة على صف العنصر (“تغيّر العنصر في الطرف الآخر بعد آخر مراجعة لهذا الرابط. تحقق من أن الرابط لا يزال صالحًا، ثم علّمه كمُراجَع. انقر للمراجعة.”).
- لوحة الخصائص وعرض العنصر: شريط “⚠ مراجعة: تغيّر <requirement> بعد آخر مراجعة لهذا الرابط. تحقق من أن الرابط لا يزال صالحًا، ثم علّمه كمُراجَع.” ويفتح زره مراجعة… مربع الحوار روابط للمراجعة — <item> لذلك العنصر، مع الروابط المفتوحة للمراجعة وإغلاق.
- قسم التتبع في لوحة الخصائص: ⚠ بجانب كل رابط للمراجعة، مع الحقول المتغيرة والتاريخ في تلميحه.
- RVTM: ⚠ بعد متطلب له رابط للمراجعة في أي من الطرفين (تغيّر هو، أو تغيّر العنصر الذي في المنبع منه)؛ انقرها لمراجعة تلك الروابط. وتعلّم ⚠ بعد حالة اختبار في يُتحقق منه بواسطة رابط التحقق ذلك.
صفحة روابط للمراجعة
تشرح الصفحة القاعدة في الأعلى وتُظهر جدولًا:
| العمود | المحتوى |
|---|---|
| (مربع اختيار) | التحديد لـ تعليم المحدد كمُراجَع…. ويحدد مربع الاختيار في الرأس الكل. |
| معدَّل | المتطلب الذي تغيّر. |
| التغيير | الحقول التي تغيّرت، مثل “Description” أو “Priority, Verification Level”. |
| متى / بواسطة | تاريخ التغيير ووقته ومن أجراه. |
| العلاقة | نوع الرابط، مقروءًا من المتطلب المتغير (مثل “satisfied by”). |
| العنصر المراد مراجعته | العنصر في الطرف الآخر من الرابط. |
| (الإجراءات) | الفرق وتعليم كمُراجَع…. |
انقر صفًا بالزر الأيمن، أو اضغط Shift+F10 عليه، لقائمة صف العنصر، كما في قاعدة البيانات: إجراءات مقترحة، و✦ المزيد من الذكاء الاصطناعي ▸، وفتح، وإعادة تسمية…، وتكرار، وإضافة عنصر فرعي…، والحالة ▸، والأولوية ▸، وربط بـ ▸، وإضافة إلى مستند ▸، وإظهار في المخطط ▸، ونسخ الرابط، ونسخ الرقم وحذف…. وفي قوائم النقر بالزر الأيمن الأخرى (قاعدة البيانات، المستندات)، يبدأ العنصر الذي له رابط للمراجعة بـ مراجعة الرابط…، الذي يفتح المراجعة له.
يفتح الفرق التغيير — <requirement> مع فرق على مستوى الكلمات للاسم والوصف. وحين تتغير السمات فقط، يقرأ “تغيرت السمات فقط: <fields>. افتح سجل الكيان للتفاصيل.” ويفتح المحفوظات… سجل المتطلب.
لتعليم الروابط كمُراجَعة:
- انقر تعليم كمُراجَع… على صف، أو تعليم المحدد كمُراجَع… للصفوف المحددة، أو تعليم الكل كمُراجَع (N)….
يُفتح تعليم N روابط كمُراجَعة: “أكّد أن العناصر المرتبطة لا تزال صحيحة بعد التغيير. يُضاف تعليق إلى كل عنصر مرتبط.”
- اكتب تعليقًا اختياريًا، مثل “لا يزال الابن صالحًا؛ لا حاجة إلى تغيير.”
- انقر تعليم كمُراجَع.
يقرأ الإشعار “عُلّمت N روابط كمُراجَعة.”
يُظهر تعليم المحدد كمُراجَع… دون تحديد “حدد الروابط المراد تعليمها كمُراجَعة أولًا.”
تعليم رابط كمُراجَع يسجّل المراجعة على الرابط: من، ومتى، والتعليق، والحقول. وحين تكتب تعليقًا، يضيف Holarch أيضًا “رُوجع الرابط (تغيّر <requirement>: <fields>): <comment>” إلى تعليقات كل عنصر. والتراجع يعكس ذلك.
حين لا توجد روابط للمراجعة، تُظهر الصفحة “لا روابط للمراجعة. يحتاج الرابط إلى مراجعة عندما يتغير العنصر في طرفه الآخر بعد آخر مراجعة له.”
خطوط الأساس ومقارنة الإصدارات
خطوط أساس المستندات
أنشئ خطوط أساس المستندات واستخدمها بـ الإصدار ▾ في كتلة عنوان المستند. وهو يسرد:
- الإصدار الحالي: المستند الحي.
- كل خط أساس لهذا المستند، الأحدث أولًا، مع تاريخه.
- تحت خطوط أساس المشروع، كل خط أساس للمشروع.
- حفظ خط الأساس… ومقارنة النسخ… (معتَّم حتى يكون للمستند خط أساس: “احفظ خط أساس أولًا”).
يفتح حفظ خط الأساس… حفظ خط الأساس:
- الاسم * (مطلوب).
- الموافقات: صفوف من الاسم والدور والبيان، مع + إضافة معتمِد. ويُملأ الصف الأول باسمك. و“لا معتمِدين.” حين تكون فارغة.
- الملاحظة “يحتفظ خط الأساس بهذا الإصدار من المستند (عناصره وسماتها وعلاقاتها) لعرضه ومقارنته واستعادته لاحقًا. تُؤرَّخ سجلات الموافقة الآن ولا يمكن تحريرها بعد ذلك.”
اختر خط أساس في الإصدار ▾ لعرضه. ويصبح المستند للقراءة فقط، مع الشريط “خط الأساس “<name>”، للقراءة فقط، محفوظ في <date>” وقائمة الموافقات. وتظهر هذه الأزرار:
| الزر | الأثر |
|---|---|
| العودة إلى الحالي | يعيد إلى المستند الحي. |
| التعديل | تحرير خط الأساس: إعادة تسميته وإضافة سجلات موافقة. ويسرد الموافقات (مقفلة) السجلات الموجودة، التي لا يمكن أن تتغير؛ والسجلات الجديدة “تُؤرَّخ الآن وتُضاف إلى القائمة”. لخطوط أساس المستندات فقط. |
| المقارنة بالحالي | يفتح مقارنة الإصدارات من خط الأساس هذا. لخطوط أساس المستندات فقط. |
| استعادة خط الأساس | خط أساس المستند: “هل تريد استبدال كيانات هذا المستند وترتيبها وبنيتها بخط الأساس “<name>”؟ تُزال الكيانات المضافة منذئذ من المستند (ولا تُحذف). والتراجع متاح.” خط أساس المشروع: استبدال المشروع بخط الأساس، “هل تريد استبدال المشروع كله بخط أساس المشروع “<name>”؟ والتراجع متاح.” |
| حذف | “هل يُحذف خط الأساس “<name>”؟” |
في المستند الحي، يحمل كل صف شريط تغيير: جديد منذ خط الأساس، أو متغير منذ خط الأساس، أو دون تغيير. ويقارن بأحدث خط أساس للمستند، أو بأحدث خط أساس للمشروع حين لا يكون للمستند خط أساس.
مقارنة الإصدارات
استخدم تقرير التغييرات لترى بالضبط ما تغيّر منذ مراجعة.
- انقر الإصدار ▾ ← مقارنة النسخ…، أو المقارنة بالحالي في شريط خط أساس.
يُفتح مقارنة الإصدارات.
- اختر من: خط أساس.
- اختر إلى: خط أساس لاحقًا، أو الإصدار الحالي.
يسرد الجدول الرقم والاسم وتغيير النوع والحقل والتغيير (فرق على مستوى الكلمات للنص المعدَّل).
أنواع التغيير:
| نوع التغيير | المعنى |
|---|---|
| مُضاف / مُزال | انضم الكيان إلى المستند أو غادره. |
| معدَّل | تغيّر حقل: Name أو Number أو Description أو Class أو Image أو أي سمة (يُسمّى الحقل). |
| أُضيفت تسمية / أُزيلت تسمية | أُضيفت تسمية أو أُزيلت. |
| أُضيفت علاقة / أُزيلت علاقة | أُضيف رابط يمس المستند أو أُزيل. |
| سمة علاقة | تغيّرت سمات علاقة. |
يكتب التغييرات (Excel) “<document> (Changes).xlsx” مع Number وName وClass وChange Type وField وOld Value وNew Value. ويكتب التعديلات المعلَّمة (Word) المقارنة نفسها بوصفها تغييرات متعقَّبة في Word.
يصدّر التسليم ▾ ← التغييرات (Excel)… في المستند (وأيضًا في كل الصادرات…) التقرير نفسه مع من وإلى. ويفشل بالرسالة “لا يحتوي هذا المستند على خط أساس. احفظ خط أساس أولًا.” حين لا يوجد.
يملأ المستند (Word) جدولي Revision History وApprovals في مخرجات Word من خطوط أساس المستند.
صفحة خطوط الأساس والإصدارات
استخدم التحكم والمراجعات ← خطوط الأساس والإصدارات لإدارة كل خط أساس في المشروع. وتحوي خطوط أساس المشروع كل كيان؛ وتحوي خطوط أساس المستندات مستندًا واحدًا وتُنشأ بـ الإصدار ▾ ← حفظ خط الأساس… في المستند. وفي رأس الصفحة استعادة إصدار سابق…، الذي يعيد حفظًا تلقائيًا سابقًا للمشروع كله، و+ حفظ خط الأساس….
لإنشاء خط أساس للمشروع:
- انقر + حفظ خط الأساس… في رأس الصفحة.
يُظهر مربع الحوار حفظ خط أساس المشروع أعداد الكيانات والعلاقات الحالية. والاسم الافتراضي “Baseline <n>”؛ ويقرأ النص النائب “الاسم، مثل “SRR””.
- اكتب اسمًا، ثم اضغط Enter أو انقر حفظ خط الأساس. ويُرفض الاسم الفارغ (“أدخل اسمًا.”).
يقرأ الإشعار “تم حفظ خط الأساس”.
بطاقات الصفحة:
- بطاقة خطوط الأساس: الأعداد الحالية (“الحالي: <n> عنصر، <n> علاقة”) وعامل تصفية: كل خطوط الأساس، أو خطوط الأساس على مستوى المشروع أو المستند: <name>. الأعمدة:
- الاسم.
- المستند: رابط لعرض المستند عند خط الأساس ذلك، أو “المشروع”.
- أُنشئ.
- الموافقات: “✔” وأسماء المعتمِدين. أشر إليها لمعرفة الدور والتاريخ والبيان. ويسمّي “بواسطة <name>” المنشئ.
- الكيانات والعلاقات.
- مقارنة: يضبط خط الأساس هذا في “من” ونسخة العمل الحالية في “إلى”.
- ⋯ (إجراءات أخرى):
- إعادة تسمية…: إعادة تسمية خط الأساس.
- تصدير (JSON): ينزّل “<name>.json” (الصيغة
holarch-baseline، مع اللقطة والموافقات). - استعادة خط الأساس… (خط أساس المشروع): “هل تريد استبدال كل الكيانات والعلاقات الحالية بخط الأساس “<name>”؟ والتراجع متاح (⌘Z / Ctrl+Z).” الإشعار: “تمت استعادة “<name>””.
- إرجاع المستند… (خط أساس المستند): “هل تريد استعادة المستند “<doc>” إلى خط الأساس “<name>”؟ تتغير كيانات ذلك المستند وبنيته فقط. يمكن التراجع.” ومعطَّل حين يكون المستند قد حُذف.
- حذف…. وعلى الخدمة المستضافة لا يعيد تسمية خط أساس أو يحذفه إلا مالكو المشروع؛ وللآخرين تكون هذه العناصر رمادية مع السبب.
- خطوط أساس يتيمة (تظهر عند الحاجة): “N خطوط أساس لمستندات محذوفة”. ولكل منها استعادة المستند، الذي يعيد إنشاء مادة المستند وكياناته من خط الأساس، وحذف.
- بطاقة مقارنة: اختر من (الأقدم) وإلى (الأحدث). و“إلى” هو الإصدار الحالي أو خط أساس آخر من النطاق نفسه.
- المربعات: الكيانات المضافة، والكيانات المزالة، والكيانات المتغيرة، وتغييرات العلاقات.
- يُظهر الجدول الكيان والتغيير والحقل والفرق (فرق على مستوى الكلمات). وتظهر سمات التاريخ بتنسيق التاريخ في التطبيق.
- يكتب تصدير CSV وتصدير XLSX “Changes <from> to <to>”.
- حين لا يوجد ما يُعرض: “لا توجد فروق بين “<from>” و“<to>”.”
حين لا توجد خطوط أساس: “لا خطوط أساس. أنشئ واحدًا لتسجيل الحالة الراهنة للمشروع.”
ملاحظة: تُخزَّن خطوط الأساس في المشروع وتنتقل معه في تصدير المشروع. ويحوي خط أساس المشروع الكيانات والعلاقات. ويحوي خط أساس المستند أيضًا إعدادات المخطط التفصيلي للمستند.
استيراد المتطلبات
استخدم الاحتياجات والمتطلبات ← الاستيراد والتصدير لجلب المتطلبات من الملفات. ويعمل في أربع خطوات: الملف ← الربط ← المراجعة ← الاستيراد.
- ينقل رجوع ومتابعة بين الخطوات. ويستورد استيراد N عناصر في خطوة المراجعة، ويُلغي تراجع واحد ذلك كله.
- تقبل منطقة إفلات واحدة كل صيغة. وتُكتشف الصيغة من الملف (اسمه، ومحتواه حين لا يكفي ذلك) وتظهر تحت التنسيق، حيث يمكنك تغييرها.
الصيغ هي Word (.docx)، وملفات مشاريع Holarch (.holarch, .json)، وExcel / CSV (.xlsx, .csv)، ونص عادي (.txt)، وUML/SysML (.xmi, .uml, .mdzip) وReqIF (.reqif).
يتناول هذا القسم صيغ المتطلبات. ولملفات المشاريع وXMI وكل استيراد وتصدير آخر، انظر الاستيراد والتصدير.
الخطوة 1: الملف
أفلت ملفًا على “أفلت ملفًا هنا أو انقر لاختيار ملف”، أو الصق نصًا في المربع وانقر تحليل النص (CSV بصف رأس، أو ReqIF XML، أو XMI، أو JSON، أو نص مستند).
| الخيار | القيم | الأثر |
|---|---|---|
| الصيغة | الصيغ الست أعلاه | يُظهر الصيغة المكتشفة. اختر غيرها لقراءة المحتوى نفسه بطريقة أخرى. |
| ترميز النص (CSV، النص) | تلقائي، UTF-8، ISO-8859-1 / Windows-1252، Shift_JIS، Big5، UTF-16 | كيف تُقرأ بايتات الملف. وتغييره يعيد قراءة الملف. |
| الورقة (المصنفات) | “<name> (N صفوف)” | الورقة المراد استيرادها. وتُحدَّد مسبقًا أول ورقة فيها بيانات. |
- النص العادي: يُبقي المربع المحتوى المستورد قابلًا للتحرير. حرّره وانقر إعادة التحليل.
- يقرأ سطر الحالة “حُلِّل “<file>”: N صفوف، M أعمدة.” (إضافة إلى “(الورقة “<name>”)”، ولـ Word، “، N جداول”).
الخطوة 2: الربط
كل عمود في الملف صف واحد: عمود الملف (العنوان والموضع)، وقيم نموذجية (الصفوف الثلاثة الأولى) وحقل Holarch. اختر تخطٍّ لاستبعاد عمود. وتُعلَّم الحقول المطابَقة من عنوان العمود بـ تلقائي.
| حقل Holarch | المحتوى |
|---|---|
| الاسم، الرقم، الوصف | حقول العنصر الخاصة. |
| الفئة، التسميات | اسم الفئة؛ وأسماء التسميات مفصولة بـ ; أو , أو |. |
| رقم الأصل، المعرّف العام | رقم الأصل؛ والمعرّف المستخدم لمطابقة الكيانات الموجودة. |
| سمة | أي سمة للفئة الخاصة بالصفوف التي ليست لها فئة. |
| علاقة | افصل بين عدة أهداف بـ ;. |
| معرّف الصف، معرّف صف الأصل، سمة جديدة (تُضاف إلى المخطط الهيكلي) | البنية من ملفات ReqIF وXMI، والسمات الجديدة. |
يقترح ✦ الذكاء الاصطناعي ▾ ← اقتراح ربط حقلًا لكل عمود. ويسرد الربط المقترح التغييرات، محددة، مع سبب الذكاء الاصطناعي؛ ويغيّر تطبيق المحدد الربط. ولا يُستورد شيء بعد.
يخمّن Holarch الربط من الرأس:
| الرأس | يُربط بـ |
|---|---|
| Number، No، Num، #، ID Number، Req Number، Requirement Number | الرقم |
| Name، Title، Short Name، Requirement Name | الاسم |
| Description، Text، Requirement، Requirement Text، Statement، Desc | الوصف |
| Class، Type، Entity Class | الفئة |
| Labels، Label، Tags | التسميات (افصل القيم بـ ; أو , أو |) |
| Parent، Parent Number | رقم الأصل |
| Global ID، ID، GUID، UUID | المعرّف العام |
| اسم سمة (مثل Priority وRationale وStatus) | تلك السمة. ويُربط “Method” و“Verification” بـ Verification Method. |
| اسم مجموعة تسميات (مثل Verification Method حين لا توجد سمة بهذا الاسم) | التسميات |
| اسم علاقة (مثل satisfied by) | تلك العلاقة؛ افصل بين عدة أهداف بـ ; |
| Object Identifier، Origin ID | المعرّف العام |
| Object Number، ReqIF.ChapterName، ReqIF.ForeignID | الرقم |
| Object Heading، ReqIF.Name، Long Name | الاسم |
| Object Text، ReqIF.Text، ReqIF.Description | الوصف |
| ReqIF.Category | الفئة |
| ReqIF ID، XMI ID، Row ID / Parent ID | معرّف الصف / معرّف صف الأصل |
ينشئ سمة جديدة سمة مسمّاة باسم العمود، في كل فئة مستوردة. ويتبع نوعها القيم:
- رقم، حين تكون كل قيمة رقمًا.
- قائمة خيارات، حين تكون هناك قيم قصيرة متمايزة قليلة.
- نص طويل، للقيم التي تتجاوز 120 حرفًا.
- نص في غير ذلك.
لا يمكن ربط معايير الجودة والسمات المحسوبة وسمات الملفات.
تحت الأعمدة:
| الخيار | القيم | الأثر |
|---|---|---|
| فئة الصفوف التي ليست لها فئة | أي فئة؛ والافتراضي Requirement | فئة الصفوف التي ليست لها قيمة في عمود Class ولا قاعدة فئة مطابقة. |
| قواعد الفئات | يحتوي الوصف على كلمة أو عبارة ← فئة | يضيف + قاعدة قاعدة، ويزيلها ×. وتنطبق أول قاعدة مطابقة على الصفوف التي ليست لها قيمة Class. |
| مطابقة الكيانات الموجودة بواسطة | Global ID، Name، Number | الصفوف التي تطابق كيانًا موجودًا تحدّثه بدلًا من إنشاء نسخة. وتتطلب مطابقات Name وNumber أيضًا الفئة نفسها. |
| مطابقة الكيانات المرتبطة بواسطة | Global ID، Name، Number | كيف تجد القيم في أعمدة العلاقات أهدافها. |
| تنسيق التاريخ لأعمدة التواريخ (CSV) | تلقائي، yyyy-MM-dd HH:mm:ss، dd/MM/yyyy، MM/dd/yyyy، yyyyMMdd، مخصص… | كيف تُقرأ خلايا التاريخ. ويُظهر مخصص… حقلًا لنمطك الخاص (مثل dd.MM.yyyy HH:mm) باستخدام yyyy وMM وdd وHH وmm وss. |
| نمط الترقيم (Word، النص) | فارغ (تلقائي)، أو علامات مثل 1. a) (i)، أو أرقام مسارات مثل 1.1 أو 1.1.a | كيف تصبح الفقرات المرقمة المخطط التفصيلي. وللنص، يُكتشف النمط من الترقيم ويُملأ. ولا تحتاج أنماط العناوين في Word وترقيم القوائم إلى نمط. انظر نمط الترقيم. |
| ترقيم العناصر الفرعية تحت أصلها (1 → 1.1) (Word، النص) | مفعّل افتراضيًا | تصبح أرقام الأبناء المولَّدة “3.1” و“3.2” بدلًا من “1” و“2”. |
التسلسل الهرمي. تعيد أرقام المخطط التفصيلي بناء التسلسل الهرمي: يصبح “1.2.3” ابنًا لـ “1.2”. ويضبط عمود رقم الأصل، أو زوج معرّف الصف ومعرّف صف الأصل، الأصل صراحة. وتصبح العناصر التي بلا أصل عناصر المستوى الأعلى في المستند.
جداول Word. لملف Word، يسرد قسم جداول Word كل جدول. وتشترك الجداول التي تتكرر بالرأس نفسه عبر الأقسام في ربط واحد. ويشرح القسم: “استورد جدول متطلبات ككيانات، كيان لكل صف، واربط أعمدته. تبقى الجداول الأخرى جداولَ في وصف العنصر الذي تليه.”
- اضبط كل جدول على كيانات (كيان لكل صف) أو جدول في الوصف.
- اربط أعمدته بـ Number أو Name أو Description أو Class أو Labels أو Attribute أو New attribute أو Skip.
- تُربط رؤوس مثل ID وReq ID وRequirement ID وRef وParagraph بـ Number.
- تُربط Shall وShall Statement وRequirement Statement وRequirement Text وStatement وText بـ Description.
الجدول الذي فيه عمود رقم أو وصف وصفوف “shall” يبدأ ككيانات.
تظهر التحذيرات التي عُثر عليها حتى الآن تحت الأعمدة، أو “لا تحذيرات.”
الخطوة 3: المراجعة
تحقق من النتيجة قبل أن يتغير أي شيء. وتُظهر المراجعة التغييرات بالطريقة التي تقارن بها خطوط الأساس والإصدارات الإصدارات (انظر خطوط الأساس ومقارنة الإصدارات):
- يسمّي السطر الأول الملف والصيغة وعدد العناصر لكل فئة.
- يظهر إنشاء مستند متطلبات من هذه المتطلبات البالغ عددها N حين يكون كل عنصر Statement أو Requirement (أو فئة فرعية)، محددًا. ولملفات أخرى يقرأ إنشاء مستند من هذه العناصر البالغ عددها N، غير محدد. ومع التحديد، اختر نوع المستند (الافتراضي مستند المتطلبات)، والاسم (الافتراضي: اسم الملف) وما إذا كنت تريد إعادة ترقيم المستند كله بعد الاستيراد.
- تتبعها التحذيرات.
- تعدّ المربعات عناصر جديدة والعناصر المحدَّثة والعناصر مطابَق، دون تغيير والعلاقات من الملف.
- يسرد جدول التغييرات كل عنصر جديد مع وصفه، وكل حقل متغير في عنصر محدَّث مع فرق على مستوى الكلمات بين القيمة القديمة والجديدة (أول 500 تغيير).
انقر استيراد N عناصر. ويقرأ الإشعار “تم استيراد N جديدة، وM محدَّثة”.
- من دون تحذيرات، يفتح Holarch مستند المتطلبات الجديد (أو قاعدة البيانات).
- وإلا تسرد بطاقة اكتمل الاستيراد التحذيرات (“لم يُبلغ الاستيراد عن أي تحذيرات.” حين يكون نظيفًا). وأزرارها فتح المستند وفتح قاعدة البيانات ومخطط Spider والمخطط الشجري وفحص الجودة وبدء استيراد آخر.
يسرد وصف المستند الجديد تحذيرات الاستيراد.
كيف تُقرأ كل صيغة
Word (.docx):
- تصبح العناوين وترقيم قوائم Word المخطط التفصيلي وتحتفظ بأرقامها.
- يصبح العنوان Statement. ويصبح نص المتن تحته وصفه.
- تصبح الفقرة التي فيها shall أو must أو will أو should Requirement فرعيًا، مسمّى من الكلمات التي بعد الفعل المساعد. وكذلك عنصر القائمة المرقمة؛ ومن دون فعل مساعد يصبح Statement.
- تنضم عناصر التعداد النقطي والصور والجداول إلى وصف العنصر الذي تليه، مع الإبقاء على الغامق والمائل والقوائم والجداول.
- يُرفق ملف .docx الأصلي بالمستند الجديد حين يكون ضمن حد المرفقات لكل ملف.
- تُحفظ صور PNG وJPEG وGIF وWebP وSVG. وتُتخطى صيغ الصور الأخرى مع تحذير.
Excel (.xlsx, .xlsm) وCSV:
- صف لكل كيان، وأي أعمدة. والصف الأول هو الرأس.
- تحتفظ الخلايا متعددة الأسطر بفواصل أسطرها.
- لا تُقرأ ملفات Excel 97-2003 (.xls). احفظها بصيغة .xlsx أو .csv أولًا.
ReqIF (.reqif, .reqifz):
- يصبح كل SPEC-OBJECT صفًا فيه ReqIF ID، وParent ID (من التسلسل الهرمي للمواصفة)، وType (نوع الكائن الخاص به، مربوطًا بـ Class)، وLong Name وعمود لكل تعريف سمة.
- الأعمدة التي بلا مطابقة تكون افتراضيًا سمة جديدة. وتصبح سمات XHTML سمات نص منسَّق، وتصبح سمات التعداد قوائم خيارات.
- تصبح SPEC-RELATIONs علاقات بالاسم. وحين لا يطابق الاسم علاقة يسمح بها المخطط الهيكلي، تصبح traced to.
- يُفك أرشيف .reqifz تلقائيًا.
النص العادي (.txt) أو النص الملصق:
- يصبح السطر المرقم (“3.1 Battery”)، أو السطر القصير دون نقطة، عنوانًا (Statement).
- تصبح كل جملة فيها shall أو must أو will أو should Requirement تحت العنوان الحالي.
- ينضم النص الآخر إلى وصف العنصر السابق.
- مع نمط ترقيم (مكتشف من النص، أو مكتوب)، يقرر النمط المستويات.
تحديث المتطلبات من جدول بيانات
استخدم هذا لتغيير متطلبات كثيرة دفعة واحدة في جدول بيانات.
- في قاعدة البيانات (أو صفحة المتطلبات)، انقر تصدير… واختر جدول (CSV).
- حدّد السمات المراد تحريرها. وتحت تضمين، حدّد المعرّف، ثم انقر تصدير.
- حرّر القيم في جدول البيانات. ولا تغيّر عمود المعرّف.
- استورد الملف. وفي الربط، تحقق من أن عمود المعرّف مربوط بـ المعرّف العام واضبط مطابقة الكيانات الموجودة بواسطة على المعرّف العام.
- في المراجعة، ألغِ تحديد إنشاء مستند….
تُعدّ الصفوف المطابَقة العناصر المحدَّثة، مع سرد كل حقل متغير.
- انقر استيراد N عناصر.
لا تتطابق قيمة I_… من ملف صُدِّر قبل هذا الإصدار؛ استخدم عمود المعرّف. ولكل خطوة وخيار، انظر الاستيراد والتصدير.
ما يكتبه التحديث:
- الأعمدة المربوطة فقط. ويحتفظ غياب عمود Description بكل وصف موجود.
- تُضاف التسميات من الملف إلى التسميات الموجودة.
- من دون عمود Class، يحتفظ الصف المطابَق بالمعرّف العام بفئة كيانه.
رسائل الاستيراد
| الرسالة | المعنى والحل |
|---|---|
| لا يرتبط أي عمود بالاسم أو الرقم. اربط أحدهما. | اربط عمودًا واحدًا على الأقل بالاسم أو الرقم. |
| الصف N: فئة غير معروفة “X”، تُستخدم <class>. | لا تطابق قيمة Class أي فئة. أصلح القيمة أو اربط العمود بـ تخطٍّ. |
| الصف N: تم تجاهل التسمية غير المعروفة “X”. | أنشئ التسمية في المخطط الهيكلي أولًا، أو أصلح القيمة. |
| الصف N: لا تنطبق “<attribute>” على الفئة <class>. | ليست لفئة الصف تلك السمة. |
| الصف N: “<value>” ليست <type> صالحة لـ “<attribute>”. | لا يمكن قراءة القيمة رقمًا أو تاريخًا أو خيارًا وهكذا. تحقق من خيار تنسيق التاريخ. |
| الصف N: الاسم أطول من 255 حرفًا وتم تقصيره. / الصف N: الرقم أطول من 255 حرفًا وتم تقصيره. | الأسماء والأرقام محدودة بـ 255 حرفًا. |
| رقم مكرر X (الصفان A وB). | يشترك صفان في رقم؛ وقد يُرفق التسلسل الهرمي الأبناء بالأول. |
| الصف N: رقم الأصل P مفقود لـ X؛ أُرفق بـ Q. / …؛ استُورد في المستوى الأعلى. | رقم الأصل المباشر ليس في الملف. |
| الصف N: لم يُعثر على رقم الأصل P. / الصف N: لم يُعثر على الأصل P. | يشير Parent Number أو Parent Row ID إلى صف ليس في الملف. |
| الصف N: لم يُعثر على هدف “<relationship>” “X”. | يسمّي عمود العلاقة كيانًا غير موجود. تحقق من مطابقة الكيانات المرتبطة بواسطة. |
| الصف N: لا يسمح المخطط الهيكلي بـ “<relationship>” من A إلى B (أُنشئ على أي حال). | أُنشئ الرابط مع أن المخطط الهيكلي لا يدرجه. |
| لا يسمح المخطط الهيكلي بالعلاقة “X” بين A وB؛ تم تخطيها. | تعذّر إنشاء علاقة ReqIF أو XMI، حتى بوصفها traced to. |
| الصورة X: صور .ext غير مدعومة وتم تخطيها. احفظ الصورة بتنسيق PNG أو JPEG في Word للإبقاء عليها. | صورة Word بصيغة غير مدعومة. |
| الصورة X (الحجم) تتجاوز حد المرفقات <limit> وتم تخطيها. | الصورة أكبر من الحد لكل ملف. |
| لم يُعثر على صفوف بيانات. | ليس في الملف أو الورقة إلا رأس، أو هو فارغ. |
| تعذّرت قراءة الملف: ملفات Excel 97-2003 (.xls) غير مدعومة. في Excel، احفظ الملف بصيغة .xlsx أو .csv، ثم استورده مجددًا | حوّل الملف. |
| تعذّرت قراءة الملف: لا يُقبل XML فيه تصريح DOCTYPE أو ENTITY. احفظ الملف دونه واستورده مجددًا | أزل التصريح من ملف ReqIF أو XML. |
| تعذّرت قراءة الملف: XML غير صالح | ملف ReqIF ليس XML سليم البنية. |
| فشل الاستيراد: <reason> | توقف الاستيراد؛ ولم يتغير شيء. |
اختصارات المتطلبات
| المفاتيح | الموضع | الفعل |
|---|---|---|
| Enter | الإدخال السريع في المستند | إضافة المتطلب المكتوب. |
| ⌘ / Ctrl+Enter / ⌥ / Alt+⌘ / Ctrl+Enter | المستند، مع عنصر محدد | إضافة شقيق / ابن. |
| Enter أو Space | صفوف الجودة وTBD/TBR وروابط للمراجعة | إظهار متطلب الصف أو العنصر المراد مراجعته في لوحة الخصائص. |
| ↑ / ↓ | الصفوف نفسها، مع التركيز على صف | الانتقال إلى الصف السابق أو التالي. |
| ⌘ / Ctrl-النقر، ⇧ / Shift-النقر، ⌘ / Ctrl+⇧ / Shift-النقر | صفوف الجودة وTBD/TBR وروابط للمراجعة؛ وصفوف قاعدة البيانات؛ وعناصر المستندات | تبديل صف، وتحديد النطاق من آخر صف نُقر، وإضافة ذلك النطاق. |
| ⌘A / Ctrl+A, ⇧ / Shift+↑ / ⇧ / Shift+↓ | الصفوف نفسها، مع التركيز على صف | تحديد كل صف معروض؛ وتوسيع التحديد من الصف المركَّز عليه. |
| النقر بالزر الأيمن، أو Shift+F10 أو مفتاح القائمة | صفوف المتطلبات والجودة وTBD/TBR وروابط للمراجعة؛ وعناصر المستندات ومدخلات المخطط التفصيلي | فتح قائمة الصف: الإجراءات المقترحة مع أسبابها و✦ المزيد من الذكاء الاصطناعي ▸ أولًا، ثم أوامر العنصر. |
| Esc | الجودة، TBD/TBR، روابط للمراجعة، RVTM | إلغاء تحديد الصف. |
| Enter | حقل الاسم في خطوط الأساس والإصدارات | إنشاء خط أساس المشروع. |
| ⌘Z / Ctrl+Z | في أي مكان | التراجع عن آخر تغيير، بما في ذلك استيراد كامل، أو تعليم روابط كمُراجَعة، أو تغيير حالة. |
لكل اختصار في التطبيق، انظر اختصارات لوحة المفاتيح.
الإعدادات
| الإعداد | الموضع | الافتراضي | النطاق |
|---|---|---|---|
| إعادة الفحص تلقائيًا عند تغيّر النص | شريط النطاق في صفحة الجودة | إيقاف | هذا المتصفح |
| مجموعات لوحة الخصائص مطوية أو مفتوحة (الجودة والأخرى) | انقر عنوان مجموعة في لوحة الخصائص، أو طيّ الكل / توسيع الكل في نهاية روابطها | الجودة مطوية، والباقي مفتوح | هذا المتصفح، لكل فئة |
| اسمك على الموافقات والقرارات والتعليقات | اسم حسابك | — | الحساب |
| حالة التتبع (نقاط على المتطلبات) | عرض ▾ في المستند | على | المستند |
الرسائل
| الرسالة | الموضع | المعنى |
|---|---|---|
| فُحص N متطلب | الجودة | جرى الفحص على النطاق. |
| لا متطلبات في هذا النطاق. | الجودة | ليس في النطاق متطلبات. |
| لا يحتوي هذا المستند على Requirements لفحصها. لا تُقيَّم Statements. | فحص الجودة في المستند | غيّر العناصر إلى Requirement أو افحص مستندًا آخر. |
| قديم — أعد التشغيل / قديم / الجودة: قديمة — أعد التشغيل | الجودة، المستندات، لوحة الخصائص | تغيّر النص بعد آخر فحص. |
| يحتاج إلى حكم مراجع | الجودة (Correct، Feasible) | يجب أن يقرر شخص؛ انقر ✘ للتعليم بنعم. |
| عُلِّم بلا يدويًا. | الجودة | ضبط مراجع المعيار على لا. |
| نُقل N متطلب معتمد إلى In Review؛ وعُلِّم N رابط للمراجعة. | بعد تحرير | أعاد التحرير فتح الموافقات وعلّم روابط للمراجعة. |
| تم الاعتماد / تم الرفض / نُقل إلى In Review | مربع الموافقة | سُجِّل القرار. |
| عُلّمت N روابط كمُراجَعة. | روابط للمراجعة | سُجِّلت المراجعات. |
| حدد الروابط المراد تعليمها كمُراجَعة أولًا. | روابط للمراجعة | حدّد صفوفًا قبل تعليم المحدد كمُراجَع…. |
| أُغلق / أُغلقت السمة؛ لا يزال النص يحتوي على TBD. | TBD/TBR | ضُبطت السمة على None. |
| لا يزال النص يحتوي على TBD. حرّر النص لإغلاقه. | TBD/TBR | يظهر عند إغلاق بند نصي فقط. |
| تم حفظ خط الأساس | المستندات، خطوط الأساس والإصدارات | حُفظت اللقطة. |
| لا يحتوي هذا المستند على خط أساس. احفظ خط أساس أولًا. | المقارنة بالحالي، تقارير التغييرات | ليس للمستند خط أساس. |
| تم الإرجاع إلى “<name>” / تمت استعادة “<name>” | خطوط الأساس | أُرجع المستند أو المشروع؛ والتراجع متاح. |
| لا متطلبات للمراجعة. حدد متطلبات أو افتحها أولًا. | فحص المتطلبات بالذكاء الاصطناعي | لا متطلبات في النطاق. |
الحدود
- فحص الجودة: يُقارن كل متطلب في النطاق بالمتطلبات الأخرى بحثًا عن التكرارات (عتبة تشابه 75%).
- فحص المتطلبات بالذكاء الاصطناعي: 20 متطلبًا لكل طلب ذكاء اصطناعي، مع ما يصل إلى 300 متطلب آخر سياقًا.
- يحتفظ فرق مراجعة الروابط بأول 500 حرف من الاسم القديم و4,000 من الوصف القديم.
- مخطط الإنجاز المتبقي لـ TBD/TBR: حتى 60 نقطة.
- الاستيراد:
- أسماء وأرقام حتى 255 حرفًا.
- تُظهر المعاينة أول 500 صف. وتُسرد أول 50 تحذيرًا (“…و N أخرى”).
- لنمط الترقيم 6 مستويات على الأكثر (“لنمط الترقيم أكثر من 6 مستويات. استخدم 6 علامات على الأكثر.”).
- ملفات ReqIF/XML حتى 100 مليون حرف و3,000,000 عنصر.
- أرشيفات .reqifz و.docx حتى 10,000 مدخل، و300 MB لكل مدخل و600 MB إجمالًا.
- لا تُحفظ الصور وملف Word الأصلي إلا ضمن حد المرفقات لكل ملف (10 MB على خطة Free، و25 MB على Individual، و100 MB على Team).
ذات صلة
- المستندات: كتابة المواصفات والتقارير ومخرجات DOCX وهيكلتها.
- التتبع: العلاقات، ومصفوفة التتبع، والتغطية، والأثر.
- النموذج وقاعدة البيانات: الاستعلامات والأعمدة والتحرير المجمّع.
- امتدادات المخطط الهيكلي: إضافة سمات المتطلبات وخياراتها وتسمياتها.
- الاستيراد والتصدير: كل صيغة ملف.
- التعليمات: المتطلبات والحالة والموافقة، جودة المتطلبات، سجل TBD/TBR، روابط للمراجعة، الموافقات، الاستيراد، خطوط الأساس والإصدارات، RVTM.