Holarch

गाइड · आवश्यकताएं

अच्छी सिस्टम आवश्यकताएं कैसे लिखें: उदाहरण और चेकलिस्ट

यह गाइड सुनें 26 मिनट

एक अच्छी आवश्यकता एक ऐसी बात कहती है जो सिस्टम को करनी या होनी है, ऐसे शब्दों में जिन्हें दो इंजीनियर एक ही तरह पढ़ें, एक ऐसे मान के साथ जिसे टेस्ट या विश्लेषण जांच सके। यह गाइड ज़रूरतें बनाम आवश्यकताएं, आवश्यकता कथन के भाग, ISO/IEC/IEEE 29148 और INCOSE Guide to Writing Requirements की गुणवत्ता विशेषताएं, पहले-और-बाद के उदाहरणों वाली चेकलिस्ट, सत्यापन और स्वीकृति मानदंड, TBD और TBR मान, और आवश्यकता प्रकार कवर करती है, सब एक CubeSat विनिर्देश पर लागू करके।

इस पृष्ठ पर
  1. आवश्यकता की शब्दावली क्यों मायने रखती है
  2. हितधारक ज़रूरतें बनाम आवश्यकताएं
  3. आवश्यकता की संरचना
    1. कथन
    2. एट्रिब्यूट
  4. अच्छी आवश्यकता की गुणवत्ता विशेषताएं
  5. चेकलिस्ट: पहले और बाद के उदाहरणों के साथ नियम
  6. आवश्यकता के साथ सत्यापन विधि और स्वीकृति मानदंड लिखें
  7. TBD और TBR मानों को संभालना
  8. आवश्यकता प्रकार
  9. हल किया हुआ उदाहरण: EO-1 विनिर्देश की समीक्षा
    1. छोटे निष्कर्ष
    2. तीन पुनर्लेखन
  10. सामान्य ग़लतियां
  11. Holarch में आज़माएं
  12. चेकलिस्ट डाउनलोड करें
  13. आवश्यकताएं लिखने के बारे में प्रश्न
    1. Shall, must या will?
    2. किसी सिस्टम में कितनी आवश्यकताएं होनी चाहिए?
    3. क्या यूज़र स्टोरी आवश्यकताएं हैं?
    4. क्या कोई टूल आवश्यकता गुणवत्ता जांच सकता है?
  14. आगे कहाँ जाएं

आवश्यकता की शब्दावली क्यों मायने रखती है

आवश्यकता सिस्टम मांगने वाले लोगों और उसे बनाने वाले लोगों के बीच एक अनुबंध है। आगे का हर व्यक्ति इसे पढ़ता है: डिज़ाइनर इसके विरुद्ध कंपोनेंट का आकार तय करता है, टेस्ट इंजीनियर इससे पास मानदंड लिखता है, परिवर्तन बोर्ड इसके विरुद्ध परिवर्तन को तौलता है, और ग्राहक इसी से सिस्टम स्वीकार करता है। हर कोई वही वाक्य पढ़ता है, आमतौर पर लेखक की मौजूदगी के बिना। अगर वाक्य दो तरह से पढ़ा जा सकता है, तो पढ़ा जाएगा, और अंतर देर से सामने आता है: किसी ऐसे टेस्ट पर जो उस मानदंड के विरुद्ध "पास" होता है जिस पर कोई सहमत नहीं हुआ, या स्वीकृति पर, जब ग्राहक का मतलब कुछ और था।

ख़राब शब्दावली बाक़ी मॉडल को भी तोड़ती है। बिना मान वाली आवश्यकता किसी कंपोनेंट को आवंटित नहीं की जा सकती, क्योंकि कोई नहीं बता सकता कि कंपोनेंट उसे पूरा करता है या नहीं। उसे सत्यापित नहीं किया जा सकता, इसलिए वह ट्रेसेबिलिटी और सत्यापन मैट्रिक्स में कवरेज कमी के रूप में दिखती है। और जब वह बदलती है, तो कोई नहीं बता सकता कि लिंक किया गया डिज़ाइन अब भी सही है या नहीं। आवश्यकताएं अच्छी तरह लिखना किसी प्रोजेक्ट का सबसे सस्ता गुणवत्ता काम है: शुरुआत में एक वाक्य पर लगाया गया एक घंटा अंत में पूरा टेस्ट अभियान बचाता है।

गाइड एक चलते उदाहरण का उपयोग करती है, EO-1, एक काल्पनिक 6U CubeSat जो चार स्पेक्ट्रल बैंड में खेतों की तस्वीरें लेता है। इसके विनिर्देश SRS-001 EO-1 System Requirements Specification में 32 आवश्यकताएं हैं, जिनमें से अधिकांश ठीक हैं और तीन जानबूझकर कमज़ोर। यह वही मॉडल है जो शुरू से अंत तक MBSE उदाहरण प्रोजेक्ट में है। यहाँ उद्धृत हितधारक ज़रूरतें N1 से N3 वही हैं जिन्हें ट्रेसेबिलिटी गाइड मॉडल में जोड़ती है।

हितधारक ज़रूरतें बनाम आवश्यकताएं

आवश्यकता लेखन एक कदम पहले, ज़रूरतों से शुरू होता है। हितधारक ज़रूरत वह है जिसकी कोई उपयोगकर्ता, ऑपरेटर, ग्राहक या नियामक अपने शब्दों में अपेक्षा करता है। आवश्यकता वह इंजीनियरिंग कथन है जिसके विरुद्ध सिस्टम डिज़ाइन और सत्यापित होता है। ISO/IEC/IEEE 15288 दोनों को अलग तकनीकी प्रक्रियाओं में रखता है: हितधारक ज़रूरतें और आवश्यकता परिभाषा (6.4.2) और सिस्टम आवश्यकता परिभाषा (6.4.3)। INCOSE Needs and Requirements Manual भी यही विभाजन करता है और ज़रूरतों को अपने-आप में आइटम मानता है, आवश्यकताओं के कच्चे ड्राफ़्ट नहीं।

EO-1 उदाहरणकिससे जांचा जाता है
ज़रूरत (N2 Twice-Weekly Revisit)Farm customers need fresh imagery of their fields at least twice a week in the growing season.वैधीकरण: क्या ग्राहकों को डिलीवर किए गए सिस्टम से वह मिलता है जिसकी उन्हें ज़रूरत है?
आवश्यकता (1.6 Revisit Time)The mission shall revisit each target region within 72 hours.सत्यापन: क्या सिस्टम टेस्ट, विश्लेषण, निरीक्षण या प्रदर्शन से कथन को पूरा करता है?

