Capítulos do curso
Treinamento · Trilha 2. Requisitos e verificação · Capítulo 2.4 de 6
2.4 Linhas de base e vínculos a revisar 2:40
Congele a especificação em uma linha de base, altere um requisito e revise o que a mudança afeta.
Mostra o Holarch 2.13.
O que você vai aprender
- Salvar uma linha de base do documento com um registro de aprovação
- Explicar o que uma mudança em um requisito aprovado faz com seu status e seus vínculos
- Revisar um vínculo sinalizado com Diff e marcá-lo como revisado com uma nota
- Comparar uma linha de base com a versão atual e exportar as alterações
Congele a especificação da Bike-Share Dock em uma linha de base com uma aprovação, altere um requisito aprovado, veja-o voltar para revisão e seus vínculos marcados para revisão, revise o vínculo e marque-o como revisado com uma nota, e liste todas as mudanças desde a linha de base.
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 EO-1 System Requirements Specification, clique em Versão ▾ no bloco do título e escolha Salvar linha de base…. Dê o nome
PDR Baseline, preencha uma linha de aprovador com seu nome e seu papel e clique em Criar. - Mude 3.3 Depth of Discharge de 30% para 25% na descrição e leia a notificação: o requisito voltou para In Review e seus vínculos precisam de revisão.
- Abra Necessidades e requisitos → Vínculos a revisar. Em uma linha de 3.3, clique em Diff, depois em Marcar como revisado…, escreva o que você conferiu e clique em Marcar como revisado.
- No documento, escolha Versão ▾ → Comparar versões… com De PDR Baseline e Para Versão atual, e clique em Alterações (Excel).
- Abra Controle e revisões → Linhas de base e versões e encontre PDR Baseline ao lado de SRR Baseline. Para congelar o modelo inteiro em vez de um documento, você usaria + Salvar linha de base… no cabeçalho desta página.
Você terminou quando o relatório de mudanças a partir de PDR Baseline listar a edição em 3.3 e o vínculo que você revisou não aparecer mais em Vínculos a revisar.
Teste-se
- Por que alterar um requisito marca os vínculos que dependem dele, e não só o requisito?
- Qual é a diferença entre uma linha de base de documento e uma linha de base de projeto?
- Ao marcar um vínculo como revisado, por que escrever uma nota?
Mostrar as respostas
Por que alterar um requisito marca os vínculos que dependem dele, e não só o requisito?
Os itens na outra ponta, como a função que o atende ou o teste que o verifica, foram conferidos em relação ao texto antigo. Cada vínculo precisa ser conferido de novo para ver se ainda vale.
Qual é a diferença entre uma linha de base de documento e uma linha de base de projeto?
Uma linha de base de documento congela um documento e suas aprovações (Versão ▾ → Salvar linha de base…). Uma linha de base de projeto congela todos os itens e relacionamentos (Linhas de base e versões → + Salvar linha de base…).
Ao marcar um vínculo como revisado, por que escrever uma nota?
A nota registra o que foi conferido e por que o vínculo ainda vale. Ela é adicionada aos comentários do item vinculado, para que um revisor possa acompanhar a decisão depois.
Saiba mais
Transcrição
Mostrar a transcrição (narração e o que aparece na tela)
Introduction
Chapter four: baselines and links to review. Once a specification is agreed, changes need control: everyone should know what changed, and what the change might break.
We baseline the Bike-Share Dock specification, then change one of its requirements.
Change control
A baseline is a read-only snapshot of a document, with its approvals. After it, every change is visible, and a change to a requirement marks the links that depend on it for review, until someone checks them.
On screen: Card: baselines and links to review.
First, give Show Available Bikes a link to depend on. In the Database, select it, and in its Trace section link it with satisfied by to the rental kiosk, which shows the numbers.
On screen: 4.1.1 → Trace → satisfied by + → Link existing… → Rental Kiosk.
Baseline
Open the specification, and the version menu in its title block. Choose Save Baseline, name it SRR Baseline for the requirements review, add your role, and click Create.
On screen: SRS → Current version ▾ → Save Baseline… → SRR Baseline → Create.
A change
Now a change. The team wants the kiosk to show the charge level of each e-bike too. Select Show Available Bikes, and update its statement in the inspector.
On screen: 4.1.1 → Item → new description.
The message says what happened, in the same undo step as the edit: the approved requirement went back to In Review, and its link to the rental kiosk now needs review.
On screen: The toast and the status.
Links to review
Open Needs and Requirements, then Links to Review. Each row is a link to check. Diff shows exactly how the text changed.
On screen: Links to Review → Diff.
The rental kiosk can show charge levels too, so the link still holds. Click Mark Reviewed, write what you checked, and click Mark Reviewed. The link no longer needs review.
On screen: Mark Reviewed… → note → Mark Reviewed.
Changes since the baseline
To see everything that changed since the review, open the specification's version menu again, and choose Compare Versions: from SRR Baseline to the current version.
On screen: SRS → version ▾ → Compare Versions… → SRR Baseline → Current.
The report lists each addition, removal and edit, ready to export to Excel or as a Word redline for a change board.
On screen: The change report.
Recap
Let's recap. You baselined the specification with an approval, changed an approved requirement, saw it return to review with its link flagged, marked the link reviewed with a note, and listed the changes since the baseline.
Next, you plan and run the tests that verify the requirements.