Uma matriz de rastreabilidade de requisitos é uma tabela que liga cada requisito aos testes que o verificam e aos defeitos que o violam. A maioria das equipas constrói uma para uma auditoria, preenche-a uma vez e nunca mais a abre, porque a forma como costuma ser construída responde a uma pergunta que ninguém faz duas vezes: “todos os requisitos estão cobertos por um teste?”

Essa pergunta tem uma resposta útil exatamente uma vez, antes da entrega. A que surge todas as semanas é a inversa, e começa com um erro.

Duas direções, e só uma é usada

Uma matriz de rastreabilidade pode ser lida para a frente ou para trás.

Para a frente, do requisito para o teste: há alguma coisa a verificar cada requisito? É a direção para que os modelos são feitos, e vale mesmo a pena fazê-la antes de uma entrega. Um requisito com a coluna de testes vazia é uma promessa que ninguém está a verificar.

Para trás, do defeito ao requisito que viola: quando chega um relatório, que comportamento acordado contradiz, e que teste devia tê-lo apanhado? É a direção que se usa todos os dias, e a maioria das matrizes torna-a difícil, porque a coluna dos defeitos foi uma reflexão tardia.

Fraco
Uma folha de requisitos com uma coluna "IDs dos casos de teste", preenchida para a auditoria e congelada no dia em que passou.
Melhor
As mesmas linhas, mantidas vivas pelos defeitos: cada erro novo fica ligado ao requisito que viola, ou expõe um requisito que ninguém escreveu.

A leitura para trás é onde a matriz se paga, porque resolve uma discussão que, de outra forma, não tem árbitro. Um defeito é um comportamento que contradiz algo acordado. Se um relatório não se consegue rastrear a nenhuma linha, não é um erro no sentido acordado: é um pedido novo ou uma lacuna nos requisitos, e ambos merecem uma conversa diferente de “corrijam isso”.

O modelo

Cinco colunas. Mantenha o texto do requisito suficientemente curto para se ler na tabela; o texto completo fica onde estiverem os seus requisitos.

# Matriz de rastreabilidade: [produto ou versão]

**Última revisão:** [data]
**Responsável:** [quem mantém isto atualizado]

| Requisito | O que tem de ser verdade | Casos de teste | Último resultado | Defeitos em aberto |
| --- | --- | --- | --- | --- |
| [ID-REQ] | [o critério de aceitação, numa linha] | [IDs dos casos de teste, ou NENHUM] | [aprovado / reprovado / bloqueado, e a construção] | [IDs dos defeitos, ou nenhum] |
| [ID-REQ] | [o critério de aceitação, numa linha] | [IDs dos casos de teste, ou NENHUM] | [aprovado / reprovado / bloqueado, e a construção] | [IDs dos defeitos, ou nenhum] |

## Defeitos sem requisito

Relatórios que não se ligam a nenhuma linha acima. Cada um é um pedido novo ou um requisito que ninguém escreveu. Decida qual é e depois mova-o.

| Defeito | O que aconteceu | Decisão |
| --- | --- | --- |
| [ID do defeito] | [uma linha] | [pedido novo / requisito em falta, e quem é responsável] |
Modelo de matriz de rastreabilidadetraceability-matrix.pt.txt958 BytesDescarregar

As linhas que dizem alguma coisa

Uma matriz é sobretudo linhas que não dizem nada: um requisito, dois testes, ambos aprovados, nenhum defeito. O valor está em quatro padrões, e vale a pena ler a matriz à procura deles em vez de a ler de cima a baixo.

Um requisito sem teste. Escrito como NENHUM, de propósito, em vez de deixado em branco. Uma célula em branco lê-se como “alguém se esqueceu de preencher isto”; NENHUM lê-se como uma decisão, que é o que deve ser.

Um requisito cujos testes passam e que ainda tem defeitos em aberto. Esta é a linha mais informativa da tabela. Os testes verificam algo diferente daquilo em que os utilizadores estão a bater, o que normalmente significa que o critério de aceitação era estreito demais, ou que o teste verifica o caminho feliz e os defeitos vivem num estado inicial que ninguém nomeou.

Um teste que não se liga a nenhum requisito. Ou verifica algo que importa e o requisito nunca foi escrito, ou verifica algo que ninguém acordou e custa tempo em cada execução.

A secção do fim. Os defeitos sem requisito são de onde vêm as discussões de âmbito. Uma equipa que mantém essa lista visível tem a discussão uma vez, cedo, com a decisão registada ao lado. Uma equipa que não a mantém tem-na em cada reunião de triagem.

Uma matriz de testes é outra grelha

Os dois nomes são usados como se fossem o mesmo e descrevem coisas diferentes.

Uma matriz de rastreabilidade cruza requisitos com testes. Uma matriz de testes cruza testes com configurações: o mesmo caso de teste executado nos navegadores, dispositivos e ambientes que importam, para que uma célula diga “teste 14 no Safari num iPhone: falhou”. Responde a outra pergunta, que não é “isto está coberto?” mas “onde é que isto se parte?”.

Encontram-se na coluna dos defeitos. Um erro que falha numa célula da matriz de testes e passa nas outras não é um requisito reprovado, é uma configuração reprovada, e registá-lo no requisito como se este estivesse partido em todo o lado envia a correção para o sítio errado. O guia de testes entre navegadores explica quão poucas configurações essa grelha precisa de facto.

Mantê-la viva

Uma matriz construída uma vez só está certa durante uma semana. As que continuam úteis são alimentadas por algo que acontece de qualquer forma.

Ligue-a à triagem em vez do calendário de versões: quando um defeito é triado, quem o tria preenche o requisito que viola, ou acrescenta-o à secção do fim. É um passo de trinta segundos numa decisão que se toma de qualquer forma, e é o passo que mantém a direção para trás a funcionar. O resto da tabela muda raramente: os requisitos quando o âmbito muda, os casos de teste quando o modelo de caso de teste ganha um caso novo, os resultados quando há uma execução.

A coluna de requisitos só vale o que valem os requisitos. Se forem adjetivos, a matriz liga os defeitos a frases que ninguém consegue verificar. O guia de critérios de aceitação explica como os escrever de forma a que um defeito consiga, de facto, contradizer um deles.

Onde se encontra com um relatório de erro

A direção para trás só funciona se um relatório trouxer o suficiente para rastrear. “O checkout está partido” não se liga a nada. “O pagamento com um cartão guardado falha com um erro depois do passo da morada, no Safari, numa conta com dois cartões guardados” liga-se a um requisito, a um caso de teste e, muito provavelmente, a uma célula de configuração que a matriz de testes nunca executou.

Session Replay

Extensão gratuita do Chrome. Um clique na página que está com problemas captura a captura de ecrã, a consola e o registo de rede, e dá-lhe uma ligação para colar no bilhete.

Obter a extensão

O navegador, a página, os passos e o que o servidor devolveu são o que transforma uma queixa numa linha da matriz. O guia de relatórios de erro cobre o resto do que um relatório precisa.

O resumo

Ligue os requisitos aos testes e aos defeitos, e leia a matriz de trás para a frente: de um erro novo ao requisito que viola. Escreva NENHUM onde não há teste, de propósito. Mantenha uma secção para os defeitos que não se ligam a nada, porque é aí que começam as discussões de âmbito. E mantenha à parte uma matriz de testes, para a pergunta de onde falha um teste que passa.