Histórias de Usuário
Introdução
De acordo PRESSMAN e MAXIM(2016)1, uma história de usuário é descrita como um elemento que descreve os resultados, características e funcionalidades que os usuários finais esperam do software a ser desenvolvido.
Em seu livro, PRESSMAN e MAXIM(2016)1 também definem que a elaboração de uma história do usuário envolve o ato de escutar relatos do cliente que detalham as funcionalidades, características e resultados esperados do software. O cliente, por sua vez, atribui um valor de prioridade a cada história, baseando-se na importância relativa da funcionalidade para o negócio. Posteriormente, os membros da equipe avaliam cada história e determinam o custo associado, expresso em semanas de desenvolvimento, proporcionando uma base para a alocação de recursos e planejamento.
Objetivo
O objetivo do artefato de histórias de usuário é detalhar de maneira clara e compreensível as funcionalidades, características e resultados esperados pelos usuários finais do software, facilitando a priorização, planejamento e desenvolvimento das funcionalidades com base no valor de negócio atribuído pelo cliente.1
Metodologia
A Tabela 1 a seguir apresenta um template para a elaboração de histórias de usuário dentro do projeto. A tabela é dividida em quatro colunas principais: ID, Título, Descrição e Critérios de Aceitação. Facilitando a organização e a referência cruzada das informações.
Tabela 1 - Template de tabela para histórias de usuário.
| ID | Título | Descrição | Critérios de Aceitação |
|---|---|---|---|
| USXX | Título da História de Usuário | Eu, como um_ [tipo usuário], gostaria que [compromisso com as tarefas], afim de que [objetivo a ser alcançado]. |
1 - "Critério nº1" 2 - "Critério nº2" ... |
Fonte: Diego Sousa e João Artur.
Histórias de Usuário
A Tabela 2 a seguir apresenta um resumo detalhado das histórias de usuário desenvolvidas para o projeto, focando nos elementos que foram descritos no template da Tabela 1. As histórias de usuário foram criadas com base nos requisitos elicitados pelo Product Owner (PO).
Todas as histórias foram aceitas pelo PO durante a reunião de validação das histórias de usuário.
Tabela 2 - Histórias de Usuários e seus elementos.
| ID | Título | Descrição | Critérios de Aceitação |
|---|---|---|---|
| US01 | Ajuste Automático da Data de Término | Eu, como usuário, gostaria que o sistema ajuste automaticamente a data de término para a data atual quando eu inserir apenas a data de início no filtro de pesquisas de diários, afim de que eu possa visualizar todos os documentos relevantes até a data de hoje sem precisar inserir manualmente a data de término | 1 - Caso apenas a data de início seja inserida pelo usuário, o sistema deve automaticamente ajustar a data de término para a data atual e assim, garantir que a mesma esteja sempre atualizada no dia atual. 2 - O sistema deve garantir que o filtro aplicado retornará corretamente os diários publicados daquele período determinado. |
| US02 | Limitação de Diários por Página | Eu, como usuário, gostaria que o sistema tivesse uma limitação de diários exibidos no resultado de pesquisa por página, afim de que eu possa navegar pelos resultados de forma mais intuitiva e organizada, evitando a sobrecarga visual causada pela atualização constante ao rolar a página. | 1 - O resultado de pesquisas deve ser separado por páginas. 2 - A limitação de exibição dos diários deve ser de 30 diários por página. 3 - O resultado de busca deve garantir que todos os diários que se enquadram na aplicação do filtro, ou sem filtros também, sejam exibidos, limitados nas páginas corretamente. |
| US03 | Paginação na Guia Meu Diário | Eu, como usuário, gostaria que o sistema tivesse uma limitação de diários exibidos na guia Meu Diário por página, afim de que eu possa navegar pelos resultados de forma mais intuitiva e organizada, evitando a sobrecarga visual causada pela atualização constante ao rolar a página. | 1 - A guia Meu Diário deve ser separado por páginas. 2 - A limitação de exibição dos diários deve ser de 30 diários por página. 3 - O resultado de busca deve garantir que todos os diários que se enquadram na aplicação do filtro, ou sem filtros também, sejam exibidos, limitados nas páginas corretamente. 4 - A guia deve mostrar a exibição dos números de diários encontrados por página, com o texto centralizado e padronizado como nas outras guias, no seguinte formato: [numero] resultados encontrados. |
| US04 | Filtragem de Data em Meu Diário | Eu, como usuário,gostaria que o sistema tivesse uma configuração por limitação de datas, na guia Meu Diário, afim de que eu possa filtras meus resultados nessa página por diferentes períodos. | 1 - O sistema deve garantir que só apareça como opção, datas válidas. 2 - O sistema deve permitir que o usuário escolha datas de início e término, mas não deve exigir que ambas sejam preenchidas obrigatoriamente. 3 - Caso apenas a data de início seja inserida pelo usuário, o sistema deve automaticamente ajustar a data de término para a data atual e assim, garantir que a mesma esteja sempre atualizada no dia atual. |
| US05 | Busca por Palavras-chave | Eu, como usuário, gostaria que o aplicativo do Diário Oficial da União tivesse uma funcionalidade de busca por palavras-chave, para que eu possa rapidamente encontrar menções a regulamentações específicas sem ter que ler manualmente várias edições. | 1 - A funcionalidade de busca deve permitir a entrada de uma ou mais palavras-chave. 2 - Os resultados da busca devem destacar as palavras-chave encontradas nas publicações. 3 - Deve ser possível filtrar os resultados da busca por data ou intervalo de datas. |
| US06 | Suporte Multilíngue | Eu, como usuário, gostaria que o aplicativo do Diário Oficial da União oferecesse suporte multilíngue com traduções para o inglês, para que eu possa entender melhor as legislações e regulamentos sem depender de ferramentas de tradução externas, garantindo a precisão e eficiência de minha pesquisa. | 1 - O aplicativo deve oferecer uma opção para selecionar o idioma de exibição. 2 - As traduções devem abranger todo o conteúdo publicado, incluindo legislações e regulamentos. 3 - As traduções devem manter a precisão técnica e jurídica do conteúdo original em português. 4 - A funcionalidade de tradução deve ser integrada dentro do aplicativo, evitando a necessidade de usar ferramentas de tradução externas. 5 - A interface de usuário deve ser intuitiva, permitindo fácil alternância entre idiomas. |
| US07 | Filtros Temáticos e Geográficos | Eu, como usuário, gostaria que o aplicativo do Diário Oficial da União incluísse filtros temáticos e de impacto geográfico avançados, para que eu possa encontrar rapidamente informações específicas em áreas de interesse, melhorando assim a eficiência e a precisão de pesquisa. | 1 - O aplicativo deve oferecer filtros temáticos detalhados. 2 - Os filtros de impacto geográfico devem permitir a seleção entre opções como Nacional, Regional e Estadual. 3 - O sistema de busca deve permitir combinar múltiplos filtros para refinar os resultados de pesquisa. 4 - Os resultados filtrados devem incluir apenas as publicações que correspondem exatamente aos critérios especificados pelo usuário. |
| US08 | Onboarding Personalizado | Eu, como usuário do aplicativo Diário Oficial da União, gostaria de uma funcionalidade de onboarding que me faça perguntas sobre minhas preferências de conteúdo, para que eu possa configurar a seção Meu Diário de maneira fácil e personalizada, sem precisar acessar manualmente as configurações detalhadas. | 1 - Interface de Onboarding: Ao primeiro acesso após o login, o usuário deve ser apresentado a uma série de perguntas interativas sobre seus interesses e preferências de conteúdo. 2 - Personalização Automática: Com base nas respostas fornecidas, o sistema deve automaticamente configurar a seção 'Meu Diário' para destacar conteúdos e categorias relevantes para o usuário. 3 - Perguntas Relevante: As perguntas devem incluir opções sobre tipos de publicações, áreas de interesse específicas (como economia, política, direito, etc.), e frequência de notificações desejadas. 4 - Opção de Reconfiguração: O usuário deve ter a opção de revisitar e modificar suas respostas ao onboarding a qualquer momento através de um acesso simples no menu de configurações. |
| US09 | Notificações Personalizadas | Eu, como usuário, gostaria de receber notificações personalizadas sobre novas publicações que atendam aos meus critérios de interesse, para que eu possa me manter atualizado sem precisar verificar manualmente o aplicativo todos os dias. | 1 - O sistema deve permitir que o usuário configure notificações personalizadas com base em palavras-chave, datas e filtros temáticos. 2 - As notificações devem ser enviadas por push notification e e-mail, conforme preferência do usuário. 3 - O usuário deve poder ajustar a frequência das notificações (diária, semanal, etc.). 4 - O sistema deve garantir que as notificações só sejam enviadas para publicações relevantes conforme os critérios definidos pelo usuário. |
| US10 | Funcionalidade de Histórico de Pesquisa | Eu, como usuário, gostaria que o aplicativo tivesse uma funcionalidade de histórico de pesquisa, para que eu possa acessar rapidamente pesquisas anteriores e reutilizá-las sem precisar inserir novamente os mesmos critérios. | 1 - O sistema deve armazenar automaticamente as pesquisas realizadas pelo usuário, incluindo palavras-chave e filtros aplicados. 2 - O usuário deve poder acessar uma lista de pesquisas recentes e favoritas através de uma interface intuitiva. 3 - O usuário deve ter a opção de excluir ou salvar permanentemente pesquisas específicas como favoritas. 4 - O sistema deve garantir que as pesquisas armazenadas sejam acessíveis em todos os dispositivos conectados à mesma conta de usuário. |
| US11 | Funcionalidade de Compartilhamento Aprimorada | Eu, como usuário, gostaria que o aplicativo tivesse uma funcionalidade de compartilhamento aprimorada para publicações, para que eu possa distribuir documentos importantes de maneira prática e eficiente. | 1 - O sistema deve permitir o compartilhamento de publicações diretamente via e-mail, redes sociais e outras plataformas de comunicação. 2 - As publicações compartilhadas devem manter a formatação original e incluir metadados importantes (data, título, etc.). 3 - O usuário deve poder selecionar partes específicas do documento para compartilhar, se desejado. 4 - O sistema deve garantir que as opções de compartilhamento sejam acessíveis em todas as seções relevantes do aplicativo. |
| US12 | Comentários e Anotações em Publicações | Eu, como usuário, gostaria que o aplicativo tivesse uma funcionalidade de comentários e anotações em publicações, para que eu possa adicionar minhas observações pessoais e discutir tópicos específicos com outros usuários. | 1 - O sistema deve permitir que os usuários adicionem comentários e anotações em qualquer publicação. 2 - Os comentários e anotações devem ser privados por padrão, mas o usuário deve poder compartilhá-los com contatos específicos ou grupos de interesse. 3 - O sistema deve notificar o usuário sobre respostas ou interações relacionadas às suas anotações. 4 - O sistema deve garantir que os comentários e anotações sejam sincronizados entre todos os dispositivos conectados à mesma conta de usuário. |
| US13 | Autenticação Multifatorial | Eu, como usuário, gostaria que o aplicativo implementasse uma autenticação multifatorial, a fim de garantir uma camada adicional de segurança para o meu acesso ao sistema. | 1 - O sistema deve permitir a configuração de autenticação multifatorial durante o processo de login. 2 - Deve ser compatível com aplicativos de autenticação como Google Authenticator e Authy. 3 - O usuário deve ser capaz de recuperar acesso em caso de perda do dispositivo de autenticação através de um email secundário ou número de telefone. |
| US14 | Acessibilidade para Usuários com Deficiência Visual | Eu, como usuário com deficiência visual, gostaria que o sistema tivesse opções de alto contraste e leitura de texto em voz alta, para que eu possa navegar no sistema com mais autonomia. | 1 - O sistema deve oferecer um modo de alto contraste que possa ser facilmente ativado nas configurações. 2 - Deve haver uma funcionalidade de leitura de texto em voz alta integrada ao sistema, com controles de pausar e continuar. 3 - As funcionalidades de acessibilidade devem ser testadas com usuários reais para garantir sua eficácia. |
| US15 | Sistema de Marcadores para Documentos | Eu, como usuário, gostaria que o sistema oferecesse um sistema de marcadores para rastrear alterações em documentos específicos, afim de que eu possa visualizar rapidamente quais documentos foram alterados e quais alterações foram feitas. | 1 - O sistema deve permitir ao usuário marcar documentos específicos para rastreamento. 2 - O sistema deve notificar o usuário sobre quaisquer alterações feitas nos documentos marcados. 3 - As notificações devem incluir um resumo das alterações feitas, como data, hora, e tipo de alteração. 4 - O sistema deve permitir ao usuário visualizar um histórico de alterações para cada documento marcado. |
| US16 | Compatibilidade com Sistemas Operacionais Móveis | Eu, como usuário, gostaria que o sistema fosse compatível com as versões mais recentes dos sistemas operacionais móveis(Android e iOS), afim de poder utilizar o aplicativo com todas as funcionalidades disponíveis, sem enfrentar problemas de incompatibilidade. | 1 - O aplicativo deve funcionar corretamente nas duas últimas versões maiores de Android e iOS. 2 - O aplicativo deve ser testado em pelo menos três modelos diferentes de smartphones para cada sistema operacional. 3 - O sistema deve adaptar-se automaticamente a diferentes tamanhos de tela e resoluções sem perder funcionalidades ou qualidade gráfica. 4 - A equipe de desenvolvimento deve atualizar regularmente o aplicativo para garantir compatibilidade com novas versões dos sistemas operacionais assim que forem lançadas. |
| US17 | Navegação Intuitiva | Eu, como um usuário do DOU, gostaria que a interface de navegação fosse intuitiva e fácil de usar, a fim de que eu possa acessar diferentes seções e documentos sem dificuldade. | 1 - O sistema deve ter um menu de navegação claro e acessível. 2 - As seções principais devem ser visíveis e de fácil acesso (mínimo de cliques possível). 3 - A estrutura das telas deve ser consistente, evitando alterações de layout que possam confundir o usuário. |
| US18 | Download de Documentos para Acesso Offline | Eu, como um usuário, gostaria que o sistema permitisse o download de documentos para acesso off-line, a fim de que eu possa ler os documentos mesmo sem conexão à internet. | 1 - O sistema deve permitir o download dos documentos em formatos acessíveis (ex.: PDF). 2 - Os documentos baixados devem manter a formatação e legibilidade original. |
| US19 | Design Responsivo para Dispositivos Móveis | Eu, como um usuário que acessa o DOU por dispositivos móveis, gostaria que o sistema tivesse um design responsivo, a fim de que eu possa navegar e ler documentos facilmente em qualquer dispositivo e independente da disposição da tela. | 1 - O sistema deve ajustar automaticamente o layout para diferentes tamanhos e orientações de tela. 2 - A navegação e leitura devem ser fluidas. 3 - Textos e botões devem ser redimensionados automaticamente para garantir legibilidade e clicabilidade em diferentes telas. |
| US20 | Alertas Personalizados para Mudanças em Legislações | Eu, como usuário, gostaria que o sistema permitisse a criação de alertas personalizados para mudanças em legislações específicas, para que eu possa ser informado imediatamente quando houver alterações relevantes. | 1 - O sistema deve permitir a configuração de alertas baseados em palavras-chave ou identificadores específicos de legislações. 2 - Os alertas devem ser enviados por push notification e e-mail. 3 - O sistema deve garantir que os alertas sejam enviados de maneira oportuna, dentro de 24 horas após a publicação da alteração. |
| US21 | Anotações Colaborativas | Eu, como usuário, gostaria que o sistema tivesse uma funcionalidade de anotações colaborativas, para que eu possa trabalhar em conjunto com minha equipe ao revisar documentos do Diário Oficial da União. | 1 - O sistema deve permitir que múltiplos usuários adicionem e visualizem anotações em um mesmo documento. 2 - As anotações devem ter opções de visibilidade, podendo ser públicas para a equipe ou privadas. 3 - O sistema deve notificar os usuários sobre novas anotações ou atualizações em anotações existentes. |
Fonte: Arthur Alves, Diego Sousa, Eric Silveira, Henrique Torres, João Artur e Luiz Gustavo.
Reunião para validação das Histórias de Usuário
No dia 27 de maio de 2024, às 16h30, foi realizada uma reunião presencial, na FGA entre três membros da equipe e o Product Owner(PO) Giovanni, estudante pesquisador. Durante a reunião, eles discutiram e validaram as histórias de usuário do projeto. Isso garantiu um alinhamento estratégico e eficiente para as próximas etapas do projeto. A ata da reunião de histórias de usuário está disponível em Link da ata. A tabela 3 apresenta os participantes da reunião.
Tabela 3: Participantes.
| Nome | Função |
|---|---|
| Arthur Alves | Entrevistador |
| Eric Silveira | Entrevistador |
| João Artur | Entrevistador |
| Giovanni | Product Owner |
Fonte: João Artur.
Gravação da validação das Histórias de Usuários
Referência Bibliográfica
1. PRESSMAN, Roger S.; MAXIM, Bruce R.. Engenharia de software: uma abordagem profissional. 8 Porto Alegre: AMGH, 2016.
Bibliografia
Histórias de Usuário Bilheteria Digital. Disponível em: https://requisitos-de-software.github.io/2023.1-BilheteriaDigital/modelagem/agil/historia-de-usuario/. Acesso em 21 de maio de 2024.
Histórias de Usuário Lichess. Disponível em: https://requisitos-de-software.github.io/2022.2-Lichess/modelagem/agil/us/. Acesso em 21 de maio de 2024.
EBY, Kate. Baixe modelos de história de usuário gratuitos. Smartsheet, 22 ago. 2018. Disponível em: https://pt.smartsheet.com/user-story-templates. Acesso em: 24 maio 2024.
Histórico de Versão
| Versão | Data | Data Prevista de Revisão | Descrição | Autor | Revisor |
|---|---|---|---|---|---|
1.0 |
21/05/2024 | 22/05/2024 | Criação do documento sobre histórias de usuário | João Artur | Diego Sousa e Douglas Marinho |
1.1 |
24/05/2024 | 24/05/2024 | Adição de template | Diego Sousa | João Artur e Douglas Marinho |
1.2 |
25/05/2024 | 25/05/2024 | Refatoração do template e adição das US's de 01 à 04 | Eric Silveira | João Artur e Diego Sousa |
1.3 |
25/05/2024 | 25/05/2024 | Adição das US's de 05 à 08 | Arthur Alves | João Artur e Diego Sousa |
1.4 |
25/05/2024 | 25/05/2024 | Adição das US's de 09 à 12 | Diego Sousa | João Artur e Douglas Marinho |
1.5 |
25/05/2024 | 25/05/2024 | Adicionando introdução das tabelas e adição das US's de 13 à 16 | João Artur | Diego Sousa e Douglas Marinho |
1.6 |
25/05/2024 | 25/05/2024 | Adição das US's de 17 à 19 | Luiz Gustavo | Diego Sousa e João Artur |
1.7 |
26/05/2024 | 26/05/2024 | Adição das US's de 20 e 21 | Henrique Torres | Diego Sousa e João Artur |
1.8 |
27/05/2024 | 27/05/2024 | Adicionando gravação da reunião e títulos das histórias de usuário | João Artur | Diego Sousa |
1.9 |
29/05/2024 | 29/05/2024 | Correção Pós-Entrega (Corrigindo introdução da tabela e removendo status de aceitação pelo PO) | João Artur | Diego Sousa |
2.0 |
08/07/2024 | 08/07/2024 | Padronizando objetivo | João Artur | Diego Sousa |