Skip to content

GitLab

escopo · Changes

Page history
Add stories for non-admin user authored by Rafael Victor Ruwer Araujo's avatar Rafael Victor Ruwer Araujo
Hide whitespace changes
Inline Side-by-side
escopo.md
View page @ ba956267
......@@ -115,7 +115,342 @@ Observações:
## User Stories
TDB.
Nessa seção, estão descritas todas as user stories do projeto, junto dos critérios de aceite e demais detalhes de importância. As USs estão organizadas por épicos, e ordenadas por código.
### Login/Cadastro
<details>
<summary><b>AP-1</b> – Criar conta</summary>
> **Como** usuário, **gostaria de** criar uma conta no Appoio, **para** enviar meus tutoriais e ter minhas preferências salvas
**Critérios de aceite:**
1. Dado que estou na tela de login, quando tocar no botão "Cadastre-se", então sou direcionado à tela de criação de conta e todos os campos estão vazios e o botão "Cadastrar" está habilitado.
2. Dado que estou na tela de criação de conta, então consigo inserir obrigatoriamente meu nome e meu e-mail e uma senha e meu gênero (dentre as opções masculino, feminino e outro) e o ano em que nasci e o estado e a cidade onde moro.
3. Dado que estou na tela de criação de conta, quando digitar minha senha, então os caracteres digitados não devem estar visíveis.
4. Dado que estou na tela de criação de conta:
a. quando tocar no botão "Mostrar" no campo de senha, então o conteúdo do campo de senha deve ficar visível;
b. quando tocar no botão "Ocultar" no campo de senha, então o conteúdo do campo de senha deve ficar escondido.
5. Dado que estou na tela de criação de conta e algum campo está vazio ou com dados inválidos, quando tocar no botão "Cadastrar", então é exibida uma mensagem de erro junto a cada campo vazio/inválido e permaneço na mesma tela e uma conta não é criada.
6. Dado que estou na tela de criação de conta e todos os campos estão preenchidos com dados válidos, quando tocar no botão "Cadastrar", então um indicativo de carregamento é exibido e uma conta é criada e sou direcionado à tela de seleção de aplicativos instalados.
7. Dado que estou na tela de criação de conta, quando tocar no botão "Voltar", então sou levado de volta ao login.
8. Dado que estou na tela de criação de conta, quando quando selecionar "aceitar os termos", então deve ser possível finalizar o cadastro"
**Anexos:**
<div align="center">
<img src="resources/user-stories/ap-1.png" width="200" alt="Tela de cadastro">
</div>
**Notas:**
- Tela de criação de conta, sem a seleção de apps instalados.
</details>
<details>
<summary><b>AP-2</b> – Login</summary>
> **Como** usuário, **gostaria de** realizar login com uma conta Appoio, **para** restaurar minhas preferências para usar o app e enviar tutoriais
**Critérios de aceite:**
1. Dado que estou na tela inicial do meu celular e não realizei login e não criei uma conta no app Appoio, quando tocar no ícone do app, então sou levado à tela de login.
2. Dado que estou usando o app e não realizei login e não criei uma conta no app, quando tocar no menu "Enviar Appoio", então sou direcionado à tela de login e, após o login, sou direcionado à criação de um appoio.
3. Dado que já abri o app Appoio e não realizei login e não criei uma conta, quando tocar no seu ícone a partir da tela inicial, então sou levado à tela de login.
4. Dado que estou na tela de login, então consigo inserir obrigatoriamente o e-mail e a senha da minha conta Appoio.
5. Dado que estou na tela de login e os campos estão preenchidos e no formato correto, quando tocar no botão "Entrar", então um indicador de carregamento é exibido e minhas credenciais são validadas:
a. quando minhas credenciais forem válidas, então sou direcionado à tela inicial da aplicação (épico Home);
b. quando minhas credenciais não forem válidas, então uma mensagem de erro "E-mail ou senha errados, tente novamente" é exibida.
6. Dado que estou na tela de login, quando tocar no botão "Cadastre-se", então sou levado à tela de criação de conta (AP-1).
7. Dado que estou na tela de login, quando tocar no botão "Preciso de ajuda para fazer login", então sou levado a um tutorial de como realizar login e criar uma conta.
8. Dado que estou na tela de login, quando tocar no botão "Pular login", então sou levado à tela inicial da aplicação (épico Home).
9. (mesmo critério da AP-1) Dado que estou na tela de criação de conta, quando digitar minha senha, então os caracteres digitados não devem estar visíveis.
10. (mesmo critério da AP-1) Dado que estou na tela de criação de conta:
a. quando tocar no botão "Mostrar" no campo de senha, então o conteúdo do campo de senha deve ficar visível;
b. quando tocar no botão "Ocultar" no campo de senha, então o conteúdo do campo de senha deve ficar escondido.
**Anexos:**
<div align="center">
<img src="resources/user-stories/ap-2.png" width="200" alt="Tela de login">
</div>
**Notas:**
- Tela de login, sem ação do botão "Cadastre-se".
</details>
<details>
<summary><b>AP-3</b> – Seleção de apps instalados</summary>
> **Como** usuário cadastrado, **gostaria de** selecionar os apps que tenho instalados em meu dispositivo, **para** usar o app Appoio e pesquisar tutoriais a partir destes apps como atalhos
**Critérios de aceite:**
1. Dado que estou na tela de criação de conta e toquei no botão "Cadastrar", quando minha conta for criada, então sou direcionado à tela de seleção de apps instalados.
2. Dado que estou na tela de seleção de apps instalados, então vejo a lista dos apps mais utilizados conforme dados da pesquisa da cliente.
3. Dado que estou na tela de seleção de apps, quando tocar um app não selecionado, então este é destacado como selecionado.
4. Dado que estou na tela de seleção de apps, quando tocar um app selecionado, então este perde o destaque de seleção.
5. Dado que estou na tela de seleção de apps após a criação de uma conta, quando tocar no botão "Pular", então minha seleção de apps é desconsiderada e sou levado à tela inicial do aplicativo (épico Home).
6. Dado que estou na tela de seleção de apps após tocar o botão "Editar" na home, quando tocar no botão "Pular", então as alterações nos apps selecionados é desconsiderada e sou levado de volta à tela home.
7. Dado que estou na tela de seleção de apps, quando tocar no botão "Salvar", então os apps selecionados são persistidos no banco.
**Anexos:**
<div align="center">
<img src="resources/user-stories/ap-3.png" width="400" alt="Fluxo de seleção de apps">
</div>
**Notas:**
- Tela de selecionar aplicativos
- Usuários que pulam o login não passam por essa tela
</details>
### Home
<details>
<summary><b>AP-4</b> – Atalhos de apps instalados</summary>
> **Como** usuário, **gostaria de** visualizar atalhos dos apps que tenho instalado, **para** acessar rapidamente os tutoriais de um app que preciso
**Critérios de aceite:**
1. Dado que estou na tela home e estou logado, então há a seção "Aplicativos instalados" e um botão para editar a seleção de apps instalados.
2. Dado que estou na tela home e não estou logado, então não há a seção "Aplicativos instalados".
3. Dado que estou na tela home e estou logado e tenho apps instalados que possuem tutoriais, então vejo atalhos para acessar os tutoriais destes apps.
4. Dado que estou na tela home, e estou logado, e não tenho apps instalados ou meus apps instalados não possuem tutoriais, então não vejo atalhos para estes apps.
**Anexos:**
<div align="center">
<img src="resources/user-stories/ap-4.png" width="200" alt="Apps selecionados com tutoriais">
</div>
**Notas:**
- Apenas a seção "Aplicativos instalados" da aba "Aplicativos" na home
- Esta US não inclui o "Editar"
- Apenas apps instalados que tem pelo menos um tutorial disponível
</details>
<details>
<summary><b>AP-5</b> – Atalhos de apps não instalados</summary>
> **Como** usuário, **gostaria de** visualizar atalhos dos apps que não tenho instalado, **para** explorar tutoriais de outros apps
**Critérios de aceite:**
1. Dado que estou na tela home e estou logado, então há a seção "Todos os aplicativos com tutorial" e esta apresenta atalhos de apps que possuem pelo menos um tutorial e que não foram marcados como instalados (AP-3 e AP-7).
2. Dado que estou na tela home e não estou logado, então há a seção "Todos os aplicativos com tutorial" e esta apresenta atalhos de apps com pelo menos um tutorial.
**Anexos:**
<div align="center">
<img src="resources/user-stories/ap-5.png" width="200" alt="Todos os apps com tutoriais">
</div>
**Notas:**
- Apenas a seção "Todos os aplicativos com tutorial" na aba aba "Aplicativos" na home
- Apenas apps não instalados que tem pelo menos um tutorial disponível
</details>
<details>
<summary><b>AP-6</b> – Tutoriais de um app</summary>
> **Como** usuário, **gostaria de** visualizar os tutoriais de um app específico, **para** acessar rapidamente todos os tutoriais desse app
**Critérios de aceite:**
1. Dado que estou na tela home e há pelo menos um atalho de app na seção "Todos os aplicativos com tutorial", quando tocar no atalho de um app, então sou levado à uma listagem com tutoriais apenas deste app.
2. Dado que estou na tela home e estou logado e há pelo menos um atalho de app na seção "Aplicativos instalados", quando tocar no atalho de um app, então sou levado à uma listagem com tutoriais apenas deste app.
3. Dado que selecionei um atalho de app na home e estou na tela de listagem de tutoriais de um app, quando selecionar um tutorial da lista, então sou direcionado à visualização deste tutorial (AP-10).
**Anexos:**
<div align="center">
<img src="resources/user-stories/ap-6.png" width="600" alt="Fluxo para visualizar os tutoriais de um app">
</div>
**Notas:**
- Ação da home para a tela de pesquisa após selecionar um app na aba "Aplicativos" da tela home
- Essa story engloba alterações na listagem de tutoriais (desenvolvida na AP-10) que forem necessárias para exibir a tela quando um atalho de app é selecionado na home
</details>
<details>
<summary><b>AP-7</b> – Atualizar lista de apps instalados</summary>
> **Como** usuário, **gostaria de** editar os apps que tenho instalados, **para** ter acesso a tutoriais de outros apps de forma rápida
**Critérios de aceite:**
1. Dado que estou na tela home e estou logado, quando acionar o botão "Adicionar mais aplicativos", então sou levado à tela de seleção de aplicativos (AP-3) e os aplicativos previamente marcados como instalados estão destacados.
2. Dado que acionei o botão "Adicionar mais aplicativos" e estou na tela de seleção de aplicativos, quando marcar um app, então este deve ganhar um destaque em relação aos apps não marcados.
3. Dado que acionei o botão "Adicionar mais aplicativos" e estou na tela de seleção de aplicativos, quando desmarcar um app, então este deve perder o destaque em relação aos apps não marcados.
4. Dado que acionei o botão "Adicionar mais aplicativos" e estou na tela de seleção de aplicativos, quando acionar o botão "Salvar", então os apps selecionados são persistidos e sou levado à tela home e os atalhos de apps nas seções "Aplicativos instalados" e "Todos os aplicativos com tutoriais" estão atualizados de acordo com minha seleção na tela anterior.
5. Dado que acionei o botão "Adicionar mais aplicativos" e estou na tela de seleção de aplicativos, quando acionar o botão "Pular", então as mudanças de seleção de apps é desconsiderada e volto à tela home sem modificações nos atalhos de apps.
**Anexos:**
<div align="center">
<img src="resources/user-stories/ap-7.png" width="400" alt="Fluxo para editar lista de apps instalados">
</div>
**Notas:**
- Botão "Editar"
- Apenas usuários cadastrados veem esse botão (porque selecionaram apps após o cadastro)
</details>
### Explorar tutoriais
<details>
<summary><b>AP-8</b> – Tutoriais "Celular"</summary>
> **Como** usuário, **gostaria de** visualizar os tutoriais da categoria "Celular", **para** tirar dúvidas sobre funções do meu dispositivo e sistema operacional
**Critérios de aceite:**
1. Dado que obtive acesso ao app (após login, cadastro ou pular login), quando estiver na página inicial da aplicação, então há uma aba "Celular" para acesso rápido a tutoriais referentes ao meu dispositivo e sistema operacional.
2. Dado que estou na página inicial do app, quando tocar na aba "Celular", então a aba é destacada e a aba anteriormente selecionada perde o destaque e são exibidos os tutoriais da categoria celular, ordenados pela data de publicação, do mais recente ao mais antigo.
**Anexos:**
<div align="center">
<img src="resources/user-stories/ap-8.png" width="200" alt="Aba 'Celular'">
</div>
**Notas:**
- Apenas a aba "Celular" da home.
</details>
<details>
<summary><b>AP-9</b> – Tutoriais "Conceitos"</summary>
> **Como** usuário, **gostaria de** visualizar os tutoriais da categoria "Conceitos", **para** aprender mais sobre tecnologias e atualidades
**Critérios de aceite:**
1. Dado que obtive acesso ao app (após login, cadastro ou pular login), quando estiver na página inicial da aplicação, então há uma aba "Conceitos" para acesso rápido a tutoriais referentes ao meu dispositivo e sistema operacional.
2. Dado que estou na página inicial do app, quando tocar na aba "Conceitos", então a aba é destacada e a aba anteriormente selecionada perde o destaque e são exibidos os tutoriais da categoria conceitos, ordenados pela data de publicação, do mais recente ao mais antigo.
**Anexos:**
<div align="center">
<img src="resources/user-stories/ap-9.png" width="200" alt="Aba 'Conceitos'">
</div>
**Notas:**
- Apenas a aba "Conceitos" da home.
</details>
<details>
<summary><b>AP-10</b> – Página do tutorial</summary>
> **Como** usuário, **gostaria de** visualizar um tutorial, **para** aprender com ele e usar melhor meu smartphone
**Critérios de aceite:**
1. Dado que selecionei um tutorial de uma listagem, quando for direcionado à página do tutorial, então devo visualizar o nome/título do tutorial e o nome a descrição de seu primeiro passo.
2. Dado que selecionei um tutorial de uma listagem, quando fizer o scroll até o final da página, então devo visualizar informações complementares do tutorial:
a. tags;
b. nome do autor;
c. data da publicação;
d. sistema operacional e versão do sistema operacional ao qual o tutorial se aplica;
e. aplicativo e versão do aplicativo ao qual o tutorial se aplica.
3. Dado que estou visualizando os detalhes de um tutorial, quando um passo do tutorial possuir um vídeo no YouTube ou imagem relacionados, então o vídeo e a imagem são apresentadas abaixo da descrição do passo.
a. Se o passo tiver ambos, vídeo e imagem, o vídeo vem primeiro, depois a imagem.
4. (APENAS SPRINT 1) Dado que toquei no botão "Salvar tutorial" no fluxo "Enviar appoio", quando o tutorial for enviado com sucesso, então devo ver a página com o tutorial recém criado.
a. Obs.: durante a sprint 1, a página do tutorial deve ser aberta apenas após o envio de um appoio para revisão, com os dados do appoio enviado:
**Critérios técnicos:**
1. Deve ser possível não exibir as informações do critério 2, porque a tela será reutilizada para a exibição do tutorial de login/cadastro.
2. A tela construída deve ser capaz de ser apresentada tanto para tutoriais dentro do app, quanto para tutoriais antes do login/cadastro.
**Anexos:**
<div align="center">
<img src="resources/user-stories/ap-10.png" width="200" alt="Página do tutorial">
</div>
**Notas:**
- Tela do tutorial completo, sem botão para editar o tutorial caso o usuário logado seja um administrador (será detalhado em outra story).
</details>
### Buscar tutoriais
<details>
<summary><b>AP-11</b> – Pesquisa de tutoriais</summary>
> **Como** usuário, **gostaria de** pesquisar tutoriais por palavras-chave, **para** encontrar mais facilmente um tutorial que preciso
**Critérios de aceite:**
1. Dado que estou na tela home e com o teclado ativo e focado no campo de busca, quando dou Enter no teclado, então visualizo os resultados de pesquisa e o campo de texto da pesquisa é preenchido com o que foi preenchido na tela anterior.
a. A pesquisa não leva em consideração a aba selecionada na home; não deve filtrar os resultados considerando a aba selecionada.
2. Dado que estou na tela home, quando realizo uma pesquisa, então visualizo uma listagem com os tutoriais publicados que correspondem à minha pesquisa considerando o título e as tags de cada tutorial.
a. A pesquisa é realizada apenas sobre o título e as tags de cada tutorial.
3. Dado que estou na tela home e com a aba "Aplicativos" selecionada, quando seleciono um atalho de aplicativo, então vejo uma lista com todos os tutoriais publicados daquele aplicativo, ordenados pela data de publicação, do mais recente ao mais antigo.
4. Dado que selecionei um atalho de app na tela home e estou visualizando os tutoriais deste app, quando realizar uma pesquisa sobre os tutoriais, então devo ver tutoriais também de outros apps, do sistema operacional ou de conceitos, se estes forem compatíveis com os termos pesquisados.
a. A pesquisa não considera o app selecionado na home para filtrar os tutoriais exibidos.
**Anexos:**
<div align="center">
<img src="resources/user-stories/ap-11-1.png" width="200" alt="Home com pesquisa">
<img src="resources/user-stories/ap-11-2.png" width="200" alt="Resultados da pesquisa">
</div>
**Notas:**
- A pesquisa é sempre geral e não leva em consideração a aba selecionada na home, nem o app selecionado no atalho da home (quando na tela de pesquisa).
</details>
### Criar tutorial
<details>
<summary><b>AP-12</b> – Tutorial simples</summary>
> **Como** usuário logado, **gostaria de** cadastrar um tutorial básico, **para** disponibilizá-lo para outros usuários
**Critérios de aceite:**
1. Dado que eu esteja logado, quando eu clicar em "Enviar Appoio", então eu devo ser redirecionado para a tela de informações básicas do Enviar Appoio.
2. Dado que eu não esteja logado, quando eu clicar em "Enviar Appoio", então eu devo ser redirecionado para a tela de login.
3. Dado que eu esteja na tela de informações básicas do Enviar Appoio, quando eu selecionar a categoria Aplicativos, então eu devo conseguir selecionar obrigatoriamente o nome do aplicativo, inserir obrigatoriamente o nome do Appoio e o sistema operacional, e inserir opcionalmente a versão do aplicativo, a versão do sistema operacional e tags.
4. Dado que eu esteja na tela de informações básicas do Enviar Appoio, quando eu selecionar a categoria Celular, então eu devo conseguir inserir obrigatoriamente o nome do Appoio e o sistema operacional, e inserir opcionalmente a versão do sistema operacional e tags.
5. Dado que eu esteja na tela de informações básicas do Enviar Appoio, quando eu selecionar a categoria Conceitos, então eu devo conseguir inserir obrigatoriamente o nome do Appoio, e inserir opcionalmente tags.
6. Dado que eu esteja na tela de adicionar passo do Enviar Appoio, quando eu escrever o texto do passo do tutorial e clicar no botão "Enviar Appoio", então o meu tutorial deverá ser enviado para avaliação do administrador e eu devo ser redirecionado para a tela de "Obrigado Pela Contribuição!".
7. Dado que eu esteja na tela de "Obrigado Pela Contribuição!", quando eu clicar no botão "Enviar outro Appoio", então eu devo ser redirecionado para a tela de informações básicas do Enviar Appoio.
8. Dado que eu esteja na tela de Enviar Appoio, quando eu clicar em "Cancelar", então eu devo ser redirecionado para a tela Home.
**Anexos:**
<div align="center">
<img src="resources/user-stories/ap-12-1.png" width="200" alt="Primeira tela de enviar appoio">
<img src="resources/user-stories/ap-12-2.png" width="200" alt="Seleção de categoria do appoio">
<img src="resources/user-stories/ap-12-3.png" width="200" alt="Categoria 'apps' selecionada">
<img src="resources/user-stories/ap-12-4.png" width="200" alt="Seleção de um app específico">
<img src="resources/user-stories/ap-12-5.png" width="200" alt="Categoria 'celular' selecionada">
<img src="resources/user-stories/ap-12-6.png" width="200" alt="Categoria 'conceitos' selecionada">
<img src="resources/user-stories/ap-12-7.png" width="200" alt="Adição de um passo">
<img src="resources/user-stories/ap-12-8.png" width="200" alt="Appoio enviado">
</div>
**Notas:**
- Primeira tela com informações gerais
- Apenas um passo obrigatório, sem vídeo ou imagem
- Tela de "Obrigado pela contribuição" após salvar o tutorial
- Cancelar cadastro do tutorial
</details>
<details>
<summary><b>AP-13</b> – Tutorial completo</summary>
> **Como** usuário logado, **gostaria de** cadastrar novos passos e mídias a um tutorial, **para** enriquecer a qualidade do meu tutorial
**Critérios de aceite:**
1. Dado que eu esteja na tela de adicionar passo do Enviar Appoio, quando eu clicar no botão "Adicionar Novo Passo", então deve ser criado um novo passo vazio para eu preencher.
2. Dado que eu esteja na tela de adicionar passo do Enviar Appoio, quando eu clicar no botão "X" de um passo, então esse passo deverá ser removido da lista de passos.
3. Dado que eu esteja na tela de adicionar passo do Enviar Appoio, quando eu clicar em "Selecionar Imagem", então eu devo poder selecionar uma imagem do meu celular para adicioná-la ao tutorial.
4. Dado que eu esteja na tela de adicionar passo do Enviar Appoio, quando eu clicar em "Selecionar Imagem", então eu devo poder selecionar uma imagem do meu celular para adicioná-la àquele passo do tutorial.
5. Dado que eu esteja na tela de adicionar passo do Enviar Appoio, quando eu clicar em "Link do Vídeo", então eu devo poder inserir o link de um vídeo para adicioná-lo àquele passo do tutorial.
**Anexos:**
<div align="center">
<img src="resources/user-stories/ap-13-1.png" width="200" alt="Um passo">
<img src="resources/user-stories/ap-13-2.png" width="200" alt="Mais de um passo">
</div>
**Notas:**
- Adição e exclusão de passos a um tutorial (enquanto tá cadastrando)
- Adicionar imagem a um passo (no máximo uma imagem)
- Adicionar link de vídeo no YouTube a um passo
</details>
## Sprints
......