Capítulos do curso
Treinamento · Trilha 2. Requisitos e verificação · Capítulo 2.1 de 6
2.1 Escrever requisitos e a checagem de qualidade 3:37
Escreva requisitos com seus atributos e deixe a checagem de qualidade encontrar redações fracas.
Mostra o Holarch 1.27.
O que você vai aprender
- Escrever um requisito como uma única declaração com shall, testável e com um valor mensurável
- Adicionar um requisito sob uma seção de uma especificação
- Definir a prioridade, o método de verificação, a justificativa e o rótulo de tipo de um requisito
- Executar a checagem de qualidade em um documento e corrigir um requisito que ela sinaliza
- Marcar Correto e Viável depois de revisar você mesmo um requisito
Escreva requisitos na especificação da Bike-Share Dock: o que torna um requisito bom, como adicionar requisitos sob seções, preencher prioridade, método de verificação e justificativa, dar rótulos a eles, executar a checagem de qualidade dos requisitos, corrigir um requisito fraco e registrar o julgamento do revisor.
Arquivos de projeto
- Projeto inicial (.holarch.json; Gerenciar projetos → Arquivos de projeto ▾ → Importar projeto (.json)…)
- Projeto concluído (.holarch.json; Gerenciar projetos → Arquivos de projeto ▾ → Importar projeto (.json)…)
O vídeo é reproduzido a partir de holarch.app; veja a Política de Privacidade.
Prática
Faça isto você mesmo no Holarch, no projeto de demonstração CubeSat EO-1.
- Abra seu projeto de demonstração EO-1 (ou crie-o: Gerenciar projetos → Arquivos de projeto ▾ → Novo projeto de demonstração → CubeSat (engenharia de sistemas guiada)).
- Abra Necessidades e requisitos → Documentos → EO-1 System Requirements Specification. Selecione a seção 5 Communications, clique em + Filho, dê ao requisito o nome
Command Link Margine escreva uma declaração com shall e um valor (por exemplo, margem de pelo menos 6 dB a 5 graus de elevação). - No inspetor, defina Prioridade como Alta, Verification Method como Analysis e uma Justificativa, depois clique em + Rótulo e escolha Performance Requirement.
- Abra Necessidades e requisitos → Qualidade, escolha Documento: EO-1 System Requirements Specification na barra de escopo e clique em Checar qualidade. Leia as Sugestões para 2.5 Safe Mode Recovery.
- Reescreva 2.5 como uma única declaração mensurável (o que dispara a recuperação, com que rapidez e para qual modo) e clique em Checar qualidade de novo.
- Revise sua nova redação e depois clique no ✘ sob Correto e Viável na linha dele para marcá-los como Sim.
Você terminou quando 2.5 Safe Mode Recovery tiver uma pontuação maior que antes, suas sugestões não apontarem mais palavras vagas, e Correto e Viável mostrarem ✔.
Teste-se
- Por que um requisito unido por and tem pontuação menor mesmo quando as duas metades são boas?
- Por que a checagem automática nunca pode marcar Correto e Viável?
- O que torna uma palavra como quickly um problema em um requisito?
Mostrar as respostas
Por que um requisito unido por and tem pontuação menor mesmo quando as duas metades são boas?
Ele contém dois requisitos em um. Eles não podem ser verificados, rastreados nem alterados separadamente, então a checagem o sinaliza como não singular.
Por que a checagem automática nunca pode marcar Correto e Viável?
Se um requisito declara a necessidade certa e se pode ser construído exige julgamento de engenharia. Uma pessoa o revisa e marca esses dois critérios.
O que torna uma palavra como quickly um problema em um requisito?
Ela não pode ser medida, então nenhum teste consegue mostrar que o requisito foi atendido. Substitua-a por um valor e uma unidade.
Saiba mais
Transcrição
Mostrar a transcrição (narração e o que aparece na tela)
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.