अंतर इस बात में दिखता है कि हर एक को कैसे जांचा जाता है। आवश्यकता सत्यापित होती है: सिस्टम को कथन के विरुद्ध मापा जाता है। ज़रूरत वैधीकृत होती है: कोई पुष्टि करता है कि सिस्टम अपने इच्छित उपयोग में वह करता है जो हितधारक चाहता था। अगर आवश्यकताओं से मूल बात छूट गई, तो सिस्टम हर सत्यापन पास करके भी वैधीकरण में विफल हो सकता है; सत्यापन बनाम वैधीकरण गाइड उस अंतर को कवर करती है। लेखन के लिए व्यावहारिक परिणाम सरल है: पहले ज़रूरत लिखें, फिर ऐसी आवश्यकताएं लिखें जो पूरी होने पर उसे संतुष्ट करें, और हर आवश्यकता को उस ज़रूरत से वापस लिंक करें जिसका वह उत्तर देती है।

अनुवाद शायद ही कभी एक-से-एक होता है। N2, 1.6 Revisit Time बनती है, जिसे फिर 1.6.1 Ground Track Repeat (3 दिन) और 1.6.2 Off-Nadir Imaging (25 डिग्री) में विभाजित किया जाता है। कुछ आवश्यकताएं सीधे किसी ज़रूरत का उत्तर नहीं देतीं: 3.1 Orbit Average Power, 1.5 Daily Collection Volume से व्युत्पन्न है, क्योंकि इमेजिंग लोड तय करता है कि ऐरे को कितनी पावर देनी है। किसी ग्राहक ने 30 W नहीं मांगा, लेकिन जिस इमेजिंग को उन्होंने मांगा वह इसके बिना नहीं हो सकती।

आवश्यकता की संरचना

आवश्यकता उसके वाक्य से अधिक है। वाक्य दायित्व रखता है; उसके आसपास एट्रिब्यूट का एक सेट कारण, उसे सिद्ध करने की योजना और हिसाब-किताब रखता है। दोनों हिस्से उसे लिखने का हिस्सा हैं।

कथन

अधिकांश अच्छे आवश्यकता कथन एक पैटर्न में आते हैं। ISO/IEC/IEEE 29148 (5.2.4) इसे एक कर्ता, एक क्रिया, एक कर्म और क्रिया पर बाधाओं के रूप में वर्णित करता है, आगे एक वैकल्पिक शर्त के साथ; INCOSE Guide to Writing Requirements यही क्रम और हर प्रकार की आवश्यकता के लिए तय टेम्पलेट सुझाती है।

भागयह क्या कहता हैEO-1 4.3 Fault Detection
शर्त (वैकल्पिक)आवश्यकता कब, किस मोड या अवस्था में लागू होती है"…of undervoltage detection" (ट्रिगर करने वाली घटना)
कर्तावह सिस्टम या एलिमेंट जिसे पालन करना है, ठीक-ठीक नाम के साथ"The C&DH"
मोडल क्रियादायित्व की मज़बूती"shall"
क्रियाकर्ता क्या करता है या क्या है, सक्रिय क्रिया के रूप में"enter"
कर्मक्रिया किस पर लागू होती है"safe mode"
प्रदर्शन या बाधामापने योग्य मान, इकाई और सीमा की दिशा के साथ"within 10 seconds"

एक साथ: "The C&DH shall enter safe mode within 10 seconds of undervoltage detection." क्रम बदल सकता है ("When undervoltage is detected, the C&DH shall…" शर्त को पहले रखता है, जैसा कई टीमों द्वारा उपयोग किए जाने वाले EARS टेम्पलेट में होता है), लेकिन हर भाग मौजूद होना चाहिए या जानबूझकर अनुपस्थित।

तीन शब्द सबसे अधिक भार उठाते हैं। Shall बाध्यकारी आवश्यकता चिह्नित करता है; will सिस्टम के बाहर की किसी चीज़ के बारे में तथ्य या इरादा बताता है; should एक ऐसा लक्ष्य बताता है जिसका सत्यापन नहीं होता। प्रोजेक्ट जो भी परिपाटी अपनाए, उसे विनिर्देश में एक बार परिभाषित करें और उस पर टिके रहें। EO-1 1.1 Reference Orbit ("The mission assumes a 500 km sun-synchronous orbit…") सही ढंग से एक मान्यता के रूप में लिखी गई है, आवश्यकता के रूप में नहीं: यह उस पर निर्भर आवश्यकताओं का संदर्भ है, और मॉडल इसे ऐसे कथन के रूप में संग्रहीत करता है जिसे न स्कोर किया जाता है और न सत्यापित।

एट्रिब्यूट

यहाँ 3.1 Orbit Average Power है, जैसा EO-1 मॉडल इसे PDR के बाद 28 W से 30 W के परिवर्तन के बाद दर्ज करता है:

एट्रिब्यूट3.1 Orbit Average Powerयह क्यों है
पहचानकर्ता और नाम3.1 Orbit Average Powerलिंक, समीक्षाओं और परिवर्तन अनुरोधों के लिए एक स्थिर पहचान
कथनThe solar arrays shall generate at least 30 W orbit-average power at end of life.स्वयं दायित्व
औचित्यOrbit-average load grew to 26 W after PDR; 30 W keeps 15% margin.बाद के पाठक को लेखक के बिना परिवर्तन आंकने देता है
स्रोत और पैरेंटDerived (systems analysis); 1.5 Daily Collection Volume से derived fromपीछे की ट्रेसेबिलिटी: आवश्यकता क्यों मौजूद है
सत्यापन विधि और स्तरTest, Subsystem स्तर परइसे सिद्ध करने की योजना, लिखते समय तय की गई
सफलता मानदंडEnd-of-life orbit-average power predicted from measured peak power.कौन सा परिणाम पूरा माना जाता है
स्वामी, प्राथमिकता, गंभीरताPower Engineer; High; Highइसके लिए कौन उत्तरदायी है और यह कितना मायने रखती है
स्थितिIn Review (यह Approved थी; अनुमोदन के बाद इसका टेक्स्ट बदला)सहमति प्रक्रिया में यह कहाँ है
TBD/TBRकोई नहींक्या कोई मान अभी खुला है

