Histórias de Usuário
Introdução
As histórias de usuário representam o alicerce das metodologias de desenvolvimento ágil e desempenham um papel central na definição de requisitos. Em linhas gerais, as histórias de usuário consistem em descrições concisas e diretas das funcionalidades desejadas, vistas a partir da perspectiva do cliente. Além disso, cada história de usuário deve ser acompanhada por critérios de aceitação minuciosamente delineados, que servem como critérios sólidos para avaliar com precisão o sucesso da implementação. Vamos explorar mais a fundo a vital importância das histórias de usuário no contexto deste aplicativo dedicado à Economia-DF.
Objetivo
O objetivo das histórias de usuário no aplicativo Economia-DF é definir e comunicar as necessidades dos usuários de maneira clara e direta. Elas são essenciais para priorizar funcionalidades, manter o foco no valor para o usuário, facilitar a comunicação da equipe de desenvolvimento e estabelecer critérios para determinar quando uma funcionalidade está completa. Em resumo, as histórias de usuário são a base para garantir que o aplicativo atenda às expectativas dos usuários e forneça funcionalidades valiosas e relevantes.
Metodologia
A princípio, durante o projeto foram elicitados os requisitos do aplicativo através de tecnicas como:
Posteriormente, foi efetuado a priorização dos requisitos elicitados com as tecnicas de:
Dessa forma, as funcionalidades foram documentadas de maneira ágil e padronizada, alinhadas com as especificações definidas no Backlog. Por fim, realizou-se uma validação do documento em uma reunião com o representante do cliente no projeto, assegurando a conformidade com as necessidades do usuário.
Participantes
Para a criação do artefacto, foi efetuado uma reunião com os membros disponíveis na tabela 1.
Tabela 1: Participantes da reunião de histórias do usuário.
| Nome | Cargo |
|---|---|
| Lucas Víctor | Desenvolvedor |
| Lucas Oliveira | Desenvolvedor |
| Wallace Oliveira | PO |
Fonte: Lucas Victor, 2023.
Padrão de História de Usuário
Ao escrever as histórias de usuário para este projeto, é crucial seguir as diretrizes especificadas neste documento. Para modelar as histórias de usuário de forma consistente, devemos incluir as seguintes informações:
-
ID: Este é o identificador único das histórias de usuário. Os IDs estão presentes nos títulos das histórias, que foram organizadas em toggles.
-
História de Usuário: Cada história de usuário deve seguir a estrutura "Eu, como [usuário], desejo [realizar algo] para que [alcance algum objetivo]".
-
Tema: É importante indicar a qual tema ou categoria a história de usuário está relacionada, proporcionando um contexto mais amplo.
-
Critérios de Aceitação: Aqui, devemos listar um conjunto de atributos ou condições que uma funcionalidade deve atender para ser considerada "aceita" ou concluída com sucesso.
-
Prioridade: A prioridade ajuda a determinar o nível de importância da história de usuário no projeto. Pode ser classificada como alta, média ou baixa, levando em consideração fatores como o valor para o usuário, facilidade de implementação, dependências técnicas e restrições de prazo.
-
Dificuldade de Implementação (DI): Essa métrica está relacionada à dificuldade de implementar a funcionalidade e pode ser categorizada como baixa, média ou alta.
Exemplo de tabela:
Na tabela 2 é possível ver um exemplo da tabela para as histórias de usuário.
HS0X - [Nome da história]
Tabela 2: Exemplo de tabela de História de Usuário
| História de Usuário | Tema | Critérios de Aceitação | Prioridade | (DI) |
|---|---|---|---|---|
| Eu, como [usuário], desejo [realizar algo] para que [alcance algum objetivo] | [Tema] | - [Critério 1] | Alta | Baixa |
| Eu, como [usuário], desejo [realizar algo] para que [alcance algum objetivo] | [Tema] | - [Critério 1] | Média | Média |
| Eu, como [usuário], desejo [realizar algo] para que [alcance algum objetivo] | [Tema] | - [Critério 1] | Baixa | Alta |
Fonte: Lucas Victor, 2023.
Seguir este padrão ao criar as histórias de usuário garantirá uma documentação clara e consistente, facilitando o entendimento e a execução eficiente das tarefas do projeto.
História de Usuário
Em seguida, iniciando na tabela 3 e indo até a tabela 19, temos as histórias do usuário detalhadas.
HS01 - Efetuar login com email e senha
Tabela 3: História de Usuário 1
| História de Usuário | Tema | Critérios de aceitação | Prioridade | DI |
|---|---|---|---|---|
| Eu quero fazer login seguro no aplicativo com meu e-mail e senha para usar todas as funcionalidades com proteção dos meus dados pessoais. | Login | - O sistema deve verificar se o email e a senha informados pelo usuário são válidos e correspondem a um usuário cadastrado. - Caso contrário, deve exibir uma mensagem de erro e solicitar que o usuário tente novamente. | Alta | Baixa |
Fonte Lucas Víctor e Lucas Oliveira, 2023.
HS02 HS02 - Efetuar login com gov.br
Tabela 4: História de Usuário 2
| História de Usuário | Tema | Critérios de aceitação | Prioridade | DI |
|---|---|---|---|---|
| Eu, como usuário, desejo entrar no aplicativo usando minha integração gov.br para acessar todas as funcionalidades de forma conveniente. | Login | - O sistema deve permitir que o usuário realize o login no aplicativo através da integração com o gov.br. - O sistema deve redirecionar o usuário para a tela do gov.br, onde ele poderá escolher uma das opções de identificação disponíveis, como CPF, certificado digital, QR code ou login com banco. | Média | Média |
Fonte: Lucas Víctor e Lucas Oliveira, 2023.
HS03 HS03 - Recuperar senha
Tabela 5: História de Usuário 3
| História de Usuário | Tema | Critérios de aceitação | Prioridade | DI |
|---|---|---|---|---|
| Eu, como usuário, desejo ter a capacidade de recuperar minha senha de acesso no aplicativo no caso de perda. | Login | - O sistema deve oferecer uma opção para o usuário recuperar sua senha caso ele a tenha esquecido. - Ao clicar nessa opção, o usuário deve ser levado para uma tela onde ele poderá informar seu email e receber um link para redefinir sua senha. | Alta | Baixa |
Fonte: Lucas Víctor e Lucas Oliveira, 2023.
HS04 - Efetuar logout
Tabela 6: História de Usuário 3
| História de Usuário | Tema | Critérios de aceitação | Prioridade | DI |
|---|---|---|---|---|
| Eu, como usuário, desejo realizar logout no aplicativo após o uso, garantindo a segurança da minha conta e a privacidade das minhas informações. | Login | O sistema deve permitir que o usuário faça logout do aplicativo a qualquer momento, encerrando sua sessão e retornando para a tela de login. | Alta | Baixa |
Fonte: Lucas Víctor e Lucas Oliveira, 2023.
HS05 - Listar
Tabela 7: História de Usuário 5
| História de Usuário | Tema | Critérios de aceitação | Prioridade | DI |
|---|---|---|---|---|
| Eu, como usuário, desejo listar informações sobre notas fiscais no aplicativo, permitindo que eu confira e acompanhe minhas compras. | Nota Fiscal | - Ver uma lista de notas fiscais ordenadas por data de emissão com informações essenciais. - Visualizar detalhes de uma nota fiscal, incluindo produtos, impostos e opção de baixar o XML/PDF. - Filtrar notas fiscais por período, valor, fornecedor ou status. - Sincronizar notas fiscais com o portal da NF-e e alertar sobre inconsistências. | Alta | Alta |
HS06 - Pesquisar
Tabela 8: História de Usuário 6
| História de Usuário | Tema | Critérios de aceitação | Prioridade | DI |
|---|---|---|---|---|
| Eu, como usuário, desejo pesquisar informações sobre notas fiscais no aplicativo, proporcionando-me a capacidade de conferir e rastrear minhas compras de forma eficaz e personalizada. | Nota Fiscal | - O sistema deve permitir que o usuário digite uma palavra-chave relacionada às notas fiscais que deseja pesquisar, como o nome do fornecedor, o produto ou serviço adquirido, o valor, a data, etc. - O sistema deve retornar uma lista de notas fiscais que contenham a palavra-chave informada, ordenadas por relevância ou similaridade. | Alta | Alta |
HS07 - Visualizar detalhes
Tabela 9: História de Usuário 7
| História de Usuário | Tema | Critérios de aceitação | Prioridade | DI |
|---|---|---|---|---|
| Eu, como usuário, desejo visualizar detalhes completos sobre as notas fiscais no aplicativo, permitindo-me uma conferência minuciosa de minhas compras e facilitando o acompanhamento de todas as informações relevantes. | Nota Fiscal | - Ver detalhes completos de uma nota fiscal selecionada, com a opção de baixar o XML ou PDF. - Verificar a autenticidade da nota fiscal comparando com o portal da NF-e e alertar sobre inconsistências. - Compartilhar a nota fiscal via e-mail, WhatsApp, Telegram, etc., escolhendo o formato de compartilhamento, X(ML, PDF ou imagem). Avaliar a nota fiscal com 1 a 5 estrelas e comentário opcional, mostrando a média e o número de avaliações. | Alta | Média |
HS08 - Imprimir DANFE
Tabela 10: História de Usuário 8
| História de Usuário | Tema | Critérios de aceitação | Prioridade | DI |
|---|---|---|---|---|
| Eu, como usuário, desejo ter a opção de imprimir o DANFE, (Documento Auxiliar da Nota Fiscal Eletrônica) das notas fiscais no aplicativo. | Nota Fiscal | - Imprimir o DANFE das notas fiscais em formato PDF. - Visualizar o DANFE antes de imprimir, com código de barras e QR code. - Escolher notas fiscais para impressão e cancelar a operação, se necessário. | Média | Média |
US09 - Cadastrar
Tabela 11: História de Usuário 9
| História de Usuário | Tema | Critérios de aceitação | Prioridade | DI |
|---|---|---|---|---|
| Eu, como usuário, desejo cadastrar informações sobre meu(s) veículo(s) no aplicativo, permitindo-me verificar se há quaisquer débitos associados. | Débitos | - Cadastrar veículos com dados obrigatórios, validando a propriedade. - Ver uma lista de veículos cadastrados e acessar as funcionalidades de um veículo selecionado. - Editar informações de um veículo com confirmação. - Excluir um veículo com confirmação, exibindo mensagens de sucesso ou erro. | Alta | Baixa |
HS10 - Consultar débitos de IPVA
Tabela 12: História de Usuário 10
| História de Usuário | Tema | Critérios de aceitação | Prioridade | DI |
|---|---|---|---|---|
| Eu, como usuário, desejo consultar os débitos de IPVA associados ao(s) meu(s) veículo(s) no aplicativo, a fim de verificar a existência de quaisquer pendências financeiras. | Débitos | Consultar e visualizar os débitos de IPVA dos seus veículos. - Exporta, compartilhar e imprimir documento de débito. Receber notificações sobre débitos novos. | Alta | Baixa |
HS11 - Emitir DAR
Tabela 13: História de Usuário 11
| História de Usuário | Tema | Critérios de aceitação | Prioridade | DI |
|---|---|---|---|---|
| Eu, como usuário, desejo a capacidade de emitir o Documento de Arrecadação de Receitas, (DAR) no aplicativo para meu(s) veículos, ou imóveis, ou dívidas Ativa, ou outros tributos, ou parcelamentos administrativos permitindo-me identificar e quitar possíveis débitos associados. | Débitos | - Emitir o DAR para todos os seus débitos, como IPVA, IPTU, seguro DPVAT e multas, etc. - Consultar débitos, incluindo valor, data de vencimento, código de barras e status, pago, atrasado, parcelado. | Alta | Baixa |
HS12 - Cadastrar
Tabela 14: História de Usuário 12
| História de Usuário | Tema | Critérios de aceitação | Prioridade | DI |
|---|---|---|---|---|
| Eu, como usuário, desejo cadastrar informações sobre meu(s) imóvel(eis) no aplicativo, a fim de verificar a existência de possíveis débitos e, assim, facilitar o acompanhamento e a gestão eficaz da situação dos meus imóveis. | Débitos | - O usuário deve conseguir cadastrar informações sobre seus imóveis no aplicativo. - O aplicativo deve validar e armazenar com segurança as informações cadastradas. - O usuário deve poder visualizar e editar os dados de seus imóveis a qualquer momento. - Após o cadastro bem-sucedido, o usuário receberá uma confirmação. | Alta | Baixa |
HS13 - Consultar débitos de IPTU/TLP
Tabela 16: História de Usuário 13
| História de Usuário | Tema | Critérios de aceitação | Prioridade | DI |
|---|---|---|---|---|
| Eu, como usuário, desejo consultar os débitos de IPTU/TLP relacionados ao(s) meu(s) imóvel(eis) no aplicativo, com o objetivo de identificar possíveis pendências financeiras. | Débitos | - Consultar facilmente débitos de IPTU/TLP. - Visualizar detalhes dos débitos, incluindo valores, datas de vencimento e descrições. </br - Diferenciar débitos em aberto de vencidos. - Oferecer a opção de imprimir ou gerar um relatório dos débitos. - Garantir a segurança das informações pessoais durante a consulta de débitos. | Alta | Baixa |
HS14 - Consultar débitos inscritos
Tabela 17: História de Usuário 14
| História de Usuário | Tema | Critérios de aceitação | Prioridade | DI |
|---|---|---|---|---|
| Eu, como usuário, desejo consultar os débitos inscritos na dívida ativa, ou em outros tributos, ou em parcelamentos administrativos, no aplicativo, para verificar a existência de pendências financeiras, proporcionando-me uma visão clara da situação dos débitos pendentes. | Débitos | - Encontrar facilmente a opção de consulta de débitos inscritos. - Exibir claramente os débitos inscritos, incluindo valores e datas de vencimento. - Facilitar a identificação visual dos débitos em aberto e vencidos. - Garantir a segurança das informações pessoais do usuário durante a consulta de débitos. | Média | Baixa |
HS15 - Enviar email
Tabela 18: História de Usuário 15
| História de Usuário | Tema | Critérios de aceitação | Prioridade | DI |
|---|---|---|---|---|
| Eu, como usuário, desejo ter a opção de entrar em contato com a Secretaria de Economia do Distrito Federal por meio do aplicativo para estabelecer comunicação eficaz e obter assistência ou informações necessárias. | Contato | - O usuário deve encontrar facilmente a opção de enviar um email para a Secretaria de Economia do Distrito Federal no aplicativo. - O aplicativo deve permitir ao usuário enviar o email de forma simples. - O usuário deve receber uma confirmação após o envio bem-sucedido do email. - A comunicação via email deve ser segura. | Média | Baixa |
HS16 - Visualizar informações sobre o aplicativo
Tabela 19: História de Usuário 16
| História de Usuário | Tema | Critérios de aceitação | Prioridade | DI |
|---|---|---|---|---|
| Eu, como usuário, desejo acessar informações detalhadas sobre o aplicativo para aprender a utilizá-lo de forma eficaz e aproveitar ao máximo suas funcionalidades. | Contato | - As informações detalhadas sobre o aplicativo devem ser facilmente encontradas no menu ou tela inicial. - O aplicativo deve oferecer guias claros sobre como usar suas funcionalidades. - Os usuários devem poder entrar em contato com o suporte, se necessário. - A navegação e busca de informações devem ser simples. | Baixa | Baixa |
Validação das histórias de usuário
Para validar as histórias de usuário, conduzimos uma entrevista com o nosso representante-chave disponível para consulta neste link. A reunião foi realizada através da plataforma Teams no dia 03 de novembro de 2023, às 21:00 hrs. Após a entrevista, procedemos com as modificações necessárias para garantir que as histórias estejam alinhadas com as expectativas e necessidades do usuário.
No vídeo 1 encontra-se a gravação da entrevista.
Vídeo 1: Requisitos - Reunião 05
Fonte: Lucas Víctor, 2023
Bibliografia
[1] 2023.1-Simplenote, User_story. Disponível em: https://github.com/Requisitos-de-Software/2023.1-Simplenote/blob/main/docs/modelagem/agil/User_story.md#hist%C3%B3rias-de-usu%C3%A1rio.
[2] DIOGO. Guia definitivo para Histórias de Usuário - Product Management. YouTube, 11 jul. 2022. Disponível em: https://www.youtube.com/watch?v=pLJ3LxR292w.
| Versão | Data | Descrição | Autor(es) | Revisor(es) |
|---|---|---|---|---|
1.0 |
03/11/2023 | Criação do documento | Lucas Víctor | Gabriel Rosa |
1.1 |
03/11/2023 | Adição introdução, objetivo, metodologia, padrão de história de usuário | Lucas Víctor | Gabriel Rosa |
1.2 |
03/11/2023 | Adição das estruturas de história de usuário | Lucas Víctor | Gabriel Rosa |
1.3 |
03/11/2023 | Adição das Validação das histórias de usuário | Lucas Víctor | Gabriel Rosa |
1.4 |
03/11/2023 | Adição dos titulos e dos temas da Historia do usuário | Lucas de Oliveira | Gabriel Rosa |
1.5 |
03/11/2023 | Adição das Histórias de usuários | Lucas de Oliveira | Gabriel Rosa |
1.6 |
03/11/2023 | Adição dos criterios de aceitação do 1 ao 11 | Lucas de Oliveira | Gabriel Rosa |
1.7 |
03/11/2023 | Adição dos criterios de aceitação do 12 ao 22 | Lucas Víctor | Gabriel Rosa |
1.8 |
03/11/2023 | Adição das prioridades | Lucas de Oliveira | Gabriel Rosa |
1.9 |
03/11/2023 | Adição das correções com o PO | Lucas de Oliveira | Gabriel Rosa |
2.0 |
04/11/2023 | Conserto de todas as tabelas | Lucas Víctor | Gabriel Rosa |
2.1 |
04/11/2023 | Adição de vídeo | Lucas Víctor | Gabriel Rosa |
2.2 |
05/11/2023 | Adição das dificuldades de implementação "DI" | Lucas de Oliveira | Gabriel Rosa |
2.3 |
05/11/2023 | Atualização de tabela | Lucas Víctor | Gabriel Rosa |