Holarch
Kurs bölümleri

Eğitim · Kurs 2. Gereksinimler ve doğrulama · Bölüm 2.1 / 6

2.1 Gereksinim yazma ve Kalite denetimi 3:37

Gereksinimleri öznitelikleriyle yazın ve zayıf ifadeleri kalite denetimine buldurun.

Holarch 1.27'yi gösterir.

Neler öğreneceksiniz

  • Bir gereksinimi ölçülebilir bir değer içeren, test edilebilir tek bir shall ifadesi olarak yazın
  • Bir şartnamenin bir bölümünün altına gereksinim ekleyin
  • Bir gereksinimin önceliğini, doğrulama yöntemini, gerekçesini ve tür etiketini ayarlayın
  • Bir belgede kalite denetimini çalıştırın ve işaretlediği bir gereksinimi düzeltin
  • Bir gereksinimi kendiniz gözden geçirdikten sonra Doğru ve Uygulanabilir'i işaretleyin

Bike-Share Dock şartnamesinde gereksinimler yazın: bir gereksinimi neyin iyi yaptığı, bölümlerin altına gereksinim ekleme, öncelik, doğrulama yöntemi ve gerekçeyi doldurma, onlara etiket verme, gereksinim kalite denetimini çalıştırma, zayıf bir gereksinimi düzeltme ve inceleyicinin yargısını kaydetme.

Proje dosyaları

  • Başlangıç projesi (.holarch.json; Projeleri yönet → Proje dosyaları ▾ → Proje içe aktar (.json)…)
  • Bitmiş proje (.holarch.json; Projeleri yönet → Proje dosyaları ▾ → Proje içe aktar (.json)…)

Video holarch.app'ten oynatılır; bkz. Gizlilik Politikası.

Alıştırma

Bunu Holarch'ta, CubeSat EO-1 demo projesinde kendiniz yapın.

  1. EO-1 demo projenizi açın (veya oluşturun: Projeleri yönet → Proje dosyaları ▾ → Yeni demo proje → CubeSat (Rehberli sistem mühendisliği)).
  2. İhtiyaçlar ve gereksinimler → Belgeler → EO-1 System Requirements Specification'ı açın. 5 Communications bölümünü seçin, + Alt'a tıklayın, gereksinimin adını Command Link Margin koyun ve bir değer içeren bir shall ifadesi yazın (örneğin 5 derece yükseklikte en az 6 dB marj).
  3. Özellik panelinde Öncelik'i Yüksek, Doğrulama yöntemi'ni Analiz olarak ayarlayın ve bir Gerekçe girin, ardından + Etiket'e tıklayın ve Performance Requirement'ı seçin.
  4. İhtiyaçlar ve gereksinimler → Kalite'yi açın, kapsam çubuğunda Belge: EO-1 System Requirements Specification'ı seçin ve Kaliteyi denetle'ye tıklayın. 2.5 Safe Mode Recovery için Öneriler'i okuyun.
  5. 2.5'i tek bir ölçülebilir ifade olarak yeniden yazın (kurtarmayı neyin tetiklediği, ne kadar hızlı olduğu ve hangi moda geçildiği) ve yeniden Kaliteyi denetle'ye tıklayın.
  6. Yeniden yazdığınız metni gözden geçirin, ardından satırında Doğru ve Uygulanabilir altındaki ✘'e tıklayarak bunları Evet olarak işaretleyin.

2.5 Safe Mode Recovery öncekinden daha yüksek puan aldığında, önerileri artık belirsiz sözcükleri adlandırmadığında ve Doğru ile Uygulanabilir ✔ gösterdiğinde işiniz bitmiştir.

Kendinizi sınayın

  1. and ile birleştirilmiş bir gereksinim, iki yarısı da iyi olsa bile neden daha düşük puan alır?
  2. Otomatik denetim neden Doğru ve Uygulanabilir'i hiçbir zaman işaretleyemez?
  3. quickly gibi bir sözcüğü bir gereksinimde sorun yapan nedir?
Yanıtları göster
  1. and ile birleştirilmiş bir gereksinim, iki yarısı da iyi olsa bile neden daha düşük puan alır?

    Tek bir gereksinimde iki gereksinim barındırır. Bunlar ayrı ayrı doğrulanamaz, izlenemez veya değiştirilemez, bu yüzden denetim onu tekil değil olarak işaretler.

  2. Otomatik denetim neden Doğru ve Uygulanabilir'i hiçbir zaman işaretleyemez?

    Bir gereksinimin doğru ihtiyacı belirtip belirtmediği ve gerçekleştirilip gerçekleştirilemeyeceği mühendislik yargısı gerektirir. Onu bir kişi gözden geçirir ve bu iki ölçütü işaretler.

  3. quickly gibi bir sözcüğü bir gereksinimde sorun yapan nedir?

    Ölçülemez, bu yüzden hiçbir test gereksinimin karşılandığını gösteremez. Onu bir değer ve bir birimle değiştirin.

Daha fazla bilgi

Döküm

Dökümü göster (anlatım ve ekranda görünenler)

Introduction

Welcome to Requirements and Verification. This track follows requirements from the first draft to the proof that the system meets them, on the Bike-Share Dock from Getting Started.

This first chapter is about writing requirements well, and letting Holarch check them.

A good requirement

A good requirement states one thing the system shall do, in words that can only mean one thing, with a value someone can test. Vague words such as fast or user friendly cannot be tested, and two requirements joined by and cannot be checked separately.

On screen: Card: a good requirement.

Write requirements

Open the specification. Select section 5.1, Timing and Throughput, open the menu next to After, and choose Add Child. Name the requirement Pay at the Kiosk, and write its statement in the inspector.

On screen: SRS → 5.1 → Add Child → Pay at the Kiosk.

Add two more the same way: an environmental requirement under 7.1, and a usability requirement under 8.3. The usability one is written the way requirements often are on a first try.

On screen: 7.1 → Operate in Cold and Heat; 8.3 → Friendly Kiosk.

Attributes and labels

Each requirement also has attributes for planning. Select Pay at the Kiosk, and set its priority to High, its verification method to Test, and its rationale: why the value was chosen.

On screen: 5.1.1 → Priority, Verification Method, Rationale.

Give it a label too: click Label in the inspector, and choose Performance Requirement. Labels let you filter and report by kind.

On screen: + Label → Performance Requirement.

Quality check

Now check the wording. Open Needs and Requirements, then Quality, choose the specification, and click Check Quality. Each requirement is scored against nine qualities of a good requirement, with a tick or a cross for each.

On screen: Quality → Document: the SRS → Check Quality.

Friendly Kiosk scores low. The findings name the problems: user friendly and quick cannot be measured, and the and joins two requirements in one.

On screen: Findings for Friendly Kiosk.

Fix it. Go back to the document, select the requirement, and rewrite it as one measurable statement.

On screen: Back to the SRS → 8.3.1 → new description.

Check the quality again. The score rises. Two qualities, correct and feasible, always need a person: when you have reviewed a requirement, click their crosses to mark them yes.

On screen: Quality → Check Quality again → mark Correct and Feasible.

Recap

Let's recap. You learned what makes a requirement good, added requirements under sections, filled in their attributes and labels, ran the quality check, fixed a weak requirement, and recorded your own judgment.

Next, you trace the stakeholder needs to these requirements.