ISO/IEC/IEEE 29148 (5.2.8) इस तरह के एट्रिब्यूट सूचीबद्ध करता है, और INCOSE गाइड और जोड़ती है; प्रोजेक्ट वे चुनता है जिन्हें वह वास्तव में बनाए रखेगा। औचित्य वह है जो सबसे अधिक छोड़ा जाता है और बाद में सबसे अधिक खलता है। "26 W लोड, 15% मार्जिन" के बिना 3.1 देखने वाला अगला व्यक्ति नहीं बता सकता कि 30 W एक कठोर भौतिक सीमा है, ग्राहक की संख्या है या मार्जिन का चुनाव, और इसलिए यह भी नहीं बता सकता कि लोड में परिवर्तन का इस पर क्या अर्थ है।

अच्छी आवश्यकता की गुणवत्ता विशेषताएं

शैली के नियम तब लागू करना आसान होता है जब आप जानते हैं कि वे किसकी रक्षा करते हैं। ISO/IEC/IEEE 29148 (5.2.5) किसी एक आवश्यकता की नौ विशेषताएं बताता है, और INCOSE Guide to Writing Requirements उन्हीं नौ को अपने C1 से C9 के रूप में उपयोग करती है, हर एक की संक्षिप्त परिभाषा और उसका समर्थन करने वाले नियमों के साथ। तालिका हर एक को ऐसे प्रश्न के रूप में रखती है जो समीक्षक पूछ सकता है।

विशेषतापूछने का प्रश्नEO-1 उदाहरण
आवश्यकअगर इसे हटा दिया जाए, तो क्या हितधारकों की ज़रूरत की कोई चीज़ खो जाएगी? क्या यह डुप्लिकेट नहीं है?3.1 आवश्यक है: इसके बिना कुछ भी इमेजिंग लोड के लिए ऐरे का आकार तय नहीं करता।
उपयुक्तक्या यह सही स्तर पर लिखी गई है, ऐसा डिज़ाइन चुनाव तय किए बिना जो नीचे के स्तर को करना चाहिए?3.1 ऐरे के लिए पावर स्तर तय करती है, सेल का प्रकार या पैनलों की संख्या नहीं।
स्पष्टक्या इसे केवल एक तरह से पढ़ा जा सकता है?6.4 "user friendly" विफल है: दो समीक्षक इस पर असहमत होंगे कि यह पूरी होती है या नहीं।
पूर्णक्या यह बिना किसी छूटी शर्त या मान के ज़रूरी सब कुछ कहती है?3.5 "warm enough (TBD)" विफल है: मान गायब है।
एकलक्या यह एक दायित्व बताती है?2.5 विफल है: यह "and" से जोड़कर रिकवर करने और इमेजिंग फिर से शुरू करने, दोनों को कहती है।
साध्यक्या इसे तकनीक, लागत और शेड्यूल की ज्ञात बाधाओं के भीतर पूरा किया जा सकता है?30 W पर 3.1 संदिग्ध है: डिज़ाइन किए गए ऐरे लगभग 28 W ऑर्बिट औसत देते हैं।
सत्यापन-योग्यक्या कोई टेस्ट, विश्लेषण, निरीक्षण या प्रदर्शन दिखा सकता है कि यह पूरी होती है?2.5 "quickly" विफल है; "within 6 hours" पास है।
सहीक्या यह अपने स्रोत की वास्तविक ज़रूरत को सही मान के साथ बताती है?1.2 का 4.5 m ग्राउंड सैंपल डिस्टेंस, मार्जिन के साथ, N3 फ़ील्ड-स्तरीय मानचित्रों को सही ढंग से व्यक्त करता है।
अनुरूपक्या यह प्रोजेक्ट के तय टेम्पलेट और शब्दावली का पालन करती है?हर EO-1 आवश्यकता "shall", एक नामित कर्ता और SI इकाइयों का उपयोग करती है।

आवश्यकता सेट की अपनी विशेषताएं होती हैं जिन्हें कोई एक कथन नहीं दिखा सकता। ISO/IEC/IEEE 29148 (5.2.6) सेट को पूर्ण, संगत, समग्र रूप से साध्य, बोधगम्य और वैधीकरण-योग्य के रूप में सूचीबद्ध करता है; INCOSE गाइड C15 के रूप में सही जोड़ती है और सेट विशेषताओं को C10 से C15 तक क्रमांकित करती है।

  • पूर्ण: सेट ज़रूरतों को कवर करता है। EO-1 बताता है कि अंडरवोल्टेज पर क्या होता है (4.3), लेकिन इसकी एकमात्र सेफ़ मोड रिकवरी आवश्यकता 2.5 है, जो लिखे रूप में असत्यापन-योग्य है, इसलिए रिकवरी वास्तव में अनिर्दिष्ट है।
  • संगत: कोई दो आवश्यकताएं टकराती नहीं, और शब्दों और इकाइयों का उपयोग एक ही तरह होता है। 1.5 प्रति दिन 3.2 GB इमेज डेटा मांगती है और 5.4 ज़मीन पर 3 GB प्राप्त होना; वे केवल इसलिए मेल खाती हैं क्योंकि 5.4 का औचित्य "after compression" कहता है। औचित्य के बिना वे टकराव जैसी दिखती हैं।
  • साध्य: आवश्यकताएं एक साथ पूरी की जा सकती हैं। हर पावर आवश्यकता अकेले साध्य हो सकती है, जबकि 30 W ऑर्बिट औसत, ऐरे क्षेत्रफल और द्रव्यमान बजट एक साथ शायद न हों।
  • बोधगम्य: पाठक बता सकता है कि सिस्टम से क्या अपेक्षित है और आवश्यकताएं कैसे संबंधित हैं, जो शब्दावली जितना ही संरचना, क्रमांकन और ट्रेसेबिलिटी पर निर्भर है।
  • वैधीकरण-योग्य: यह दिखाया जा सकता है कि सेट ऐसे सिस्टम तक ले जाता है जो ज़रूरतें पूरी करता है, इसीलिए हर शीर्ष-स्तरीय आवश्यकता किसी ज़रूरत से वापस लिंक होती है।

चेकलिस्ट: पहले और बाद के उदाहरणों के साथ नियम

