Skip to content

GitLab

Last edited by Henrique Cardoso Zanette
Page history
This is an old version of this page. You can view the most recent version or browse the history.

Escopo

Home Escopo Processo Mockups Configuração Arquitetura Gerência BD Qualidade Frontend Backend

Sumário

Termo de abertura do projeto

Título do Projeto: Colabora aí

Professor Orientador: Marcelo H. Yamaguti

Semestre: Terça e Quinta JK - 2024/2

Stakeholder: Paula Pessoa Pureur (doutoranda em Sociologia e Ciência Política da PUCRS).

Justificativa do Projeto: Em 2019, os dados do Adjust (uma plataforma que oferece serviços e suporte a empresas em nível tecnológico) apontavam que as organizações ao redor do mundo investiram US$ 1,2 trilhão em iniciativas de transformação digital. Já em cenário nacional, em 2021, o Brasil se tornou o 4º maior mercado de downloads de aplicativos no mundo e em 2022, mais de 78% dos consumidores brasileiros acessaram a Internet com seus dispositivos mobile, sendo que a segunda categoria de aplicativos mais baixados é relacionada aos serviços de utilidade pública. Portanto, o projeto a ser desenvolvido é um aplicativo para celular que auxilia nas brechas de comunicação entre governo-sociedade, promovendo a importância dos cuidados básicos de saúde, educação e apoio na manutenção das moradias, colaborando com o controle financeiro das famílias por meio de dicas e pequenos textos educativos.

Objetivos do Projeto: Desenvolver um aplicativo mobile que oferece serviços interligados, numa só plataforma, relacionados a Economia, Moradia, Saúde, Educação, Direitos e Deveres do cidadão. O aplicativo deve ter um layout simples, colorido para facilitar a visualização, deve ser fácil de usar e acessar. Sua apresentação deve ser clara o suficiente para as pessoas aprenderem rapidamente a manusear a ferramenta. Atrativo suficiente para ter muitos interessados e bem ajustado ao públicoalvo que são as pessoas de baixa renda. O objetivo do aplicativo é incluí-las, com auxílio da tecnologia, de modo que possam se sentir melhor, estando melhor preparadas para a vida e mais atualizadas sobre as demandas recentes.

Descrição do projeto em alto nível

  • Usuários:
    • Cadastro do usuário.
    • Login.
  • Administrador de conteúdos:
    • Criação e edição de categorias.
    • Criação e edição de conteúdos [texto, imagem, vídeo e som] por categorias.
    • Consultar avaliações de conteúdos por filtros.
  • Acesso aos conteúdos:
    • Acesso com geolocalização do usuário.
    • Filtro de pesquisa (busca de conteúdo).
    • Avaliação de conteúdo.

Não está no escopo: Plataforma de pagamento.

Tecnologia: Aplicativo mobile para Android.

Personas

Durante o processo de desenvolvimento de projetos, é fundamental entender as necessidades, motivações e características do público-alvo de aplicações. Para essa finalidade, utiliza-se o conceito denominado de "personas", que são representações fictícias de diferentes tipos de usuário que podem interagir com um projeto. Estas personas são utilizadas para guiar e moldar a experiência do usuário e tomar decisões estratégicas.

Persona 1 - Manuela

image

Persona 2 - Maria image
Persona 3 - Paula image

User Stories

As histórias de usuário formuladas foram organizadas em conjuntos denominados "épicos", com o propósito de simplificar a visualização das funcionalidades do aplicativo nas fases de conclusão, desenvolvimento ativo e planejamento. Cada épico abrange histórias de usuário convencionais ou histórias de administração.

Os épicos criados foram:

  • Home Page (Usuário)
  • Categorias
  • Login/Logout (Administrador)
  • Home Page (Administrador)
  • Conteúdos (Administrador)
  • Pontos de Interesse (Administrador)

Usuário

Home Page

US01 – Acessar Home de Usuário

Como Maria, gostaria de de acessar a a home page para que eu possa navegar na aplicação.

Critérios de aceite:

  1. Dado que abri a aplicação, gostaria de ser redirecionado para tela de home.

  2. Dado que estou com a tela de home aberta, gostaria de ver as categorias do aplicativo para acessar seus conteúdos.

  3. Dado que estou com a tela de home aberta, gostaria de poder pesquisar por um conteúdo.

Categorias

US02 – Acessar a página de uma categoria

Como Maria, gostaria de acessar a página de uma categoria para que eu possa visualizar os conteúdos.

Critérios de aceite:

  1. Dado que estou com o aplicativo aberto na tela home, então ao clicar em alguma categoria na tela home, irei ser redirecionado para a página específica daquela categoria, para que possa visualizar seus conteúdos.
US03 – Visualizar Conteúdo de uma Categoria

Como Maria, gostaria de visualizar o conteúdo de uma categoria para que eu possa encontrar informações relevantes.

