Post: Galleria de imagens geradas por IA
...
Escrevendo histórias de usuários
Criado em Março de 2023 por Maxwell Anderson
Prompt: create an image of a software engineer cat that is performing automated tests
Histórias de usuários em TDD são histórias que são escritas de forma a serem testadas. A ideia é que os testes sejam escritos de forma a falhar, e então o código é escrito de forma a fazer os testes passarem.
Antes de criar as histórias de usuários, é necessário entender o que é um usuário. Um usuário é uma pessoa que utiliza o sistema. Um usuário pode ser um cliente, um funcionário, um fornecedor, etc. Um usuário pode ter diferentes perfis, e cada perfil pode ter diferentes permissões. Por exemplo, um usuário pode ser um cliente, e ter permissão para criar uma garantia, mas não pode ter permissão para criar um produto. Um usuário pode ser um funcionário, e ter permissão para criar um produto, mas não pode ter permissão para criar uma garantia.
Vamos utilizar o projeto que se encontra em https://github.com/maxwellamaral/garantias-mono-dj como exemplo, partindo das modificações a serem realizadas na branch aula01.
Antes de escrevermos a primeira história de usuário é necessário entender os requisitos que se encontram no Documento de Requisitos validado junto ao cliente. Digamos que a RF001 foi a primeira a ser priorizada pelo cliente, e que o cliente deseja que seja implementada o mais rápido possível. A RF001 é a seguinte:
RF001 - Como um cliente, eu gostaria de poder controlar os produtos que eu compro e controlar as garantias, para que eu possa saber quando o produto estará fora de garantia. Os produtos devem ser cadastrados com os seguintes dados: nome do produto, data de compra, data de vencimento da garantia, segmento do produto, marca e modelo do produto, local de compra, valor pago pelo produto, valor da garantia e modo de compra (online ou físico).
Analisando o requisito funcional acima, podemos obter uma visão baseada em casos de uso. O objetivo é visualizar a interação do ator com o sistema através de uma funcionadidade. Eu acho interessante, em um primeiro momento, visualizar essa interação com o uso de um diagrama de casos de uso. Pode ser simplório, no início, mas com o passar do tempo, teremos uma visão geral de todo o sistema, de acordo com o escopo inicial selecionado em um backlog. O diagrama de casos de uso pode ser visto abaixo:
Entendeu a necessidade do cliente? Vamos escrever a primeira história de usuário que seja testável por um humano. Vamos escrevê-la usando comentários em Python. Vamos chamar o cliente de Max.
Crie uma pasta chamada funcional_tests na raiz do projeto. Crie os arquivos conforme ilustrado abaixo:
📦functional_tests
┣ 📜__init__.py
┗ 📜tests.py
No arquivo tests.py, crie a primeira história de usuário. Ela será a seguinte:
# Max acessa a página de cadastro de produtos.
# Ele verifica que o título da página na aba do navegador e
# na própria página é "Cadastro de produtos".
# Ele verifica que existe um campo para o nome do produto,
# data de compra, data de vencimento da garantia, segmento do produto,
# marca e modelo do produto, local de compra, valor pago pelo produto,
# valor da garantia e modo de compra (online ou físico).
# Ele verifica que existe um botão para cadastrar o produto.
# Ele preenche os campos com os dados do produto que ele deseja cadastrar e
# clica no botão para cadastrar o produto.
# Ele verifica que a página de cadastro de produtos é exibida novamente,
# e que existe uma mensagem informando que o produto foi
# cadastrado com sucesso.
# Satisfeito, Max selecoina 'Listar produtos' no menu. O sistema exibe uma a lista de produtos cadastrados.
# Ele verifica que o produto cadastrado está na lista.
# Verificando melhor, Max percebe que o produto cadastrado não está com o nome correto. Assim, ele seleciona o produto na lista e clica no botão para editar o produto.
# Ele verifica que a página de edição de produtos é exibida novamente, e que os campos estão preenchidos com os dados do produto.
# Ele altera o nome do produto e clica no botão para salvar os dados relacionados ao produto.
# Satisfeito, Max seleciona 'Listar produtos' no menu. O sistema exibe uma a lista de produtos cadastrados.
# Ele verifica que o produto cadastrado está na lista.
# Max necessita realizar uma busca por produtos na lista. Ele seleciona o campo específico para busca e digita o nome do produto.
# Ao selecionar 'Buscar', o sistema exibe todos os produtos que correspondem aos termos que foram digitados.
# Após um certo tempo, Max decide excluir o produto. ELe visualiza o produto e seleciona a opção 'Excluir'. O sistema pergunta se o usuário realmente deseja excluir o produto.
# Max seleciona 'Sim'. O sistema realiza a exclusão do produto e volta a exibir uma lista atualizada dos produtos.
# Satisfeito, Max realiza logoff do sistema e vai fazer café.