विशेषताएं ठोस लेखन नियमों के ज़रिए उपयोगी बनती हैं। INCOSE Guide to Writing Requirements उन्हें क्रमांकित करती है (R1, R2 आदि); NASA Systems Engineering Handbook (Appendix C) में इसी तर्ज़ पर एक छोटी चेकलिस्ट है। तालिका उन नियमों को एकत्र करती है जो व्यवहार में अधिकांश समस्याएं पकड़ते हैं, हर एक के लिए EO-1 विनिर्देश से एक उदाहरण के साथ। “पहले” डेमो में मौजूद टेक्स्ट है; “बाद में” एक पुनर्लेखन है। उदाहरणात्मक चिह्नित मान रूप दिखाते हैं, EO-1 विश्लेषणों के परिणाम नहीं।

नियमपूछने का प्रश्नपहले (EO-1)बाद में
हर कथन में एक दायित्वठीक एक "shall", दो मांगों को जोड़ने वाला कोई "and", "or", "and/or" नहीं?2.5: "The spacecraft should recover from safe mode quickly and resume imaging as appropriate""The spacecraft shall resume imaging within 6 hours of a safe mode entry." रिकवरी के अन्य महत्वपूर्ण चरणों की अपनी अलग आवश्यकताएं होती हैं।
अनिवार्य शब्दावलीबाध्यकारी आवश्यकता के लिए "shall", न कि "should", "will" या "may"?2.5: "should recover""shall resume"
इकाई के साथ मापने योग्य मानक्या हर प्रदर्शन-सूचक शब्द के साथ एक संख्या और एक इकाई है?2.5: "quickly""within 6 hours of a safe mode entry"
सीमा की दिशा बताई गईक्या स्पष्ट है कि मान न्यूनतम है या अधिकतम?1.6.2: "image targets up to 25 degrees off nadir""image targets at off-nadir angles from 0 to 25 degrees" (एक क्षमता सीमा, पॉइंटिंग पर ऊपरी सीमा नहीं)
कोई बचाव-खंड नहींक्या कुछ आपूर्तिकर्ता के विवेक पर छोड़ा गया है ("as appropriate", "if possible", "where practical")?2.5: "as appropriate"हटाया गया; जो शर्त मायने रखती है वह बताई गई है
कोई अस्पष्ट या व्यक्तिपरक शब्द नहींक्या दो समीक्षक इस पर असहमत हो सकते हैं कि यह पूरी हुई या नहीं ("user friendly", "easy", "adequate", "enough")?6.4: "The operator interface shall be user friendly and/or easy to use.""The operator interface shall let a trained operator book a ground station contact in no more than 5 minutes." (उदाहरण के लिए; हर महत्वपूर्ण कार्य के लिए एक आवश्यकता)
स्पष्ट संज्ञाएं, कोई सर्वनाम नहींक्या हर "it", "its" या "this" का ठीक एक संभावित संदर्भ है?1.6.1: "The reference orbit shall repeat its ground track every 3 days.""The reference orbit shall repeat the ground track every 3 days." यहाँ सर्वनाम हानिरहित है, लेकिन लंबे वाक्य में सबसे पहले यही भटकता है।
शर्तें बताई गईंक्या यह बताती है कि मान कब लागू होता है: जीवन चरण, मोड, पर्यावरण?"The solar arrays shall generate 30 W.""…at least 30 W orbit-average power at end of life."
तय मान, या ट्रैक किए गए TBDक्या हर खुला मान स्वामी और नियत तिथि के साथ ट्रैक किया जाता है, न कि केवल टेक्स्ट में लिखा गया है?3.5: "The thermal design shall keep the battery warm enough (TBD).""The thermal design shall keep the battery cell temperature at or above 0 °C while charging." (उदाहरण के लिए; जब तक थर्मल विश्लेषण इसे तय नहीं करता, TBD एट्रिब्यूट Thermal Engineer और एक नियत तिथि बताता है)
कथन में कोई कारण या नोट नहींक्या उद्देश्य वाले वाक्यांश ("so that", "in order to") और कोष्ठक वाले नोट औचित्य में ले जाए गए हैं?3.5: "(TBD)"कोष्ठक के बिना कथन; कारण Rationale में
क्या, न कि कैसेक्या यह ज़रूरत बताती है, न कि ऐसा समाधान थोपती है जिसे नीचे के स्तर को चुनना चाहिए?"The thermal design shall keep the battery warm by means of a 2 W film heater." (उदाहरण के लिए)ऊपर 3.5 का पुनर्लेखन: एक तापमान सीमा, हीटर का चुनाव थर्मल डिज़ाइन पर छोड़ा गया
सकारात्मक और प्राप्यजहाँ मापने योग्य सीमा अभिप्रेत है, क्या यह "not", "never", "always", "100%" से बचती है?"The C&DH shall never lose a stored command." (उदाहरण के लिए)"The C&DH shall execute each stored command within 1 second of the scheduled time." (4.2 जैसी लिखी है)
औचित्य दर्जक्या यह बताती है कि मान क्यों चुना गया?बिना औचित्य के 3.1Rationale: "Orbit-average load grew to 26 W after PDR; 30 W keeps 15% margin."
सत्यापन विधि और मानदंडक्या विधि चुनी गई है और पास मानदंड कथन से व्युत्पन्न है?3.1: विधि Test; TC-06 शिखर पावर ≥ 72 W की अपेक्षा करता हैपावर बजट के ज़रिए व्युत्पन्न पास मानदंड: 30 W ऑर्बिट औसत के लिए लगभग 80.6 W शिखर (अगला सेक्शन देखें)
ऊपर की ओर ट्रेस करने योग्यकिसी ज़रूरत, पैरेंट या स्रोत आवश्यकता से लिंक है?बिना अपस्ट्रीम लिंक के 3.13.1, 1.5 Daily Collection Volume से व्युत्पन्न
अद्वितीयक्या कोई दूसरी आवश्यकता यही बात दूसरे शब्दों में कहती है?थर्मल सेक्शन के अंतर्गत दूसरी "The battery shall store 77 Wh" (उदाहरण के लिए)एक आवश्यकता, 3.2 Battery Capacity, जहाँ ज़रूरत हो वहाँ संदर्भित