Critérios de aceite:

  1. Dado que estou com o aplicativo aberto, quando acesso uma página de categoria, então devo ver um carrossel com os conteúdos em destaque da categoria e uma lista com cada um dos conteúdos cadastrados para aquela categoria. Cada conteúdo deve exibir imagem (se tiver), título, descrição.

  2. Dado que que estou com o aplicativo aberto, quando acesso uma página de categoria, e a lista de conteúdos é maior que a altura da tela, quando eu rolar a página para baixo então eu devo ver mais conteúdos.

US04 – Filtrar Conteúdo de uma Categoria

Como Maria, gostaria de filtrar o conteúdo de uma categoria por título para que eu possa encontrar informações específicas.

Critérios de aceite:

  1. Dado que estou na página de uma categoria específica, quando insiro o título de um conteúdo na barra de pesquisa e clico no botão “Filtrar”, então devo ver uma lista dos conteúdos que possuem as palavras digitadas em seu título.

  2. Dado que estou na página de uma categoria específica, quando insiro o título de um conteúdo na barra de pesquisa e clico no botão “Filtrar”, e nenhum conteúdo é retornado, então devo ver uma mensagem de conteúdo não encontrado.

US05 – Avaliar Conteúdo de uma Categoria

Como Manuela, gostaria de avaliar o conteúdo de uma categoria para que eu possa compartilhar minha opinião sobre o conteúdo ao administrador.

Critérios de aceite:

  1. Dado que estou na página de um conteúdo dentro de uma categoria, gostaria de poder avaliar o conteúdo que vi ao chegar no final de sua leitura.

  2. Dado que realizei uma avaliação, então devo poder enviar minha opinião, que será registrada no sistema para visualização do administrador.

  3. Dado que enviei minha avaliação, então devo ter uma confirmação que a avaliação foi enviada com sucesso.

US06 – Redirecionar para Mapa a Partir de Categoria

Como Manuela, gostaria de ser redirecionado para o mapa a partir de um botão na categoria para que eu possa ver a localização referenciada pelo conteúdo.

Critérios de aceite:

  1. Dado que estou na página de conteúdo dentro de uma categoria diferente de pontos de interesse, então deve haver um botão que me redirecione para o mapa com a localização relacionada ao conteúdo.

  2. Dado que cliquei no botão de redirecionamento, devo ser redirecionado diretamente para o ponto de interesse correspondente no mapa.

US07 – Ver Cartão de Detalhes no Mapa

Como Manuela, gostaria de ver o cartão de detalhes em um ponto de interesse no mapa, para poder identificar informações do ponto de interesse.

Critérios de aceite:

  1. Dado que estou no mapa, quando clico em um ponto de interesse, então um cartão de detalhes sobre esse ponto de interesse deve ser exibido com informações relevantes sobre o ponto, como nome, descrição e a distância até esse ponto.

  2. Dado que o cartão de detalhes está aberto, devo fechá-lo ao clicar em uma opção de fechar ou em algum outro lugar da tela fora do cartão.

US08 – Visualizar Pontos de Interesse no Mapa

Como Maria, gostaria de visualizar pontos de interesse no mapa para que eu possa explorá-los mais facilmente.

Critérios de aceite:

  1. Dado que estou na tela de pontos de interesse, todos os pontos de interesse disponíveis devem ser exibidos em seus respectivos locais.

  2. Dado que estou na tela de pontos de interesse, devo poder clicar em um ponto de interesse para visualizar seu cartão de detalhes.

  3. Dado que estou na tela de pontos de interesse, devo poder explorar o mapa disponibilizado.

US09 – Filtrar Pontos de Interesse no Mapa

Como Maria, gostaria de filtrar os pontos de interesse no mapa para que eu possa encontrar locais específicos.

Critérios de aceite:

  1. Dado que estou na tela de pontos de interesse, deve haver uma opção de filtro para que possa selecionar categorias específicas de pontos de interesse (moradia ou saúde).

  2. Dado que selecionei um dos filtros disponíveis, apenas os pontos de interesse que correspondem ao critério selecionado devem ser exibidos no mapa.

  3. Dado que nenhum ponto de interesse foi encontrado no filtro, uma mensagem informativa deve ser exibida indicando que não há pontos de interesse próximos correspondentes ao filtro.

Administrador

US10 – Realizar Login na Aplicação (Administrador)

Como Paula (administrador), gostaria de realizar login na aplicação para que eu possa acessar a área administrativa.

Critérios de aceite:

  1. Dado que estou na tela de login, devo poder inserir minhas credenciais (nome de usuário e senha) para acessar a área administrativa.

  2. Dado que inseri credenciais válidas, então devo ser redirecionado para a tela home de administração.

  3. Dado que inseri credenciais inválidas, uma mensagem de erro deve ser exibida, informando que o login não foi bem sucedido.

