Elos entre Desenvolvimento e Histórias de Usuário
Introdução
Este documento tem como objetivo apresentar os elos entre o desenvolvimento e as histórias de usuário, com o intuito de facilitar a compreensão e a execução das tarefas propostas. Os elos são uma forma de criar rastreabilidade entre as histórias de usuário e o desenvolvimento, garantindo que as tarefas propostas sejam executadas de forma correta e eficiente. Também é uma forma de garantir que as histórias de usuário sejam atendidas e que o desenvolvimento seja feito de acordo com as necessidades dos stakeholders.
A rastreabilidade é um conceito amplamente discutido na engenharia de software, sendo essencial para a gestão de requisitos e a garantia de qualidade do produto final. Segundo Sommerville (2011), a rastreabilidade permite que os desenvolvedores acompanhem a evolução dos requisitos ao longo do ciclo de vida do software, assegurando que todas as funcionalidades desejadas pelos stakeholders sejam implementadas corretamente.
Além disso, a utilização de histórias de usuário como forma de capturar requisitos é uma prática comum em metodologias ágeis, como o Scrum. De acordo com Cohn (2004), as histórias de usuário são descrições simples e concisas de funcionalidades do sistema, escritas na perspectiva do usuário final. Elas ajudam a manter o foco no valor entregue ao cliente e facilitam a comunicação entre os membros da equipe de desenvolvimento.
Metodologia
Para criar os elos entre o desenvolvimento e as histórias de usuário, é necessário seguir uma metodologia que permita identificar as relações entre as tarefas propostas e as necessidades dos stakeholders. A metodologia proposta é a seguinte:
-
Identificar as histórias de usuário: o primeiro passo é identificar as histórias de usuário que serão desenvolvidas. As histórias de usuário são descrições de funcionalidades que serão implementadas no sistema, de acordo com as necessidades dos stakeholders.
-
Identificar as tarefas de desenvolvimento: o segundo passo é identificar as tarefas de desenvolvimento que serão executadas
-
Criar os elos entre as histórias de usuário e as tarefas de desenvolvimento: o terceiro passo é criar os elos entre as histórias de usuário e as tarefas de desenvolvimento. Os elos podem ser criados de diversas formas, como por exemplo, uma tabela que relaciona as histórias de usuário com as tarefas de desenvolvimento.
As histórias de usuário do projeto além de seus critérios de aceitação e priorização foram elicitadas durante a entrega anterior, e podem ser encontradas nos seguintes documentos:
Em relação as tarefas, utilizaremos as issues de desenvolvimento criadas no repositório do projeto e no GitHub Projects para criar os elos com as histórias de usuário. As issues foram criadas identificando a história de usuário relacionada, as tarefas necessárias para a implementação da história e os critérios de aceitação da mesma. O quadro completo de issues pode ser encontrado aqui.
Além disso, iremos adicionar a rastreabilidade das branches e pull requests com as issues de desenvolvimento, garantindo que as tarefas propostas foram implementadas corretamente e que as histórias de usuário foram atendidas.
Template da tabela
Obs: Devem ser adicionados os links de rastreabilidade para as issues, pull requests e as histórias de usuário.
| História de Usuário | Issue de Desenvolvimento | Branch | Pull Request |
|---|---|---|---|
| USXX - Nome da História | Issue #XX - Título da issue | Nome da branch | PR #XX - Título do pull request |
Autores: Felipe Amorim de Araújo
Os responsáveis por preencher a tabela são os membros do time, que devem garantir que os elos entre as histórias de usuário e as tarefas de desenvolvimento sejam criados e mantidos atualizados. Esse processo será feito durante o desenvolvimento do projeto e as futuras entregas.
Elos entre Desenvolvimento e Histórias de Usuário
| História de Usuário | Issue de Desenvolvimento | Branch | Pull Request |
|---|---|---|---|
| US01 - CRUD da conta | Issue #12 - US01 - CRUD de Conta | 12-us01 | PR #28 - US01 e US02 - CRUD da Conta e Login |
| US02 - Login | Issue #13 - US02 - Login | 12-us01 | PR #28 - US01 e US02 - CRUD da Conta e Login |
| US03 - Sair da conta | Issue #14 - US03 - Sair da conta | 14-us03 | PR #30 - US03 - Sair da Conta |
| US04 - Recuperar senha | Issue #XX - | PR #XX - | |
| US05 - Editar informações do perfil | Issue #16 - US05 - Editar informações do perfil | 16-US05 | PR #XX - |
| US06 - Cadastrar endereço | Issue #17 - US06 - Cadastrar endereço | 17-us06 | PR #32 - US06 - Cadastrar endereço |
| US07 - Visualizar produtos | Issue #18 - US07 - Visualizar produtos (CRUD de Produto) | PR #XX - | |
| US08 - Visualizar recomendações | Issue #XX - | PR #XX - | |
| US09 - Buscar lojas e/ou produtos | Issue #19 - US09 - Buscar lojas/produtos (CRUD de lojas) | 19-us09 | PR #29 - US09 - Buscar lojas/produtos (CRUD de lojas) |
| US10 - Utilizar filtros de busca | Issue #XX - | PR #XX - | |
| US11 - Visualizar e adicionar itens aos favoritos | Issue #XX - | PR #XX - | |
| US12 - Adicionar e remover itens do carrinho | Issue #XX - | PR #XX - | |
| US13 - Visualizar carrinho | Issue #XX - | PR #XX - | |
| US14 - Personalizar itens do pedido | Issue #XX - | PR #XX - | |
| US15 - Adicionar observações ao pedido | Issue #XX - | PR #XX - | |
| US16 - Selecionar endereço de entrega | Issue #XX - | PR #XX - | |
| US17 - Escolher forma de pagamento na confirmação | Issue #XX - | PR #XX - | |
| US18 - Revisar e confirmar o pedido | Issue #XX - | PR #XX - | |
| US19 - Visualizar histórico de pedidos | Issue #XX - | PR #XX - | |
| US20 - Repetir um pedido anterior | Issue #XX - | PR #XX - | |
| US21 - Acompanhar status do pedido | Issue #XX - | PR #XX - | |
| US22 - Selecionar forma de pagamento | Issue #XX - | PR #XX - | |
| US23 - Salvar dados de pagamento | Issue #XX - | PR #XX - | |
| US24 - Segurança nos pagamentos | Issue #XX - | PR #XX - | |
| US25 - Rastreio do pedido | Issue #XX - | PR #XX - | |
| US26 - Retirada do pedido | Issue #XX - | PR #XX - | |
| US27 - Confirmar entrega do pedido | Issue #XX - | PR #XX - | |
| US28 - Escolher o tipo de entregador | Issue #XX - | PR #XX - | |
| US29 - Avaliar entregador | Issue #XX - | PR #XX - | |
| US30 - Avaliar pedido | Issue #XX - | PR #XX - | |
| US31 - Avaliar entrega | Issue #XX - | PR #XX - | |
| US32 - Personalizar cardápio | Issue #XX - | PR #XX - | |
| US33 - Personalizar aparência | Issue #XX - | PR #XX - | |
| US34 - Receber notificações de pedidos | Issue #XX - | PR #XX - | |
| US35 - Aceitar entregas de pedidos | Issue #XX - | PR #XX - | |
| US36 - Localizar lojas | Issue #XX - | PR #XX - | |
| US37 - Localizar Pedidos | Issue #XX - | PR #XX - |
Referências
- Sommerville, I. (2011). Software Engineering (9th Edition). Addison-Wesley.
- Cohn, M. (2004). User Stories Applied: For Agile Software Development. Addison-Wesley.
Histórico de Versões
| Versão | Data da alteração | Comentário | Autor(es) | Revisor(es) | Data de revisão |
|---|---|---|---|---|---|
| 1.0 | 27/12/2024 | Criação do documento e introdução | Felipe Amorim de Araújo | Guilherme Westphall | 06/01/2025 |
| 1.1 | 27/12/2024 | Adicionando metodologia e template | Felipe Amorim de Araújo | Guilherme Westphall | 06/01/2025 |
| 1.2 | 27/12/2024 | Adicionando tabela | Felipe Amorim de Araújo | Guilherme Westphall | 06/01/2025 |
| 1.3 | 02/01/2024 | Adicionando pull request das US01 e US02 | Felipe Amorim de Araújo | Guilherme Westphall | 06/01/2025 |
| 1.4 | 05/01/2024 | Adicionando pull request e branches das US03 e US09 | Felipe Amorim de Araújo, Raquel Ferreira Andrade | Guilherme Westphall | 06/01/2025 |