चेकलिस्ट समीक्षक का टूल है, लेखन टेम्पलेट नहीं। एक बार में एक नियम खोजने के बजाय हर आवश्यकता को पूरी सूची के सामने एक बार पढ़ें, और निष्कर्ष को उस नियम के साथ दर्ज करें जिसे वह तोड़ता है, ताकि लेखक जाने कि क्या बदलना है। नियमों में ग़लत चेतावनियां भी होती हैं। शब्द-सूची जांच 1.6.1 में "every" को सार्वभौमिक क्वालिफ़ायर के रूप में चिह्नित करती है, लेकिन "every 3 days" एक अवधि है, सभी मामलों के बारे में दावा नहीं; निर्णय समीक्षक करता है।

आवश्यकता के साथ सत्यापन विधि और स्वीकृति मानदंड लिखें

सत्यापन-योग्य विशेषता की जांच सबसे आसानी से उसी समय होती है जब आवश्यकता लिखी जाती है: अगर लेखक नहीं बता सकता कि उसका पूरा होना कैसे दिखाया जाएगा, तो वह पूरी नहीं हुई है। हर आवश्यकता के साथ दो चीज़ें दर्ज करें।

  • सत्यापन विधि: टेस्ट, विश्लेषण, निरीक्षण या प्रदर्शन, और असेंबली का वह स्तर जिस पर यह किया जाता है (कंपोनेंट, सबसिस्टम, सिस्टम)। EO-1 में चारों हैं: 3.1 का सत्यापन टेस्ट से, 1.5 Daily Collection Volume का विश्लेषण से, 3.4 Bus Regulation का निरीक्षण से और 6.1 Contact Scheduling का प्रदर्शन से होता है। RVTM गाइड बताती है कि इनमें से कैसे चुनें।
  • सफलता मानदंड (स्वीकृति मानदंड): वह देखा जा सकने वाला परिणाम जिसे पूरा माना जाता है, इस तरह बताया गया कि टेस्ट या विश्लेषण उसी से लिखा जा सके। 3.2 Battery Capacity के लिए: "Measured capacity of at least 77 Wh at C/2 and 20 °C." 6.2 Image Delivery के लिए: "Products on the portal within 6 h for 95% of passes in rehearsal."

कथन के साथ मानदंड लिखने से ऐसी ग़लतियां पकड़ में आती हैं जो अन्यथा केवल अंत में मिलती हैं। EO-1 की 3.1 का सत्यापन TC-06 Solar Array Power Test से होता है, जो सोलर सिम्युलेटर पर शिखर पावर मापता है और 72 W या अधिक पर पास होता है। लेकिन आवश्यकता ऑर्बिट-औसत पावर के बारे में है, और मॉडल एक को दूसरे में धूप वाले अंश (0.62) और पावर पथ दक्षता (0.6) से बदलता है। 72 W शिखर से 72 × 0.62 × 0.6 = 26.8 W ऑर्बिट औसत मिलता है, जो मूल 28 W से भी कम है, मौजूदा 30 W की तो बात ही छोड़ दें। टेस्ट की सीमा आवश्यकता से व्युत्पन्न नहीं की गई थी। TC-06 ने 75.1 W मापा और "पास" हुआ, फिर भी 75.1 W बदलकर 27.9 W होता है, जो दोनों मानों से कम है। अगर मानदंड कथन से लिखा गया होता, तो वह लगभग 30 / (0.62 × 0.6) = 80.6 W शिखर होता, और कमी पहले टेस्ट में ही दिख जाती। परिवर्तन प्रभाव विश्लेषण गाइड इसी निष्कर्ष को 28 W से 30 W के परिवर्तन के दौरान आगे ले जाती है।

सबक सामान्य है: पास मानदंड आवश्यकता के मान तक ऐसे अंकगणित से ट्रेस होना चाहिए जिसे कोई जांच सके, और वह अंकगणित औचित्य या सत्यापन योजना में होना चाहिए, किसी इंजीनियर की याददाश्त में नहीं।

TBD और TBR मानों को संभालना

प्रोजेक्ट की शुरुआत में कुछ मान अभी ज्ञात नहीं होते। आवश्यकता छोड़ देने से कमी छिप जाती है; कोई संख्या गढ़ लेने से अनिश्चितता छिप जाती है। सामान्य तरीका है आवश्यकता को प्लेसहोल्डर के साथ लिखना और प्लेसहोल्डर को एक खुले आइटम के रूप में ट्रैक करना।

  • TBD (to be determined, निर्धारित किया जाना है): अभी कोई मान नहीं। "The thermal design shall keep the battery cell temperature at or above TBD °C while charging."
  • TBR (to be reviewed, समीक्षा की जानी है, कभी-कभी "to be resolved"): सबसे अच्छा मौजूदा मान जिसकी पुष्टि नहीं हुई है। "…within 60 seconds", जिसमें 60 को TBR चिह्नित किया गया है।

जहाँ भी किसी संख्या का कोई आधार हो, केवल TBD के बजाय अनुमान के साथ TBR को प्राथमिकता दें: डिज़ाइनर अनुमान के अनुसार काम कर सकते हैं, और बाद में बदलने वाला मान एक परिवर्तन है, जिसे ट्रेसेबिलिटी ट्रैक करेगी। हर खुले आइटम को तीन चीज़ें चाहिए, वरना उसका प्रबंधन नहीं हो रहा:

  1. एक स्वामी, वह व्यक्ति जो उसे बंद करेगा।
  2. एक नियत तिथि या माइलस्टोन, सामान्यतः उस पर निर्भर डिज़ाइन निर्णयों से पहले।
  3. एक समापन योजना: वह विश्लेषण, टेस्ट या निर्णय जो मान तय करेगा।

EO-1 विनिर्देश में तीन खुले आइटम हैं। 3.5 Battery Thermal Control एक TBD है जिसका स्वामी Thermal Engineer है और जो पहले ही नियत तिथि पार कर चुका है। 2.4 Target Slew ("through 30 degrees within 60 seconds") एक TBR है जिसका स्वामी ADCS Lead है, और 5.3 Downlink Link Margin ("at least 3 dB link margin at 10 degrees elevation") एक TBR है जिसका स्वामी Comms Lead है; दोनों में कार्यशील मान हैं जिनका उपयोग डिज़ाइन तब तक करते हैं जब तक विश्लेषण पूरे नहीं होते।