US11 – Realizar Logout da Aplicação (Administrador)

Como Paula (administrador), gostaria de realizar logout para que eu possa encerrar minha sessão.

Critérios de aceite:

  1. Dado que realizei o login para área administrativa, devo poder clicar em um botão de sair para encerrar minha sessão.

  2. Dado que cliquei no botão de sair, devo ser redirecionado novamente para a página de login com uma confirmação de que a sessão foi encerrada.

Home Page

US12 – Visualizar Home Page da Administração

Como Paula (administrador), gostaria de visualizar a home page da administração para que eu possa navegar entre a gerência dos conteúdos.

Critérios de aceite:

  1. Dado que estou com uma sessão ativa na área administrativa, ao acessar a página home, devo ver botões para gerenciar os conteúdos e pontos de interesse da aplicação.

  2. Dado que estou com uma sessão ativa na área administrativa, devo poder ver os conteúdos já cadastrados na aplicação.

Conteúdos

US13 – Cadastrar Novos Conteúdos

Como Paula (administrador), gostaria de cadastrar novos conteúdos na aplicação para que eu possa disponibilizá-los aos usuários.

Critérios de aceite:

  1. Dado que estou na área administrativa, devo poder realizar o cadastro de um conteúdo, inserindo informações como categoria, título, texto, imagem (opcional) e ponto de interesse (opcional).

  2. Dado que inseri todas as informações obrigatórias e cliquei no botão de cadastrar, o conteúdo deve ser salvo e adicionado à lista de conteúdos disponíveis para os usuários.

  3. Dado que o conteúdo foi cadastrado com sucesso, uma mensagem de confirmação de cadastro do conteúdo deve ser exibida.

  4. Dado que o conteúdo não foi cadastrado devido a informações faltantes ou problemas de rede, uma mensagem de erro deve ser exibida informando que não foi possível cadastrar o conteúdo.

US14 – Editar Conteúdos Existentes

Como Paula (administrador), gostaria de editar conteúdos existentes para que eu possa mantê-los atualizados.

Critérios de aceite:

  1. Dado que estou na área administrativa, devo poder acessar a lista de conteúdos cadastrados e poder selecionar um conteúdo para editá-lo.

  2. Dado que estou com a modal de edição de conteúdo aberta, devo poder alterar o título, texto, imagem e ponto de interesse.

  3. Dado que realizei as atualizações necessárias e cliquei no botão de salvar, as mudanças devem ser aplicadas e refletidas na lista de conteúdos disponíveis para os usuários.

  4. Dado que as alterações foram salvas com sucesso, uma mensagem de confirmação de edição do conteúdo deve ser exibida.

  5. Dado que as alterações não foram salvas devido às informações faltantes ou problemas de rede, uma mensagem de erro deve ser exibida informando que o conteúdo não foi atualizado.

US15 – Excluir Conteúdos

Como Paula (administrador), gostaria de excluir conteúdos para que eu possa manter a aplicação organizada e remover conteúdos não mais relevantes.

Critérios de aceite:

  1. Dado que estou na área administrativa, devo poder acessar a lista de conteúdos e poder selecionar um conteúdo para excluí-lo.

  2. Dado que selecionei um conteúdo para exclusão, devo ver uma confirmação pedindo para confirmar ou cancelar a exclusão.

  3. Dado que confirmei a exclusão do conteúdo, ele deve ser removido da lista de conteúdos disponíveis para os usuários.

  4. Dado que o conteúdo foi excluído com sucesso, uma mensagem de confirmação deve ser exibida.

  5. Dado que cancelei a exclusão, o conteúdo deve permanecer inalterado na lista de conteúdos.

Pontos de Interesse

US16 – Cadastrar Novos Pontos de Interesse

Como Paula (administrador), gostaria de cadastrar novos pontos de interesse para que eu possa disponibilizá-los no mapa para os usuários.

Critérios de aceite:

  1. Dado que estou na área administrativa, devo poder abrir uma modal para realizar o cadastro de um ponto de interesse.

  2. Dado que estou com a modal de cadastro de pontos de interesse aberto, devo poder inserir o título, descrição, CEP, estado, cidade e endereço do ponto.

  3. Dado que inseri todas informações obrigatórias do ponto de interesse e cliquei em salvar, o ponto de interesse deve ser salvo e adicionado ao mapa para os usuários.

  4. Dado que o ponto de interesse foi cadastrado com sucesso, uma mensagem de confirmação deve ser exibida.

  5. Dado que o ponto de interesse não foi cadastrado devido a informações faltantes ou problemas de sistema, uma mensagem de erro deve ser exibida, informando que não foi possível cadastrar o ponto.

US17 – Editar Pontos de Interesse Existentes

Como Paula (administrador), gostaria de editar pontos de interesse existentes para que eu possa mantê-los atualizados.

