Kılavuz · Gereksinimler
İyi sistem gereksinimleri nasıl yazılır: örnekler ve denetim listesi
Bu kılavuzu dinleyin 26 dk
İyi bir gereksinim, sistemin yapması veya olması gereken tek bir şeyi, iki mühendisin aynı şekilde okuduğu sözcüklerle ve bir testin veya analizin denetleyebileceği bir değerle söyler. Bu kılavuz ihtiyaçlar ile gereksinimler arasındaki farkı, bir gereksinim ifadesinin parçalarını, ISO/IEC/IEEE 29148 ve INCOSE Guide to Writing Requirements'taki kalite niteliklerini, öncesi ve sonrası örnekleriyle bir denetim listesini, doğrulama ve kabul ölçütlerini, TBD ve TBR değerlerini ve gereksinim türlerini ele alır; hepsi tek bir CubeSat spesifikasyonu üzerinde işlenir.
Bu sayfada
- Bir gereksinimin ifadesi neden önemlidir
- Paydaş ihtiyaçları ve gereksinimler
- Bir gereksinimin anatomisi
- İyi bir gereksinimin kalite nitelikleri
- Denetim listesi: öncesi ve sonrası örnekleriyle kurallar
- Doğrulama yöntemini ve kabul ölçütlerini gereksinimle birlikte yazın
- TBD ve TBR değerlerini ele alma
- Gereksinim türleri
- Çözümlü örnek: EO-1 spesifikasyonunu inceleme
- Yaygın hatalar
- Holarch'ta deneyin
- Denetim listesini indirin
- Gereksinim yazma hakkında sorular
- Sonra nereye gidilir
Bir gereksinimin ifadesi neden önemlidir
Gereksinim, bir sistemi isteyenlerle onu üretenler arasında bir sözleşmedir. Aşağı akıştaki her şey onu okur: tasarımcı bir bileşeni ona göre boyutlandırır, test mühendisi ondan bir başarı ölçütü yazar, değişiklik kurulu bir değişikliği ona göre tartar ve müşteri sistemi ona göre kabul eder. Her biri aynı cümleyi, genellikle yazarı yanında olmadan okur. Cümle iki şekilde okunabiliyorsa öyle okunacaktır ve fark geç ortaya çıkar: kimsenin üzerinde uzlaşmadığı bir ölçüte göre “başarılı” olan bir testte veya müşterinin başka bir şey kastettiği kabulde.
Kötü ifade modelin geri kalanını da bozar. Değeri olmayan bir gereksinim bir bileşene tahsis edilemez, çünkü kimse bileşenin onu karşılayıp karşılamadığını söyleyemez. Doğrulanamaz, bu yüzden izlenebilirlikte ve doğrulama matrisinde bir kapsama boşluğu olarak görünür. Değiştiğinde de kimse bağlı tasarımın hâlâ geçerli olup olmadığını söyleyemez. Gereksinimleri iyi yazmak bir projedeki en ucuz kalite çalışmasıdır: başta bir cümleye harcanan bir saat, sonda bir test kampanyasını kurtarır.
Kılavuz tek bir sürekli örnek kullanır: tarım arazilerini dört spektral bantta görüntüleyen kurgusal bir 6U CubeSat olan EO-1. Spesifikasyonu SRS-001 EO-1 System Requirements Specification, çoğu sağlam, üçü kasıtlı olarak zayıf 32 gereksinim içerir. Uçtan uca MBSE örnek projesindeki modelin aynısıdır. Burada alıntılanan N1–N3 paydaş ihtiyaçları, izlenebilirlik kılavuzunun modele eklediği ihtiyaçlardır.
Paydaş ihtiyaçları ve gereksinimler
Gereksinim yazımı bir adım önce, ihtiyaçlarla başlar. Paydaş ihtiyacı, bir kullanıcının, operatörün, müşterinin veya düzenleyicinin kendi terimleriyle beklediği şeydir. Gereksinim ise sistemin ona göre tasarlandığı ve doğrulandığı mühendislik ifadesidir. ISO/IEC/IEEE 15288 ikisini ayrı teknik süreçlerde tutar: paydaş ihtiyaçlarının ve gereksinimlerinin tanımlanması (6.4.2) ve sistem gereksinimlerinin tanımlanması (6.4.3). INCOSE Needs and Requirements Manual aynı ayrımı yapar ve ihtiyaçları gereksinimlerin kaba taslakları olarak değil, kendi başına öğeler olarak ele alır.
| EO-1 örneği | Denetleme yolu | |
|---|---|---|
| İhtiyaç (N2 Twice-Weekly Revisit) | Çiftlik müşterilerinin büyüme mevsiminde tarlalarına ait güncel görüntülere haftada en az iki kez ihtiyacı vardır. | Geçerleme: müşteriler teslim edilen sistemden ihtiyaç duyduklarını alıyor mu? |
| Gereksinim (1.6 Revisit Time) | The mission shall revisit each target region within 72 hours. | Doğrulama: sistem ifadeyi test, analiz, muayene veya gösterimle karşılıyor mu? |
Fark, her birinin nasıl denetlendiğinde görünür. Bir gereksinim doğrulanır: sistem ifadeye göre ölçülür. Bir ihtiyaç geçerlenir: biri, sistemin amaçlanan kullanımında paydaşın istediğini yaptığını teyit eder. Gereksinimler asıl noktayı kaçırdıysa sistem her doğrulamadan geçip yine de geçerlemede başarısız olabilir; doğrulama ve geçerleme kılavuzu bu boşluğu ele alır. Yazım açısından pratik sonuç basittir: önce ihtiyacı yazın, ardından karşılandığında onu tatmin edecek gereksinimleri yazın ve her gereksinimi yanıtladığı ihtiyaca geri bağlayın.
Dönüşüm nadiren bire birdir. N2, 1.6 Revisit Time olur; bu da 1.6.1 Ground Track Repeat (3 gün) ve 1.6.2 Off-Nadir Imaging (25 derece) olarak ayrıştırılır. Bazı gereksinimler hiçbir ihtiyacı doğrudan yanıtlamaz: 3.1 Orbit Average Power, 1.5 Daily Collection Volume'dan türetilmiştir, çünkü panellerin sağlaması gereken gücü görüntüleme yükü belirler. Hiçbir müşteri 30 W istemedi, ancak istedikleri görüntüleme onsuz gerçekleşemez.
Bir gereksinimin anatomisi
Bir gereksinim cümlesinden ibaret değildir. Cümle yükümlülüğü taşır; çevresindeki öznitelikler ise gerekçeleri, onu kanıtlama planını ve kayıt tutmayı taşır. İki yarı da yazımın parçasıdır.
İfade
İyi gereksinim ifadelerinin çoğu tek bir kalıba uyar. ISO/IEC/IEEE 29148 (5.2.4) bunu bir özne, bir eylem, bir nesne ve eylem üzerindeki kısıtlar, önde isteğe bağlı bir koşulla tanımlar; INCOSE Guide to Writing Requirements aynı sırayı ve her gereksinim türü için üzerinde uzlaşılmış şablonları önerir.
| Parça | Ne söyler | EO-1 4.3 Fault Detection |
|---|---|---|
| Koşul (isteğe bağlı) | Gereksinimin ne zaman, hangi modda veya durumda geçerli olduğu | “…of undervoltage detection” (tetikleyici olay) |
| Özne | Uyması gereken sistem veya öğe, tam adıyla | “The C&DH” |
| Kip fiili | Yükümlülüğün gücü | “shall” |
| Eylem | Öznenin yaptığı veya olduğu şey, etken bir fiille | “enter” |
| Nesne | Eylemin uygulandığı şey | “safe mode” |
| Performans veya kısıt | Birimi ve sınır yönüyle ölçülebilir değer | “within 10 seconds” |
Hepsi birlikte: “The C&DH shall enter safe mode within 10 seconds of undervoltage detection.” Sıra değişebilir (“When undervoltage is detected, the C&DH shall…”, birçok ekibin kullandığı EARS şablonlarındaki gibi koşulu öne alır), ancak her parça bulunmalı veya bilerek dışarıda bırakılmalıdır.
Ağırlığın çoğunu üç sözcük taşır. Shall bağlayıcı bir gereksinimi belirtir; will sistemin dışındaki bir şey hakkında bir olguyu veya niyeti bildirir; should doğrulanmayan bir hedefi bildirir. Proje hangi kuralı kullanırsa kullansın, onu spesifikasyonda bir kez tanımlayın ve ona bağlı kalın. EO-1 1.1 Reference Orbit (“The mission assumes a 500 km sun-synchronous orbit…”) doğru biçimde gereksinim olarak değil varsayım olarak yazılmıştır: ona bağlı gereksinimler için bağlamdır ve model onu puanlanmayan ve doğrulanmayan bir ifade olarak saklar.
Öznitelikler
PDR sonrası 28 W'tan 30 W'a yapılan değişiklikten sonra EO-1 modelinin kaydettiği hâliyle 3.1 Orbit Average Power:
| Öznitelik | 3.1 Orbit Average Power | Neden orada |
|---|---|---|
| Tanımlayıcı ve ad | 3.1 Orbit Average Power | Bağlantılar, incelemeler ve değişiklik talepleri için kalıcı bir tutamak |
| İfade | The solar arrays shall generate at least 30 W orbit-average power at end of life. | Yükümlülüğün kendisi |
| Gerekçe | Orbit-average load grew to 26 W after PDR; 30 W keeps 15% margin. | Sonraki bir okuyucunun bir değişikliği yazar olmadan değerlendirmesini sağlar |
| Kaynak ve üst öğe | Derived (systems analysis); 1.5 Daily Collection Volume'dan türetilmiş | Geri izlenebilirlik: gereksinimin neden var olduğu |
| Doğrulama yöntemi ve düzeyi | Test, alt sistem düzeyinde | Onu kanıtlama planı, yazarken kararlaştırılır |
| Başarı ölçütleri | End-of-life orbit-average power predicted from measured peak power. | Hangi sonucun karşılandı sayıldığı |
| Sahip, öncelik, kritiklik | Power Engineer; High; High | Kimin sorumlu olduğu ve ne kadar önemli olduğu |
| Durum | İncelemede (Onaylandı durumundaydı; metni onaydan sonra değişti) | Uzlaşma sürecinde nerede olduğu |
| TBD/TBR | Yok | Bir değerin hâlâ açık olup olmadığı |
ISO/IEC/IEEE 29148 (5.2.8) bu tür öznitelikleri listeler ve INCOSE kılavuzu daha fazlasını ekler; bir proje gerçekten sürdüreceklerini seçer. Gerekçe en sık atlanan ve sonradan en çok aranandır. “26 W yük, %15 pay” olmadan 3.1'i gören bir sonraki kişi 30 W'ın katı bir fiziksel sınır mı, bir müşteri sayısı mı yoksa bir pay seçimi mi olduğunu söyleyemez ve dolayısıyla yükteki bir değişikliğin onun için ne anlama geldiğini de söyleyemez.
İyi bir gereksinimin kalite nitelikleri
Üslup kurallarını neyi koruduklarını bildiğinizde uygulamak daha kolaydır. ISO/IEC/IEEE 29148 (5.2.5) tek bir gereksinimin dokuz niteliğini adlandırır ve INCOSE Guide to Writing Requirements aynı dokuzunu, her biri kısa bir tanım ve onu destekleyen kurallarla, C1–C9 olarak kullanır. Tablo her birini bir inceleyicinin sorabileceği bir soru olarak verir.
| Nitelik | Sorulacak soru | EO-1 örneği |
|---|---|---|
| Necessary | Silinseydi paydaşların ihtiyaç duyduğu bir şey kaybolur muydu? Bir kopya değil mi? | 3.1 gereklidir: o olmadan hiçbir şey panelleri görüntüleme yüküne göre boyutlandırmaz. |
| Appropriate | Bir alt düzeyin vermesi gereken bir tasarım seçimini sabitlemeden doğru düzeyde mi yazılmış? | 3.1 paneller için bir güç düzeyi belirler; bir hücre türü veya panel sayısı değil. |
| Unambiguous | Yalnızca tek bir şekilde okunabilir mi? | 6.4 “user friendly” başarısız: iki inceleyici karşılanıp karşılanmadığı konusunda anlaşamaz. |
| Complete | Eksik koşul veya değer olmadan gereken her şeyi söylüyor mu? | 3.5 “warm enough (TBD)” başarısız: değer eksik. |
| Singular | Tek bir yükümlülük mü belirtiyor? | 2.5 başarısız: “and” ile birleştirilmiş şekilde hem kurtarmayı hem de görüntülemeye devam etmeyi istiyor. |
| Feasible | Teknoloji, maliyet ve takvimin bilinen kısıtları içinde karşılanabilir mi? | 30 W'taki 3.1 şüpheli: tasarlandığı hâliyle paneller yaklaşık 28 W yörünge ortalaması veriyor. |
| Verifiable | Bir test, analiz, muayene veya gösterim karşılandığını gösterebilir mi? | 2.5 “quickly” başarısız; “within 6 hours” geçer. |
| Correct | Kaynağının gerçek ihtiyacını doğru değerle belirtiyor mu? | 1.2'deki 4,5 m yer örnekleme mesafesi, N3 tarla düzeyi haritalarını payla birlikte doğru ifade eder. |
| Conforming | Projenin üzerinde uzlaşılmış şablonlarına ve sözcük dağarcığına uyuyor mu? | Her EO-1 gereksinimi “shall”, adı belirtilmiş bir özne ve SI birimleri kullanır. |
Bir gereksinim kümesinin, hiçbir tek ifadenin gösteremeyeceği kendi nitelikleri vardır. ISO/IEC/IEEE 29148 (5.2.6) kümeyi eksiksiz, tutarlı, bir bütün olarak uygulanabilir, anlaşılır ve geçerlenebilir olarak listeler; INCOSE kılavuzu C15 olarak doğru niteliğini ekler ve küme niteliklerini C10–C15 olarak numaralandırır.
- Eksiksiz: küme ihtiyaçları kapsar. EO-1 bir düşük gerilimde ne olacağını belirtir (4.3), ancak tek güvenli moddan kurtarma gereksinimi yazıldığı hâliyle doğrulanamayan 2.5'tir; bu yüzden kurtarma fiilen belirtilmemiştir.
- Tutarlı: iki gereksinim çelişmez ve terimler ile birimler aynı şekilde kullanılır. 1.5 günde 3,2 GB görüntü verisi, 5.4 ise yerde alınan 3 GB ister; yalnızca 5.4'ün gerekçesi “after compression” dediği için uyuşurlar. Gerekçe olmadan bir çelişki gibi görünürler.
- Uygulanabilir: gereksinimler birlikte karşılanabilir. Her güç gereksinimi tek başına uygulanabilir olabilir, ancak 30 W yörünge ortalaması, panel alanı ve kütle bütçesi birlikte olmayabilir.
- Anlaşılır: bir okuyucu sistemden ne beklendiğini ve gereksinimlerin nasıl ilişkili olduğunu anlayabilir; bu, ifade kadar yapıya, numaralandırmaya ve izlenebilirliğe de bağlıdır.
- Geçerlenebilir: kümenin ihtiyaçları karşılayan bir sisteme götürdüğü gösterilebilir; her üst düzey gereksinimin bir ihtiyaca geri bağlanmasının nedeni budur.
Denetim listesi: öncesi ve sonrası örnekleriyle kurallar
Nitelikler somut yazım kurallarıyla kullanılabilir hâle gelir. INCOSE Guide to Writing Requirements bunları numaralandırır (R1, R2 vb.); NASA Systems Engineering Handbook (Ek C) aynı doğrultuda daha kısa bir denetim listesi içerir. Tablo, uygulamada sorunların çoğunu yakalayan kuralları, her biri için EO-1 spesifikasyonundan bir örnekle bir araya getirir. “Öncesi” demodaki hâliyle metindir; “Sonrası” bir yeniden yazımdır. Örnek olarak işaretlenen değerler EO-1 analizlerinin sonuçlarını değil, biçimi gösterir.
| Kural | Sorulacak soru | Öncesi (EO-1) | Sonrası |
|---|---|---|---|
| İfade başına bir yükümlülük | Tam olarak bir “shall”, iki talebi birleştiren “and”, “or”, “and/or” yok mu? | 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.” Önemli olan diğer kurtarma adımları kendi gereksinimlerini alır. |
| Zorunluluk bildiren ifade | Bağlayıcı bir gereksinim için “should”, “will” veya “may” değil, “shall” mı? | 2.5: “should recover” | “shall resume” |
| Birimli ölçülebilir değer | Her performans sözcüğünün bir sayısı ve birimi var mı? | 2.5: “quickly” | “within 6 hours of a safe mode entry” |
| Sınır yönü belirtilmiş | Değerin bir alt sınır mı yoksa üst sınır mı olduğu açık mı? | 1.6.2: “image targets up to 25 degrees off nadir” | “image targets at off-nadir angles from 0 to 25 degrees” (yönlendirme üzerinde bir üst sınır değil, bir yetenek aralığı) |
| Kaçamak ifade yok | Tedarikçinin takdirine bırakılan bir şey var mı (“as appropriate”, “if possible”, “where practical”)? | 2.5: “as appropriate” | Kaldırıldı; önemli olan koşul belirtildi |
| Belirsiz veya öznel terim yok | İki inceleyici karşılanıp karşılanmadığı konusunda anlaşamayabilir mi (“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.” (örnek; önemli olan her görev için bir gereksinim) |
| Açık adlar, zamir yok | Her “it”, “its” veya “this” için tam olarak bir olası gönderge var mı? | 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.” Burada zamir zararsızdır, ancak daha uzun bir cümlede ilk kayan şey odur. |
| Koşullar belirtilmiş | Değerin ne zaman geçerli olduğunu söylüyor mu: yaşam evresi, mod, ortam? | “The solar arrays shall generate 30 W.” | “…at least 30 W orbit-average power at end of life.” |
| Kesinleşmiş değerler veya izlenen TBD'ler | Her açık değer yalnızca metne yazılmakla kalmayıp bir sahip ve son tarihle izleniyor mu? | 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.” (örnek; ısıl analiz değeri belirleyene kadar TBD özniteliği Thermal Engineer'ı ve bir son tarihi adlandırır) |
| İfadede gerekçe veya not yok | Amaç bildiren ifadeler (“so that”, “in order to”) ve parantez içi notlar gerekçeye taşınmış mı? | 3.5: “(TBD)” | Parantezsiz ifade; neden Gerekçe alanında |
| Nasıl değil, ne | Bir alt düzeyin seçmesi gereken bir çözümü dayatmak yerine ihtiyacı mı belirtiyor? | “The thermal design shall keep the battery warm by means of a 2 W film heater.” (örnek) | Yukarıdaki 3.5 yeniden yazımı: ısıtıcıyı ısıl tasarıma bırakan bir sıcaklık sınırı |
| Olumlu ve ulaşılabilir | Ölçülebilir bir sınır kastedildiğinde “not”, “never”, “always”, “100%” kullanmaktan kaçınıyor mu? | “The C&DH shall never lose a stored command.” (örnek) | “The C&DH shall execute each stored command within 1 second of the scheduled time.” (yazıldığı hâliyle 4.2) |
| Gerekçe kaydedilmiş | Değerin neden seçildiğini söylüyor mu? | Gerekçesiz 3.1 | Gerekçe: “Orbit-average load grew to 26 W after PDR; 30 W keeps 15% margin.” |
| Doğrulama yöntemi ve ölçütleri | Yöntem seçilmiş ve başarı ölçütü ifadeden türetilmiş mi? | 3.1: yöntem Test; TC-06 tepe gücün ≥ 72 W olmasını bekler | Güç bütçesi üzerinden türetilmiş başarı ölçütü: 30 W yörünge ortalaması için yaklaşık 80,6 W tepe (bir sonraki bölüme bakın) |
| Yukarı doğru izlenebilir | Bir ihtiyaca, bir üst gereksinime veya bir kaynak gereksinime bağlı mı? | Yukarı akış bağlantısı olmayan 3.1 | 1.5 Daily Collection Volume'dan türetilmiş 3.1 |
| Benzersiz | Başka bir gereksinim aynı şeyi başka sözcüklerle söylüyor mu? | Isıl bölümün altında ikinci bir “The battery shall store 77 Wh” (örnek) | Tek bir gereksinim, 3.2 Battery Capacity, gereken yerlerde başvurulur |
Denetim listesi bir yazım şablonu değil, bir inceleyici aracıdır. Her seferinde bir kural aramak yerine her gereksinimi tüm listeye karşı bir kez okuyun ve bulguyu çiğnediği kuralla birlikte kaydedin; böylece yazar neyi değiştireceğini bilir. Kuralların yanlış pozitifleri de vardır. Bir sözcük listesi denetimi 1.6.1'deki “every” sözcüğünü evrensel bir niceleyici olarak işaretler, ancak “every 3 days” tüm durumlar hakkında bir iddia değil, bir periyottur; kararı inceleyici verir.
Doğrulama yöntemini ve kabul ölçütlerini gereksinimle birlikte yazın
Doğrulanabilirlik niteliğini denetlemenin en kolay anı gereksinimin yazıldığı andır: yazar karşılandığının nasıl gösterileceğini söyleyemiyorsa gereksinim bitmemiştir. Her gereksinimle iki şey kaydedin.
- Doğrulama yöntemi: test, analiz, muayene veya gösterim ve yapıldığı montaj düzeyi (bileşen, alt sistem, sistem). EO-1'de dördü de vardır: 3.1 testle, 1.5 Daily Collection Volume analizle, 3.4 Bus Regulation muayeneyle ve 6.1 Contact Scheduling gösterimle doğrulanır. RVTM kılavuzu bunlar arasında nasıl seçim yapılacağını açıklar.
- Başarı ölçütleri (kabul ölçütleri): karşılandı sayılan gözlemlenebilir sonuç; test veya analiz ondan yazılabilecek şekilde belirtilir. 3.2 Battery Capacity için: “Measured capacity of at least 77 Wh at C/2 and 20 °C.” 6.2 Image Delivery için: “Products on the portal within 6 h for 95% of passes in rehearsal.”
Ölçütleri ifadenin yanına yazmak, aksi hâlde ancak sonda bulunan bir hata sınıfını yakalar. EO-1'in 3.1'i, bir güneş simülatöründe tepe gücü ölçen ve 72 W veya üzerinde başarılı sayılan TC-06 Solar Array Power Test ile doğrulanır. Oysa gereksinim yörünge ortalaması güçle ilgilidir ve model birini diğerine güneşli kesir (0,62) ve güç yolu verimiyle (0,6) dönüştürür. 72 W tepe güç 72 × 0,62 × 0,6 = 26,8 W yörünge ortalaması verir; bu, şimdiki 30 W bir yana, ilk 28 W'ın bile altındadır. Test eşiği gereksinimden türetilmemiştir. TC-06 75,1 W ölçtü ve “başarılı” oldu, ancak 75,1 W, iki değerin de altında kalan 27,9 W'a karşılık gelir. Ölçüt ifadeden yazılmış olsaydı yaklaşık 30 / (0,62 × 0,6) = 80,6 W tepe olurdu ve açık ilk testte görünürdü. Değişiklik etki analizi kılavuzu aynı bulguyu 28 W'tan 30 W'a değişiklik boyunca izler.
Ders genelleştirilebilir: bir başarı ölçütü, gereksinimin değerine birinin denetleyebileceği bir hesapla izlenebilmelidir ve bu hesap bir mühendisin belleğinde değil, gerekçede veya doğrulama planında yer almalıdır.
TBD ve TBR değerlerini ele alma
Bir projenin başlarında bazı değerler henüz bilinmez. Gereksinimi dışarıda bırakmak boşluğu gizler; bir sayı uydurmak belirsizliği gizler. Olağan uygulama, gereksinimi bir yer tutucuyla yazmak ve yer tutucuyu açık bir madde olarak izlemektir.
- TBD (to be determined, belirlenecek): henüz değer yok. “The thermal design shall keep the battery cell temperature at or above TBD °C while charging.”
- TBR (to be reviewed, gözden geçirilecek; bazen “to be resolved”): teyit edilmemiş, şu anki en iyi değer. “…within 60 seconds”, 60 TBR olarak işaretli.
Bir sayı için herhangi bir dayanak varsa çıplak bir TBD yerine tahminli bir TBR'yi tercih edin: tasarımcılar bir tahmine göre çalışabilir ve sonradan değişen bir değer, izlenebilirliğin takip edeceği bir değişikliktir. Her açık madde üç şeye ihtiyaç duyar; aksi hâlde yönetilmiyordur:
- Onu kapatacak kişi olan bir sahip.
- Normalde ona bağlı tasarım kararlarından önce gelen bir son tarih veya kilometre taşı.
- Bir kapatma planı: değeri belirleyecek analiz, test veya karar.
EO-1 spesifikasyonunda üç açık madde vardır. 3.5 Battery Thermal Control, sahibi Thermal Engineer olan ve süresi zaten geçmiş bir TBD'dir. 2.4 Target Slew (“through 30 degrees within 60 seconds”) sahibi ADCS Lead olan bir TBR, 5.3 Downlink Link Margin (“at least 3 dB link margin at 10 degrees elevation”) ise sahibi Comms Lead olan bir TBR'dir; ikisi de analizler biterken tasarımların kullandığı çalışma değerleri taşır.
Açık maddeleri her kilometre taşında sayın ve sayının düşmesini bekleyin. Çok sayıda açık TBD içeren bir gereksinim temel çizgisi yalnızca adda bir temel çizgidir. NASA Systems Engineering Handbook'taki inceleme ölçütleri, sistem gereksinimleri incelemesinden itibaren açık TBD ve TBR maddelerinin kapatma planı ve takvimiyle birlikte belirlenmesini ister. İzleme yalnızca metinde değil, bir öznitelikte veya kayıtta yer almalıdır: bir cümleye yazılmış bir “TBD”nin sahibi ve tarihi yoktur ve hiçbir şey kimseye onu kapatmayı hatırlatmaz.
Gereksinim türleri
Gereksinimleri sınıflandırmak inceleyicilerin doğru soruları sormasına ve kümenin eksiksiz kalmasına yardımcı olur. Aşağıdaki kategoriler yaygın olanlardır; ISO/IEC/IEEE 29148 ve INCOSE kılavuzu benzer kümeler tanımlar ve birçok proje kendi kategorilerini ekler.
| Tür | Neyi belirtir | EO-1 örneği | Dikkat edilecekler |
|---|---|---|---|
| İşlevsel | Sistemin ne yapması gerektiği | 4.3 Fault Detection: “The C&DH shall enter safe mode within 10 seconds of undervoltage detection.” | Performansı eklenmemiş bir işlev; çoğu işlevsel gereksinim bir “ne kadar iyi” de gerektirir, burada “within 10 seconds” |
| Performans | Bir işlevin ne kadar iyi yapıldığı: miktar, hız, doğruluk, süre | 2.1 Pointing Accuracy: “The ADCS shall point the payload boresight within 0.1 degrees of the commanded target.” | Eksik koşullar (hangi mod, hangi yaşam evresi) ve eksik sınır yönü |
| Arayüz | Başka bir sistem veya öğeyle bir sınırı geçen şey ve özellikleri | 5.2 UHF Command Uplink: “The UHF transceiver shall receive ground commands at 9.6 kbps.” Tam tanım arayüz kontrol belgesinde yer alır. | ICD'ye başvurmak yerine onu yeniden ifade eden ve böylece zamanla ondan uzaklaşan gereksinimler |
| Kısıt | Tasarım veya sistemin nasıl üretileceği üzerinde dışarıdan dayatılan bir sınır | 4.4 Downlink Encryption: “The C&DH shall encrypt each downlink frame with 256-bit keys.” Gerekçesi: müşteri sözleşmesi aktarım sırasında şifrelenmiş görüntü gerektirir; bu yüzden gereksinim projenin içindeki bir ödünleşimden değil, projenin dışından gelir. | Dışarıdan kimse dayatmadığı hâlde kısıt olarak yazılmış tasarım seçimleri |
| Çevresel, güvenilirlik, emniyet | Dayanılması gereken koşullar ve ulaşılması gereken güvenilebilirlik | 1.7 Mission Lifetime: “The spacecraft shall operate in orbit for at least 730 days.” | İddia edildikleri olasılık veya güven düzeyi belirtilmemiş değerler |
İşlevsel ve performans gereksinimleri arasındaki çizgi çoğu zaman tek bir cümlenin içinde çizilir: birçok gereksinim, 4.3'ün yaptığı gibi, bir işlevi performansıyla birlikte belirtir. Cümle hâlâ tek bir yükümlülük taşıdığı sürece bu sorun değildir. Arayüz gereksinimleri arayüz kontrol belgesi kılavuzunda, işlevsel gereksinimlerin arkasındaki işlevler ise işlevsel analiz kılavuzunda daha ayrıntılı ele alınır.
Çözümlü örnek: EO-1 spesifikasyonunu inceleme
SRS-001'in denetim listesine göre incelenmesi 32 gereksinimi üç gruba ayırır. Çoğu geçer. Birkaçının her biri bir cümleye değer küçük bulguları vardır. Üçünün yeniden yazılması gerekir.
Aynı spesifikasyonun otomatik denetimi incelemeyle aynı sonuca varır: 32 gereksinimden 29'u iyi puan alır ve üç zayıf gereksinimin yeniden çalışılması gerekir. 2.5 için bulgular her çiğnenen kuralı adı ve numarasıyla listeler; bir yazarın düzeltmek için ihtiyaç duyduğu da budur. Denetim karar veremediğini de işaretler: 3.1'de metin son incelemeden sonra değiştiği için doğruluk ve uygulanabilirlik bir inceleyiciyi bekler.
Küçük bulgular
- 1.6.2 Off-Nadir Imaging, “up to 25 degrees off nadir”: “up to” bir üst sınır gibi okunur, ancak amaç uzay aracının 0 ile 25 derece arasındaki her açıda sahip olması gereken bir yetenektir. Yanlış bir okuma, yalnızca nadirde görüntüleyen bir tasarımın uyumlu sayılmasına izin verir.
- 1.6.1 Ground Track Repeat, “its ground track”: yalnızca bir olası göndergesi olan bir zamir; bu yüzden bulgu küçüktür. Aynı cümledeki “every”, evrensel niceleyici kuralının bir yanlış pozitifidir.
- 1.5 Daily Collection Volume'un bir yöntemi (analiz) ve başarı ölçütleri (“Simulated daily volume of at least 3.2 GB over a 30-day plan”) vardır, ancak henüz bağlı bir analizi yoktur. İfade iyidir; doğrulama yapılmamıştır.
- 3.1 Orbit Average Power iyi yazılmıştır, ancak metni onaydan sonra değişti; bu yüzden doğruluğu ve uygulanabilirliği yeniden bir inceleyicinin değerlendirmesini gerektirir. Asıl soru uygulanabilirliktir: tasarlandığı hâliyle paneller yaklaşık 28 W yörünge ortalaması verir.
Üç yeniden yazım
2.5 Safe Mode Recovery. “The spacecraft should recover from safe mode quickly and resume imaging as appropriate” en az altı kuralı çiğner: “shall” yerine “should”, “and” ile birleştirilmiş iki yükümlülük, değeri olmayan “quickly”, “as appropriate” kaçamak ifadesi, sondaki noktanın eksikliği ve doğrulama yokluğu. Yeniden yazım müşteri için önemli olan tek sonucu korur ve ona bir değer verir:
The spacecraft shall resume imaging within 6 hours of a safe mode entry.
Gerekçe 6 saatin nereden geldiğini söylemelidir (N1 aynı gün ürün stresi uyarıları ister ve 6.2 indirmeden teslime 6 saate izin verir). Güneş yönlendirmesini yeniden kazanmak veya nedeni bildirmek gibi kurtarma adımları kendi başlarına önemliyse her biri kendi gereksinimi olur. Yöntem: flatsat üzerinde arıza enjeksiyonuyla test; başarı ölçütü: enjekte edilen her güvenli mod girişinde görüntüleme 6 saat içinde yeniden başlar.
3.5 Battery Thermal Control. “The thermal design shall keep the battery warm enough (TBD).” belirsiz bir terim, metinde bir TBD ve bir parantez içerir. Düzeltme yükümlülüğü, açık değeri ve gerekçeyi birbirinden ayırır:
The thermal design shall keep the battery cell temperature at or above 0 °C while charging.
0 °C örnek amaçlıdır: lityum iyon hücreler genellikle donma noktasının altında şarj edilmez, ancak gerçek sınır hücre veri sayfasından ve ısıl analizden gelir. O analiz değeri belirleyene kadar değer, sahibi Thermal Engineer olan ve son tarihi ısıl tasarım incelemesinden önce olan bir TBR'dir. Yeniden yazım, orijinalin gizlediği bir boşluğu da ortaya çıkarır: deşarj sıcaklık aralığı için bir gereksinim yoktur ve bunun kendi ifadesi olması gerekir.
6.4 Operator Interface. “The operator interface shall be user friendly and/or easy to use.” iki öznel terim ve bir “and/or” içerir. Kullanılabilirlik belirtilebilir, ancak yalnızca gözlemlenebilir görevler aracılığıyla:
The operator interface shall let a trained operator book a ground station contact in no more than 5 minutes.
Görev ve süre örnek amaçlıdır. Gerçek bir küme önemli olan birkaç görevi (bir bağlantı ayırmak, bir hedef listesi yüklemek, en son sağlık telemetrisini okumak) her biri bir süre ve hata sınırıyla listeler ve bunlar eğitimi tamamlamış operatörlerle bir gösterimde ölçülür.
Yaygın hatalar
| Hata | Ne ters gider | Daha iyisi |
|---|---|---|
| Tasarım çözümlerini gereksinim olarak yazmak | Tasarım, ödünleşim yapılmadan önce sabitlenir ve daha iyi bir seçenek kimse karar vermeden elenir. | İhtiyacı belirtin (“hücreleri şarj sırasında 0 °C veya üzerinde tutun”) ve ısıtıcıyı bir alt düzeyin seçmesine bırakın. |
| Paydaş dilini doğrudan gereksinimlere kopyalamak | “Haftada iki kez güncel görüntü” bir ihtiyaçtır; yazıldığı hâliyle doğrulanamaz. | İhtiyacı koruyun ve onu karşılayan, bir değeri ve koşulu olan bir gereksinim yazın (1.6, 72 saat içinde). |
| Tek paragrafta birkaç gereksinim | Bir tanımlayıcı birkaç yükümlülük taşır; bunlar tek bir durumu, tek bir testi ve tek bir akıbeti paylaşır. | Öğe başına bir gereksinim, ifade başına bir “shall”. |
| Koşulsuz değerler | Ömür başında ve ömür sonunda “30 W” farklı tasarımlardır. | Modu, yaşam evresini, ortamı ve ortalama alma biçimini belirtin. |
| Gerekçe yok | Kimse sonraki bir değişikliği değerlendiremez ve gereksinim, nedeni ortadan kalktıktan çok sonra da yaşamaya devam eder. | Değerin arkasındaki nedeni ve sayıları yazın. |
| Gereksinimden türetilmemiş test eşikleri | Gereksinim karşılanmadığı hâlde bir test başarılı olur (28 W yörünge ortalamasına karşı 72 W tepede TC-06). | Başarı ölçütünü ifadeden hesapla türetin ve kaydedin. |
| Metne yazılıp unutulan TBD | Açık değerin sahibi veya tarihi yoktur ve temel çizgiye ulaşır. | Her TBD ve TBR'yi bir sahip, son tarih ve kapatma planıyla izleyin. |
| Gereksiz süsleme | Kimsenin istemediği gereksinimler tasarım ve test emeği tüketir. | Her üst düzey gereksinimin bir ihtiyaca veya kaynağa izlendiğini denetleyin. |
| Otomatik denetimlere aşırı güvenmek | Temiz bir sözcük denetimi, doğru bir gereksinim sanılır. | Mekanik kurallar için araçları kullanın; doğruluğa, uygulanabilirliğe ve gerekliliğe bir kişi karar verir. |
Holarch'ta deneyin
Bir LML projesinde her gereksinim, yukarıda anlatılan özniteliklere sahip Requirement sınıfından bir nesnedir: Rationale, Status, Priority, Criticality, Owner, Source, Verification Method, Verification Level, Success Criteria ve TBD/TBR alanları.
- Demoyu Projeleri yönet → Project Files ▾ → Yeni demo proje → CubeSat (Rehberli sistem mühendisliği) ile oluşturun. Spesifikasyonu bu kılavuzda kullanılan üç zayıf gereksinimi ve açık TBD/TBR maddelerini içerir.
- İhtiyaçlar ve gereksinimler → Kalite'yi açın, kapsam listesinden belgeyi seçin ve Kaliteyi denetle'ye tıklayın. Her gereksinim dokuz niteliğe göre puanlanır ve öneriler, bir sözcük listesinin veya kalıbın denetleyebileceği INCOSE kılavuzu kural numaralarını adlandırır. Correct ve Feasible bir inceleyici gerektirir: kararı kaydetmek için işarete tıklayın.
- 2.5'i yukarıdaki gibi yeniden yazın ve denetimi yeniden çalıştırın. Bağlaç, kaçamak ifade ve belirsiz terim bulguları kaybolur.
- Sahipleri ve son tarihleriyle açık maddeleri görmek için İhtiyaçlar ve gereksinimler → TBD/TBR'yi açın ve değeri kesinleşen bir maddeyi Kapat ile kapatın.
- Bir kuralın karar veremediği nitelikler hakkında ikinci bir görüş için ✦ YZ ▾ → YZ gereksinim denetimi'ni kullanın; her karar ve yeniden yazım, herhangi bir şey değişmeden önce inceleme için gösterilir.
Tam başvuru Gereksinim Kalitesi ve TBD/TBR Kaydı belgelerindedir.
Denetim listesini indirin
EO-1 öncesi ve sonrası örnekleriyle gereksinim kalitesi denetim listesi (CSV), bir incelemede kullanmak veya bir projenin kendi yazım kuralları için başlangıç noktası olarak, denetim listesi kurallarını inceleme soruları ve örnekleriyle birlikte içerir. Aynı dosya izlenebilirlik kılavuzunda da sunulur.
Gereksinim yazma hakkında sorular
Shall, must mı yoksa will mi?
Spesifikasyon tanımladığı ve ona bağlı kaldığı sürece her kural işe yarar. En yaygın olanı bağlayıcı gereksinimler için “shall”, sistemin dışındaki şeylere ilişkin olgular ve niyetler için “will” ve doğrulanmayan hedefler için “should” kullanır. Bazı kamu üslup kılavuzları sade dil gerekçesiyle “must”ı tercih eder. Asıl sorun bunları tek bir spesifikasyon içinde karıştırmaktır.
Bir sistemin kaç gereksinimi olmalıdır?
Doğru bir sayı yoktur. Küçük bir uzay aracının birkaç düzine sistem gereksinimi ve bunların altında birkaç yüz gereksinimi olabilir; büyük bir programın binlercesi vardır. Daha yararlı sorular, her gereksinimin bir ihtiyaca veya üst gereksinime izlenip izlenmediği ve her ihtiyacın altında gereksinimler olup olmadığıdır.
Kullanıcı hikâyeleri gereksinim midir?
Bir kullanıcı hikâyesi bir ihtiyacı ve amacını kullanıcının terimleriyle kaydeder. Bir paydaş ihtiyacının rolünü oynar ve kabul ölçütleri doğrulama ölçütlerine yakındır. Donanım ve yazılım olarak birlikte üretilen, entegre edilen ve doğrulanan bir sistem için hikâyelerin yine de tahsis edilip test edilebilecek gereksinimlere dönüştürülmesi gerekir.
Bir araç gereksinim kalitesini denetleyebilir mi?
Bir araç mekanik kuralları güvenilir biçimde denetleyebilir: kip fiilleri, bağlaçlar, belirsiz sözcükler, kaçamak ifadeler, zamirler, eksik bağlantılar. 30 W'ın doğru değer olup olmadığını veya panellerin bunu sağlayıp sağlayamayacağını bilemez. İnceleyiciler zamanlarını doğruluk ve uygulanabilirliğe ayırsın diye mekanik bulguları bir incelemeden önce temizlemek için otomatik denetimi kullanın.
Sonra nereye gidilir
- Gereksinim izlenebilirliği ve değişiklik etkisi: bu gereksinimleri ihtiyaçlara, tasarıma ve testlere bağlayın ve bir değişikliği izleyin.
- İşlevsel analiz: gereksinimleri işlevlere dönüştürün ve tahsis edin.
- Gereksinim doğrulama matrisi: her gereksinim için doğrulama yöntemini planlayın ve sonuçları kaydedin.
- Holarch'ta ihtiyaçlar ve gereksinimler: tek bir modelde belgeler, kalite denetimleri, temel çizgiler ve izlenebilirlik.