हर माइलस्टोन पर खुले आइटम गिनें और अपेक्षा रखें कि गिनती घटे। कई खुले TBD वाली आवश्यकता बेसलाइन केवल नाम की बेसलाइन है। NASA Systems Engineering Handbook के समीक्षा मानदंड सिस्टम आवश्यकता समीक्षा से आगे यह मांगते हैं कि खुले TBD और TBR आइटम उन्हें बंद करने की योजना और शेड्यूल के साथ पहचाने जाएं। ट्रैकिंग किसी एट्रिब्यूट या रजिस्टर में होनी चाहिए, केवल टेक्स्ट में नहीं: वाक्य में टाइप किए गए "TBD" का न कोई स्वामी होता है न कोई तिथि, और उसे बंद करने की याद किसी को नहीं दिलाई जाती।

आवश्यकता प्रकार

आवश्यकताओं का वर्गीकरण समीक्षकों को सही प्रश्न पूछने में और सेट को पूर्ण रखने में मदद करता है। नीचे की श्रेणियां सामान्य हैं; ISO/IEC/IEEE 29148 और INCOSE गाइड मिलते-जुलते सेट बताते हैं, और कई प्रोजेक्ट अपनी श्रेणियां जोड़ते हैं।

प्रकारयह क्या बताता हैEO-1 उदाहरणकिस पर ध्यान दें
Functionalसिस्टम को क्या करना है4.3 Fault Detection: "The C&DH shall enter safe mode within 10 seconds of undervoltage detection."बिना प्रदर्शन वाला फ़ंक्शन; अधिकांश फ़ंक्शनल आवश्यकताओं को एक "कितनी अच्छी तरह" भी चाहिए, यहाँ "within 10 seconds"
Performanceकोई फ़ंक्शन कितनी अच्छी तरह किया जाता है: मात्रा, दर, सटीकता, समय2.1 Pointing Accuracy: "The ADCS shall point the payload boresight within 0.1 degrees of the commanded target."छूटी हुई शर्तें (कौन सा मोड, कौन सा जीवन चरण) और छूटी हुई सीमा की दिशा
इंटरफ़ेसकिसी दूसरे सिस्टम या एलिमेंट के साथ सीमा के पार क्या जाता है, और उसकी विशेषताएं5.2 UHF Command Uplink: "The UHF transceiver shall receive ground commands at 9.6 kbps." पूरी परिभाषा इंटरफ़ेस नियंत्रण दस्तावेज़ में होती है।ऐसी आवश्यकताएं जो ICD की ओर इशारा करने के बजाय उसे दोहराती हैं, जिससे दोनों अलग-अलग हो जाते हैं
बाधाडिज़ाइन पर या सिस्टम के निर्माण के तरीके पर बाहर से लगाई गई सीमा4.4 Downlink Encryption: "The C&DH shall encrypt each downlink frame with 256-bit keys." इसका औचित्य: ग्राहक अनुबंध पारगमन में एन्क्रिप्टेड इमेजरी मांगता है, इसलिए आवश्यकता प्रोजेक्ट के बाहर से आती है, उसके भीतर किसी ट्रेड से नहीं।ऐसे डिज़ाइन विकल्प जो बाधा के रूप में लिखे गए हों जबकि बाहर से किसी ने उन्हें नहीं थोपा
पर्यावरणीय, विश्वसनीयता, सुरक्षासहन करने योग्य परिस्थितियां और प्राप्त करने योग्य भरोसेमंदी1.7 Mission Lifetime: "The spacecraft shall operate in orbit for at least 730 days."ऐसे मान जिनके साथ वह संभाव्यता या विश्वास स्तर नहीं बताया गया जिस पर उनका दावा है

फ़ंक्शनल और प्रदर्शन आवश्यकताओं के बीच की रेखा अक्सर एक ही वाक्य के भीतर खिंचती है: कई आवश्यकताएं किसी फ़ंक्शन को उसके प्रदर्शन के साथ बताती हैं, जैसे 4.3। यह ठीक है, बशर्ते वाक्य में अब भी एक ही दायित्व हो। इंटरफ़ेस आवश्यकताओं को इंटरफ़ेस नियंत्रण दस्तावेज़ गाइड में और फ़ंक्शनल आवश्यकताओं के पीछे के फ़ंक्शन को फ़ंक्शनल विश्लेषण गाइड में अधिक विस्तार से कवर किया गया है।

हल किया हुआ उदाहरण: EO-1 विनिर्देश की समीक्षा

चेकलिस्ट के सामने SRS-001 की समीक्षा 32 आवश्यकताओं को तीन समूहों में बांटती है। अधिकांश पास होती हैं। कुछ में छोटे निष्कर्ष हैं, जिनमें से हर एक पर एक वाक्य काफ़ी है। तीन को फिर से लिखना ज़रूरी है।

उसी विनिर्देश की स्वचालित जांच समीक्षा से सहमत है: 32 में से 29 आवश्यकताएं अच्छी स्कोर करती हैं, और तीन कमज़ोर आवश्यकताओं को दोबारा काम की ज़रूरत है। 2.5 के निष्कर्ष हर टूटे नियम को नाम और संख्या से सूचीबद्ध करते हैं, जो लेखक को उसे ठीक करने के लिए चाहिए। जांच यह भी चिह्नित करती है कि वह क्या तय नहीं कर सकती: 3.1 पर सटीकता और साध्यता समीक्षक की प्रतीक्षा करती हैं क्योंकि पिछली समीक्षा के बाद टेक्स्ट बदल गया।

छोटे निष्कर्ष

  • 1.6.2 Off-Nadir Imaging, "up to 25 degrees off nadir": "up to" अधिकतम जैसा पढ़ा जाता है, लेकिन आशय एक ऐसी क्षमता है जो स्पेसक्राफ़्ट में 0 से 25 डिग्री तक किसी भी कोण पर होनी चाहिए। ग़लत अर्थ लगाने पर केवल नादिर पर इमेज लेने वाला डिज़ाइन भी अनुपालन करेगा।
  • 1.6.1 Ground Track Repeat, "its ground track": केवल एक संभावित संदर्भ वाला सर्वनाम, इसलिए निष्कर्ष मामूली है। उसी वाक्य में "every" सार्वभौमिक-क्वालिफ़ायर नियम की ग़लत चेतावनी है।
  • 1.5 Daily Collection Volume में एक विधि (विश्लेषण) और सफलता मानदंड ("Simulated daily volume of at least 3.2 GB over a 30-day plan") हैं, लेकिन अभी कोई लिंक किया गया विश्लेषण नहीं है। शब्दावली ठीक है; सत्यापन पूरा नहीं हुआ है।
  • 3.1 Orbit Average Power अच्छी तरह लिखी गई है, लेकिन अनुमोदन के बाद इसका टेक्स्ट बदल गया, इसलिए इसकी सटीकता और साध्यता को फिर से समीक्षक के निर्णय की ज़रूरत है। असली प्रश्न साध्यता है: डिज़ाइन किए गए ऐरे लगभग 28 W ऑर्बिट औसत देते हैं।

