Ao escrever requisitos, frequentemente surge a questão de até que nível vale a pena detalhar os requisitos e quais artefatos devem aparecer como resultado da análise do sistema.
Tento aderir à posição de que isso é puramente individual e depende da equipe e de quem se sente confortável para trabalhar. Acontece que o caso de uso é suficiente para que os desenvolvedores façam o design, e para os testadores basta escrever casos de teste. Portanto, vou escrever sobre os artefatos que podem surgir ao escrever requisitos e sobre os quais você precisa pensar exatamente no momento em que o desenvolvimento for concluído e você mesmo decidir e concordar com a equipe quando vale a pena descrevê-los. É inequívoco que, ao final do desenvolvimento, a documentação deve conter tudo o que será discutido posteriormente.
Se você não levar em consideração os pequenos recursos, cuja implementação envolve pequenas melhorias, você pode simplesmente fazer alterações nas descrições existentes. De forma sistemática, podemos distinguir dois tipos de tarefas que entram no trabalho de um analista de sistemas e precisam ser descritas de maneiras diferentes:
A tarefa de desenvolver um novo serviço ou nova funcionalidade que afeta apenas indiretamente outros sistemas ou componentes
Tarefas, a implementação das quais envolve melhorias em uma série de sistemas por processo (e, como você sabe, os sistemas são frequentemente segmentados por processo, e um recurso de negócios geralmente passa por todo o pipeline e requer melhorias em uma série de sistemas)
Para descrever as tarefas do primeiro tipo, identifiquei a seguinte estrutura e blocos de descrição:
Requerimentos gerais
Um bloco que assume a designação do contexto. Que tipo de sistema é, para que serve, que objetos contém, quais são seus limites.
- alvo
-
, ,
-
, , . , Confluenc , , , ,
-
, . , .
, , .
, , , . , , .
, , ,
, ( ), , .
(Use case)
, . . , UML-
UML. .
, , / . .
ER-.
, . , , , . . , , , .
, , ( ). .
-
, , \ . , , , ( ).
-
, swagger ( ), ( ), ftp .
.
:
, , , , , . ( ).
:
, . , .
(Use-case)
.
É mais fácil exibir as interações do sistema e os fluxos de dados para implementação. É necessário decompor todas as funcionalidades em sistemas em termos de dados, chamadas e gatilhos. indicam todos os relacionamentos e dependências de tarefas. Mais detalhes já ao nível de cada sistema separadamente.