Requisitos claros ajudam as equipas de desenvolvimento a criar o produto certo. E uma especificação de requisitos de software (SRS) ajuda-o a lançar as bases para o desenvolvimento do produto.
Definiremos o que é isto, quando utilizaria um, e cinco passos para escrever um Documento SRS.
Num relance, isto é como escrever um documento de requisitos:
- Definir o objectivo do seu produto.
- Descreva o que está a construir.
- Detalhe os requisitos.
- Ponha-o aprovado.
O que é um documento de especificação de requisitos de software (SRS)?
Uma especificação de requisitos de software (SRS) é um documento que descreve o que o software irá fazer e como se espera que funcione. Também descreve a funcionalidade de que o produto necessita para satisfazer todas as necessidades dos interessados (empresas, utilizadores).
Um SRS típico inclui:
- Um objectivo
- Uma descrição geral
- Requisitos específicos
Os melhores documentos SRS definem como o software irá interagir quando incorporado no hardware – ou quando ligado a outro software. Os bons documentos SRS também são responsáveis por utilizadores da vida real.
Porquê Utilizar um Documento SRS?
Uma especificação de requisitos de software é a base de todo o seu projecto. Estabelece o quadro que cada equipa envolvida no desenvolvimento seguirá.
É utilizado para fornecer informação crítica a múltiplas equipas – desenvolvimento, garantia de qualidade, operações, e manutenção. Isto mantém todos na mesma página.
Utilizar o SRS ajuda a garantir o cumprimento dos requisitos. E também o pode ajudar a tomar decisões sobre o ciclo de vida do seu produto – por exemplo, quando reformar uma característica.
Escrever um SRS também pode minimizar o tempo e os custos globais de desenvolvimento. As equipas de desenvolvimento incorporadas beneficiam especialmente da utilização de um SRS.
Especificação de requisitos de software vs. Especificação de requisitos de sistema
Uma especificação de requisitos de software (SRS) inclui descrições profundas do software que será desenvolvido.
Uma especificação de requisitos de sistema (SyRS) recolhe informações sobre os requisitos de um sistema.
“Software” e “sistema” são por vezes utilizados de forma intercambiável como SRS. Mas, uma especificação de requisitos de software fornece mais pormenores do que uma especificação de requisitos de sistema.
>> Necessidade de provar a conformidade? Eis como criar uma matriz de rastreabilidade >>
Como escrever um documento SRS
Escrever um documento SRS é importante. Mas nem sempre é fácil de fazer.
Existem cinco passos que pode seguir para escrever um documento SRS eficaz.
Criar um Esboço (Ou Usar um Modelo SRS)
Seu primeiro passo é criar um esboço para a especificação dos seus requisitos de software. Isto pode ser algo que você mesmo crie. Ou pode usar um modelo SRS existente.
Se for você mesmo a criar isto, aqui está como pode ser o seu esboço:
1. Introdução
1.1 Objectivo
1.2 Público-alvo
1.3 Utilização prevista
1.4 Âmbito
1.5 Definições e acrónimos
2. Descrição geral
2.1 Necessidades do utilizador
2.2 Pressupostos e dependências
3. Características e Requisitos do Sistema
3.1 Requisitos Funcionais
3.2 Requisitos da Interface Externa
3.3 Características do Sistema
3.4 Requisitos Não Funcionais
Desde que tenha o seu esboço básico, está pronto para começar a preenchê-lo.
P>Download de um livro branco sobre as melhores práticas para requisitos de escrita >>
Inicie com um Objectivo
A introdução ao seu SRS é muito importante. Define a expectativa para o produto que está a construir.
Então, comece por definir o objectivo do seu produto.
P>Puplatividade pretendida e uso pretendido
Definir quem na sua organização terá acesso ao SRS – e como devem utilizá-lo. Isto pode incluir programadores, testadores, e gestores de projecto. Pode também incluir interessados noutros departamentos, incluindo equipas de liderança, vendas, e marketing.
Escopo do produto
Descreva o software que está a ser especificado. E incluir benefícios, objectivos, e metas. Isto deve estar relacionado com os objectivos comerciais globais, especialmente se as equipas fora do desenvolvimento tiverem acesso ao SRS.
Definições e Acrónimos
É inteligente incluir uma definição de risco. Evitar o risco é o topo de gama para muitos programadores – especialmente aqueles que trabalham em equipas de desenvolvimento críticas para a segurança.
Aqui está um exemplo. Se estiver a criar um dispositivo médico, o risco pode ser que o dispositivo falhe e cause uma fatalidade.
Ao definir esse risco à partida, é mais fácil determinar os requisitos específicos necessários para o mitigar.
>> Necessidade de criar um PRD? Aqui está um how-to com exemplos >>
Dê uma visão geral do que vai construir
O seu próximo passo é dar uma descrição do que vai construir. Trata-se de uma actualização de um produto existente? Trata-se de um produto novo? É uma adição a um produto que já criou?
Estes são importantes para descrever antecipadamente, para que todos saibam o que está a construir.
Você também deve descrever porque o está a construir e para quem é.
Necessidades do utilizador
As necessidades do utilizador – ou as classes e características do utilizador – são críticas. Terá de definir quem vai utilizar o produto e como.
Terá utilizadores primários e secundários que irão utilizar o produto regularmente. Poderá também ter de definir as necessidades de um comprador separado do produto (que poderá não ser um utilizador primário/secundário). E, por exemplo, se estiver a construir um dispositivo médico, terá de descrever as necessidades do paciente.
Premissas e Dependências
Pode haver factores que possam ter impacto na sua capacidade de cumprir os requisitos delineados no seu SRS. Quais são esses factores?
Existem algumas suposições que esteja a fazer com o SRS que possam revelar-se falsas? Deve incluir também as aqui.
Finalmente, deve notar se o seu projecto depende de quaisquer factores externos. Isto pode incluir componentes de software que está a reutilizar de outro projecto.
Detalhe os seus requisitos específicos
A secção seguinte é fundamental para a sua equipa de desenvolvimento. É aqui que detalha os requisitos específicos para a construção do seu produto.
Requisitos funcionais
Requisitos funcionais são essenciais para construir o seu produto.
Se estiver a desenvolver um dispositivo médico, estes requisitos podem incluir infusão e bateria. E dentro destes requisitos funcionais, pode ter um subconjunto de riscos e requisitos.
Requisitos da interface externa
Requisitos da interface externa são tipos de requisitos funcionais. São importantes para sistemas incorporados. E eles esboçam como o seu produto irá interagir com outros componentes.
Existem vários tipos de interfaces para as quais poderá ter requisitos, incluindo:
- Utilizador
- Hardware
- Software
- Comunicações
Características do sistema
Características do sistema são tipos de requisitos funcionais. Estas são características que são necessárias para que um sistema funcione.
Outros Requisitos Não Funcionais
Requisitos Não Funcionais podem ser tão importantes como os funcionais.
Estes incluem:
- Performance
- Segurança
- Segurança
- Qualidade
A importância deste tipo de requisitos pode variar dependendo da sua indústria. Os requisitos de segurança, por exemplo, serão críticos na indústria de dispositivos médicos.
IEEE também fornece orientações para a escrita de especificações de requisitos de software, se for um membro.
Abter aprovação para o SRS
Após ter completado o SRS, terá de obter a sua aprovação pelos principais interessados. E todos devem estar a rever a última versão do documento.
Escrever um SRS no Microsoft Word vs. Software de Requisito
P>Pode escrever a especificação dos seus requisitos de software no Microsoft Word. Uma forma inteligente de o fazer é criar um modelo SRS que pode utilizar como ponto de partida para cada projecto.
No entanto, mesmo com um modelo, escrever um SRS desta forma pode ser um processo meticuloso. E se um requisito mudar, o seu SRS pode ficar facilmente desactualizado. Além disso, pode haver problemas de versões com documentos de requisitos em Word.
Pode poupar tempo – e assegurar a precisão – escrevendo um SRS em vez disso em Helix ALM.
Porquê Helix ALM é Melhor…
Helix ALM (que vem com uma ferramenta de gestão de requisitos dedicada) acrescenta eficiência através de todo o seu processo de gestão de requisitos.
Ao criar um SRS em Helix ALM, assegurará uma única fonte de verdade no seu SRS. Será mais fácil fazer revisões de requisitos do seu SRS. E isso ajudá-lo-á a obter aprovações mais rápidas – para que os seus criadores possam começar.
Após ter requisitos num SRS, poderá facilmente geri-los ao longo de todo o seu processo de desenvolvimento.
Se também estiver a escrever um PRD, pode ligar esses requisitos de características com os requisitos de alto nível do SRS. Isto cria rastreabilidade ao longo de todo o processo de requisitos.
Também pode ligar os requisitos no seu SRS a testes. Isto ajudá-lo-á a assegurar que o produto que entrega cumpre o objectivo e requisitos do seu SRS.
Ver por si próprio como pode ser fácil escrever um SRS. Experimente o Helix ALM gratuitamente – e veja como um SRS eficaz irá melhorar o seu processo de desenvolvimento. Também pode ver a nossa demonstração para ver mais funcionalidade.
v>veja o tempo a escrever um SRS em Helix ALM ▶️ veja a demonstração Primeiro