तीन पुनर्लेखन

2.5 Safe Mode Recovery. "The spacecraft should recover from safe mode quickly and resume imaging as appropriate" कम से कम छह नियम तोड़ती है: "shall" के बजाय "should", "and" से जुड़े दो दायित्व, बिना मान के "quickly", बचाव-खंड "as appropriate", अंत में पूर्ण विराम नहीं, और कोई सत्यापन नहीं। पुनर्लेखन ग्राहक के लिए महत्वपूर्ण एक परिणाम रखता है और उसे एक मान देता है:

The spacecraft shall resume imaging within 6 hours of a safe mode entry.

औचित्य को बताना चाहिए कि 6 घंटे कहाँ से आते हैं (N1 उसी दिन फ़सल तनाव अलर्ट मांगती है, और 6.2 डाउनलिंक से डिलीवरी तक 6 घंटे देती है)। अगर रिकवरी के चरण अपने आप में मायने रखते हैं, जैसे Sun पॉइंटिंग फिर से प्राप्त करना या कारण की रिपोर्ट करना, तो हर एक अपनी अलग आवश्यकता बनता है। विधि: टेस्ट, फ़्लैटसैट पर फ़ॉल्ट इंजेक्शन द्वारा; सफलता मानदंड: हर इंजेक्ट की गई सेफ़ मोड एंट्री में इमेजिंग 6 घंटे के भीतर फिर शुरू होती है।

3.5 Battery Thermal Control. "The thermal design shall keep the battery warm enough (TBD)." में एक अस्पष्ट शब्द, टेक्स्ट में एक TBD और एक कोष्ठक है। सुधार दायित्व, खुले मान और कारण को अलग करता है:

The thermal design shall keep the battery cell temperature at or above 0 °C while charging.

0 °C उदाहरण के लिए है: लिथियम-आयन सेल आमतौर पर हिमांक से नीचे चार्ज नहीं किए जाते, लेकिन असली सीमा सेल डेटा शीट और थर्मल विश्लेषण से आती है। जब तक वह विश्लेषण इसे तय नहीं करता, मान एक TBR है जिसका स्वामी Thermal Engineer है, और जिसकी नियत तिथि थर्मल डिज़ाइन समीक्षा से पहले है। पुनर्लेखन वह कमी भी उजागर करता है जो मूल ने छिपा रखी थी: डिस्चार्ज तापमान सीमा के लिए कोई आवश्यकता नहीं है, जिसके लिए अपना अलग कथन चाहिए।

6.4 Operator Interface. "The operator interface shall be user friendly and/or easy to use." में दो व्यक्तिपरक शब्द और एक "and/or" है। उपयोगिता निर्दिष्ट की जा सकती है, लेकिन केवल देखे जा सकने वाले कार्यों के ज़रिए:

The operator interface shall let a trained operator book a ground station contact in no more than 5 minutes.

कार्य और समय उदाहरण के लिए हैं। एक वास्तविक सेट उन कुछ कार्यों को सूचीबद्ध करेगा जो मायने रखते हैं (संपर्क बुक करना, लक्ष्य सूची अपलोड करना, नवीनतम हेल्थ टेलीमेट्री पढ़ना), हर एक के लिए समय और त्रुटि सीमा के साथ, जिन्हें प्रशिक्षण पूरा कर चुके ऑपरेटरों के साथ प्रदर्शन में मापा जाता है।

सामान्य ग़लतियां

ग़लतीक्या ग़लत होता हैबेहतर
डिज़ाइन समाधानों को आवश्यकताओं के रूप में लिखनाट्रेड होने से पहले ही डिज़ाइन तय हो जाता है, और किसी के निर्णय लिए बिना एक बेहतर विकल्प बाहर हो जाता है।ज़रूरत बताएं ("keep the cells at or above 0 °C while charging") और हीटर का चुनाव नीचे के स्तर पर छोड़ दें।
हितधारकों की भाषा सीधे आवश्यकताओं में कॉपी करना"Fresh imagery twice a week" एक ज़रूरत है; जैसा लिखा है, वह सत्यापन-योग्य नहीं है।ज़रूरत रखें, और ऐसी आवश्यकता लिखें जिसमें मान और शर्त हो और जो उसे पूरा करे (1.6 within 72 hours)।
एक पैराग्राफ़ में कई आवश्यकताएंएक पहचानकर्ता कई दायित्व रखता है, जिनकी एक ही स्थिति, एक ही टेस्ट और एक ही नियति होती है।हर आइटम में एक आवश्यकता, हर कथन में एक "shall"।
बिना शर्तों के मानजीवन की शुरुआत में और जीवन के अंत में "30 W" अलग-अलग डिज़ाइन हैं।मोड, जीवन चरण, पर्यावरण और औसत का तरीका बताएं।
कोई औचित्य नहींबाद के किसी परिवर्तन का मूल्यांकन कोई नहीं कर सकता, और आवश्यकता अपना कारण ख़त्म होने के बहुत बाद तक बनी रहती है।मान के पीछे का कारण और संख्याएं लिखें।
आवश्यकता से व्युत्पन्न न की गई टेस्ट सीमाएंआवश्यकता पूरी न होने पर भी टेस्ट पास हो जाता है (28 W ऑर्बिट औसत के सामने 72 W शिखर पर TC-06)।सफलता मानदंड को कथन से अंकगणित द्वारा व्युत्पन्न करें, और उसे दर्ज करें।
टेक्स्ट में टाइप किया गया और भुला दिया गया TBDखुले मान का न कोई स्वामी होता है न तिथि, और वह बेसलाइन तक पहुँच जाता है।हर TBD और TBR को स्वामी, नियत तिथि और समापन योजना के साथ ट्रैक करें।
गोल्ड प्लेटिंगजिन आवश्यकताओं को किसी ने मांगा नहीं, वे डिज़ाइन और टेस्ट का प्रयास खपाती हैं।जांचें कि हर शीर्ष-स्तरीय आवश्यकता किसी ज़रूरत या स्रोत तक ट्रेस होती है।
स्वचालित जांचों पर अत्यधिक निर्भरताशब्दों की साफ़ जांच को सही आवश्यकता मान लिया जाता है।यांत्रिक नियमों के लिए टूल का उपयोग करें; सही, साध्य और आवश्यक होने का निर्णय एक व्यक्ति करता है।

