Holarch
과정의 장

교육 · 트랙 2. 요구사항과 검증 · 2.1장 (전체 6장)

2.1 요구사항 작성과 품질 검사 3:37

요구사항을 속성과 함께 작성하고, 품질 검사로 약한 표현을 찾습니다.

Holarch 1.27 화면입니다.

학습 내용

  • 측정 가능한 값이 있는 시험 가능한 shall 문장 하나로 요구사항 작성하기
  • 명세서의 섹션 아래에 요구사항 추가하기
  • 요구사항의 우선순위, 검증 방법, 근거, 유형 레이블 설정하기
  • 문서에 품질 검사를 실행하고 검사가 표시한 요구사항 고치기
  • 요구사항을 직접 검토한 후 Correct와 Feasible 표시하기

Bike-Share Dock 명세서에 요구사항을 작성합니다. 좋은 요구사항의 조건, 섹션 아래에 요구사항 추가, 우선순위, 검증 방법, 근거 입력, 레이블 지정, 요구사항 품질 검사 실행, 약한 요구사항 수정, 검토자의 판단 기록을 다룹니다.

프로젝트 파일

  • 시작 프로젝트 (.holarch.json; 프로젝트 관리 → 프로젝트 파일 ▾ → 프로젝트 가져오기 (.json)…)
  • 완성 프로젝트 (.holarch.json; 프로젝트 관리 → 프로젝트 파일 ▾ → 프로젝트 가져오기 (.json)…)

동영상은 holarch.app에서 재생됩니다. 개인정보 처리방침을 참조하십시오.

실습

CubeSat EO-1 데모 프로젝트에서 Holarch로 직접 해 보십시오.

  1. EO-1 데모 프로젝트를 여십시오(또는 만드십시오: 프로젝트 관리 → 프로젝트 파일 ▾ → 새 데모 프로젝트 → CubeSat (Guided systems engineering)).
  2. 니즈 및 요구사항 → 문서 → EO-1 System Requirements Specification을 엽니다. 섹션 5 Communications를 선택하고 + 하위를 클릭한 다음, 요구사항 이름을 Command Link Margin으로 지정하고 값이 있는 shall 문장을 작성합니다(예: 고도각 5도에서 최소 6 dB 여유).
  3. 속성 패널에서 우선순위를 High로, Verification Method를 Analysis로 설정하고 근거를 입력한 다음, + 레이블을 클릭하고 Performance Requirement를 선택합니다.
  4. 니즈 및 요구사항 → 품질을 열고 범위 표시줄에서 Document: EO-1 System Requirements Specification을 선택한 다음 품질 검사를 클릭합니다. 2.5 Safe Mode Recovery의 제안을 읽습니다.
  5. 2.5를 측정 가능한 문장 하나로 다시 쓰고(무엇이 복구를 시작하는지, 얼마나 빨리, 어느 모드로), 품질 검사를 다시 클릭합니다.
  6. 다시 쓴 내용을 검토한 다음, 해당 행의 Correct와 Feasible 아래의 ✘를 클릭해 Yes로 표시합니다.

2.5 Safe Mode Recovery의 점수가 이전보다 높고, 제안에 더 이상 모호한 단어가 언급되지 않으며, Correct와 Feasible에 ✔가 표시되면 완료입니다.

스스로 확인

  1. and로 이어진 요구사항은 두 부분이 모두 좋아도 점수가 낮은 이유는 무엇입니까?
  2. 자동 검사가 Correct와 Feasible을 결코 표시할 수 없는 이유는 무엇입니까?
  3. quickly 같은 단어가 요구사항에서 문제가 되는 이유는 무엇입니까?
답 보기
  1. and로 이어진 요구사항은 두 부분이 모두 좋아도 점수가 낮은 이유는 무엇입니까?

    요구사항 두 개를 하나에 담고 있습니다. 두 요구사항을 따로 검증하거나, 추적하거나, 변경할 수 없으므로 검사는 이를 단일하지 않음으로 표시합니다.

  2. 자동 검사가 Correct와 Feasible을 결코 표시할 수 없는 이유는 무엇입니까?

    요구사항이 올바른 니즈를 기술하는지, 구현 가능한지는 엔지니어링 판단이 필요합니다. 사람이 검토하고 이 두 기준을 표시합니다.

  3. quickly 같은 단어가 요구사항에서 문제가 되는 이유는 무엇입니까?

    측정할 수 없으므로 어떤 테스트도 요구사항이 충족되었음을 보여 줄 수 없습니다. 값과 단위로 바꾸십시오.

더 읽어 보기

대본

대본 보기 (내레이션과 화면 내용)

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.