Critérios de aceite:

  1. Dado que estou na área administrativa, devo poder abrir uma modal para realizar a atualização nos dados de um ponto de interesse.

  2. Dado que estou com a modal de edição de pontos de interesse aberto, devo poder atualizar o título, descrição, CEP, estado, cidade ou endereço do ponto.

  3. Dado que inseri informações válidas sobre o ponto de interesse e cliquei em salvar, o ponto de interesse deve ser salvo e atualizado no mapa para os usuários.

  4. Dado que o ponto de interesse foi atualizado com sucesso, uma mensagem de confirmação deve ser exibida.

  5. Dado que o ponto de interesse não foi atualizado devido a informações faltantes ou problemas de sistema, uma mensagem de erro deve ser exibida, informando que não foi possível cadastrar o ponto.

US18 – Excluir Pontos de Interesse

Como Paula (administrador), gostaria de excluir pontos de interesse para que eu possa manter o mapa atualizado e excluir pontos que não são mais relevantes.

Critérios de aceite:

  1. Dado que estou na área administrativa, devo poder acessar a lista de pontos de interesse e poder selecionar um ponto para excluí-lo.

  2. Dado que selecionei um ponto de interesse para exclusão, devo ver uma confirmação pedindo para confirmar ou cancelar a exclusão.

  3. Dado que confirmei a exclusão do ponto de interesse, ele deve ser removido da lista de pontos de interesse disponíveis para os usuários.

  4. Dado que o ponto de interesse foi excluído com sucesso, uma mensagem de confirmação deve ser exibida.

  5. Dado que cancelei a exclusão, o ponto de interesse deve permanecer inalterado na lista de conteúdos.

Sprints

Nesta seção, você encontrará as user stories de cada sprint, bem como o estado de aprovação de cada narrativa, tal como determinado pela parte interessada durante as revisões de sprint.

Definição de pronto

  • Código revisado e aprovado por ao menos dois AGES III/IV
  • Sem erros no console ao executar o que foi desenvolvido
  • Passar no teste funcional, de acordo com os critérios de aceite da US relacionada
  • Aplicação em ambiente de homologação
  • Aceitação do cliente

Escopo por Sprint

Sprint 1 | 27/08 a 12/09

User Story Descrição Status
US01 Como Maria, gostaria de de acessar a a home page para que eu possa navegar na aplicação.
US02 Como Maria, gostaria de acessar a página de uma categoria para que eu possa visualizar os conteúdos.
US03 Como Maria, gostaria de visualizar o conteúdo de uma categoria para que eu possa encontrar informações relevantes.
US04 Como Maria, gostaria de filtrar o conteúdo de uma categoria por título para que eu possa encontrar informações específicas.

Sprint 2 | 17/09 a 11/10

User Story Descrição Status
US05 Como Manuela, gostaria de avaliar o conteúdo de uma categoria para que eu possa compartilhar minha opinião sobre o conteúdo ao administrador.
US06 Como Manuela, gostaria de ser redirecionado para o mapa a partir de um botão na categoria para que eu possa ver a localização referenciada pelo conteúdo.
US07 Como Manuela, gostaria de ver o cartão de detalhes em um ponto de interesse no mapa, para poder identificar informações do ponto de interesse
US08 Como Maria, gostaria de visualizar pontos de interesse no mapa para que eu possa explorá-los mais facilmente.
US10 Como Paula (administrador), gostaria de realizar login na aplicação para que eu possa acessar a área administrativa.
US11 Como Paula (administrador), gostaria de realizar logout para que eu possa encerrar minha sessão.
US12 Como Paula (administrador), gostaria de visualizar a home page da administração para que eu possa navegar entre a gerência dos conteúdos.

Sprint 3 | 15/10 a 05/11

User Story Descrição Status
US09 Como Maria, gostaria de filtrar os pontos de interesse no mapa para que eu possa encontrar locais específicos.
US13 Como Paula (administrador), gostaria de cadastrar novos conteúdos na aplicação para que eu possa disponibilizá-los aos usuários.
US14 Como Paula (administrador), gostaria de editar conteúdos existentes para que eu possa mantê-los atualizados.
US15 Como Paula (administrador), gostaria de excluir conteúdos para que eu possa manter a aplicação organizada e remover conteúdos não mais relevantes.

Sprint 4 | 7/11 a 21/11

User Story Descrição Status
US16 Como Paula (administrador), gostaria de cadastrar novos pontos de interesse para que eu possa disponibilizá-los no mapa para os usuários.
US17 Como Paula (administrador), gostaria de editar pontos de interesse existentes para que eu possa mantê-los atualizados.
US18 Como Paula (administrador), gostaria de excluir pontos de interesse para que eu possa manter o mapa atualizado e excluir pontos que não são mais relevantes.