Holarch में आज़माएं

LML प्रोजेक्ट में हर आवश्यकता Requirement क्लास की एक एंटिटी होती है, जिसमें ऊपर बताए गए एट्रिब्यूट होते हैं: Rationale, Status, Priority, Criticality, Owner, Source, Verification Method, Verification Level, Success Criteria और TBD/TBR फ़ील्ड।

  1. डेमो प्रोजेक्ट प्रबंधित करें → प्रोजेक्ट फ़ाइलें ▾ → नया डेमो प्रोजेक्ट → CubeSat (गाइडेड सिस्टम्स इंजीनियरिंग) से बनाएं। इसके विनिर्देश में इस गाइड में उपयोग की गई तीन कमज़ोर आवश्यकताएं और खुले TBD/TBR आइटम हैं।
  2. ज़रूरतें और आवश्यकताएं → गुणवत्ता खोलें, दायरा सूची में दस्तावेज़ चुनें और गुणवत्ता जांचें पर क्लिक करें। हर आवश्यकता को नौ विशेषताओं पर स्कोर किया जाता है, और सुझाव INCOSE गाइड के उन नियमों की संख्याएं बताते हैं जिन्हें शब्द-सूची या पैटर्न जांच सकता है। Correct और Feasible के लिए समीक्षक चाहिए: निर्णय दर्ज करने के लिए चिह्न पर क्लिक करें।
  3. 2.5 को ऊपर की तरह फिर से लिखें और जांच दोबारा चलाएं। संयोजक, बचाव-खंड और अस्पष्ट-शब्द वाले निष्कर्ष ग़ायब हो जाते हैं।
  4. स्वामियों और नियत तिथियों के साथ खुले आइटम देखने के लिए ज़रूरतें और आवश्यकताएं → TBD/TBR खोलें, और मान तय होते ही किसी आइटम को बंद करें।
  5. जिन विशेषताओं का निर्णय कोई नियम नहीं कर सकता, उन पर दूसरी राय के लिए ✦ AI ▾ → AI आवश्यकता जांच का उपयोग करें; कुछ भी बदलने से पहले हर निर्णय और पुनर्लेखन समीक्षा के लिए दिखाया जाता है।

पूरा संदर्भ आवश्यकता की गुणवत्ता और TBD/TBR रजिस्टर दस्तावेज़ीकरण में है।

चेकलिस्ट डाउनलोड करें

EO-1 के पहले-और-बाद के उदाहरणों के साथ आवश्यकता गुणवत्ता चेकलिस्ट (CSV) में चेकलिस्ट के नियम उनके समीक्षा प्रश्नों और उदाहरणों के साथ हैं, किसी समीक्षा में उपयोग के लिए या किसी प्रोजेक्ट के अपने लेखन नियमों की शुरुआत के रूप में। यही फ़ाइल ट्रेसेबिलिटी गाइड में भी उपलब्ध है।

आवश्यकताएं लिखने के बारे में प्रश्न

Shall, must या will?

कोई भी परिपाटी काम करती है, अगर विनिर्देश उसे परिभाषित करे और उस पर टिका रहे। सबसे प्रचलित परिपाटी बाध्यकारी आवश्यकताओं के लिए "shall", सिस्टम के बाहर की चीज़ों के बारे में तथ्यों और इरादों के लिए "will", और सत्यापित न किए जाने वाले लक्ष्यों के लिए "should" का उपयोग करती है। कुछ सरकारी शैली गाइड सरल भाषा के कारणों से "must" को प्राथमिकता देती हैं। असली समस्या एक ही विनिर्देश में इन्हें मिलाना है।

किसी सिस्टम में कितनी आवश्यकताएं होनी चाहिए?

कोई सही संख्या नहीं है। एक छोटे स्पेसक्राफ़्ट में कुछ दर्जन सिस्टम आवश्यकताएं और उनके नीचे कुछ सौ हो सकती हैं; एक बड़े कार्यक्रम में हज़ारों होती हैं। अधिक उपयोगी प्रश्न ये हैं कि क्या हर आवश्यकता किसी ज़रूरत या पैरेंट तक ट्रेस होती है, और क्या हर ज़रूरत के नीचे आवश्यकताएं हैं।

क्या यूज़र स्टोरी आवश्यकताएं हैं?

यूज़र स्टोरी उपयोगकर्ता के शब्दों में एक ज़रूरत और उसका उद्देश्य दर्ज करती है। यह हितधारक ज़रूरत की भूमिका निभाती है, और इसके स्वीकृति मानदंड सत्यापन मानदंडों के क़रीब होते हैं। जो सिस्टम हार्डवेयर और सॉफ़्टवेयर के रूप में साथ-साथ बनाया, एकीकृत और सत्यापित होता है, उसके लिए स्टोरीज़ को फिर भी ऐसी आवश्यकताओं में बदलना होता है जिन्हें आवंटित और टेस्ट किया जा सके।

क्या कोई टूल आवश्यकता गुणवत्ता जांच सकता है?

एक टूल यांत्रिक नियमों को भरोसेमंद ढंग से जांच सकता है: मोडल क्रियाएं, संयोजक, अस्पष्ट शब्द, बचाव-खंड, सर्वनाम, छूटे हुए लिंक। वह यह नहीं जान सकता कि 30 W सही मान है या ऐरे उसे दे सकते हैं या नहीं। समीक्षा से पहले यांत्रिक निष्कर्ष साफ़ करने के लिए स्वचालित जांच का उपयोग करें, ताकि समीक्षक अपना समय सटीकता और साध्यता पर लगाएं।

आगे कहाँ जाएं