escopo.md

@@ -363,6 +363,19 @@ Nessa seção, estão descritas todas as user stories do projeto, junto dos crit
 
 </details>
 
+<details>
+<summary><b>AP-26</b> – Visibilidade de passos de um tutorial</summary>
+
+> **Como** usuário, **gostaria de** ter acesso rápido aos passos de um tutorial, **para** navegar rapidamente entre os passos e melhorar minha experiência de uso
+
+_Essa story será refinada se houver tempo para executá-la na última sprint, ou se a stakeholder aumentar a prioridade._
+
+**Notas:**
+- Expandir/recolher os passos de um tutorial (começar com apenas o primeiro passo expandido)
+- Atualizar mockups e validar previamente com a stakeholder
+
+</details>
+
 ### Buscar tutoriais
 
 <details>
@@ -452,6 +465,248 @@ Nessa seção, estão descritas todas as user stories do projeto, junto dos crit
 
 </details>
 
+### ADM:Login
+
+<details>
+<summary><b>AP-14</b> – Login do administrador</summary>
+
+> **Como** administrador, **gostaria de** realizar login com minha conta Appoio, **para** gerenciar os tutoriais submetidos e controlar os tutoriais publicados
+
+**Critérios de aceite:**
+1. Dado que eu esteja na tela de login, quando eu informar e-mail e senha de administrador corretamente e clicar em "Entrar", então eu devo ser redirecionado para a tela home do administrador.
+2. Dado que eu esteja na tela de login, quando eu informar e-mail e senha de administrador incorretamente e clicar em "Entrar", então a seguinte mensagem de erro deve ser exibida: "E-mail ou senha errados, tente novamente".
+
+**Anexos:**
+<div align="center">
+  <img src="resources/user-stories/ap-14.png" width="200" alt="Tela de login">
+</div>
+
+**Notas:**
+- Redirecionar para home do ADM quando logar com e-mail/senha de ADM
+
+</details>
+
+### ADM:Curadoria
+
+<details>
+<summary><b>AP-15</b> – Curadoria</summary>
+
+> **Como** administrador, **gostaria de** acessar os tutoriais que estão aguardando curadoria, **para** que possa revisá-los antes de publicar
+
+**Critérios de aceite:**
+1. Dado que estou na aba de curadoria, quando há tutoriais aguardando curadoria, então devo visualizar uma lista destes tutoriais e cada card deve conter: autor, data, título e categoria, e os cards estão ordenados de mais recente para mais antigo.
+2. Dado que estou na lista de tutoriais para curadoria, quando selecionar um card, então sou direcionado à tela de visualização do appoio ao qual o card se refere.
+
+**Anexos:**
+<div align="center">
+  <img src="resources/user-stories/ap-15.png" width="200" alt="Tela de curadoria">
+</div>
+
+**Notas:**
+- Tela de curadoria, com listagem de tutoriais aguardando revisão
+- Rota do backend e ação para tela de visualizar tutorial
+
+</details>
+
+<details>
+<summary><b>AP-16</b> – Aprovar ou reprovar tutoriais</summary>
+
+> **Como** administrador, **gostaria de** aprovar ou reprovar a publicação de um novo tutorial, **para** controlar a qualidade dos tutoriais disponíveis na plataforma
+
+**Critérios de aceite:**
+1. Dado que estou fazendo a curadoria dos tutoriais, quando selecionar um tutorial e visualizar sua descrição completa, então deve ser possível aprovar ou reprovar este tutorial.
+2. Dado que estou visualizando a descrição completa do tutorial, quando selecionar a opção aprovar, então devo ver uma mensagem de confirmação e o tutorial não deve mais aparecer na lista de curadoria e este deve ficar visível para usuários comuns.
+3. Dado que estou visualizando a descrição completa do tutorial, quando selecionar a opção reprovar, então devo ver uma mensagem de confirmação e o tutorial não deve mais aparecer na lista de curadoria e não ficar disponível para os usuários comuns.
+
+**Anexos:**
+<div align="center">
+  <img src="resources/user-stories/ap-16.png" width="600" alt="Fluxo de aprovação/reprovação de um appoio">
+</div>
+
+**Notas:**
+- Ajustes na tela de visualização de tutorial com botões "Aprovar" e "Reprovar"
+- Rota do backend para aprovar/reprovar, alerta após tocar no botão e fazer o request, e atualizar listagem da tela de listagem (remover tutorial da lista)
+
+</details>
+
+### ADM:Exportar dados
+
+<details>
+<summary><b>AP-17</b> – Exportar - básico</summary>
+
+> **Como** administrador, **gostaria de** exportar os dados básicos dos usuários cadastrados no app, **para** analisar o perfil dos usuários e melhorar a aplicação
+
+**Critérios de aceite:**
+1. Dado que estou logado como administrador, quando selecionar o menu "Dados", então sou direcionado à tela de exportação de dados.
+2. Dado que estou na tela de exportação de dados, então há um campo de e-mail para onde os dados devem ser enviados e o campo deve ser preenchido com o e-mail da minha conta no Appoio e o botão "Enviar" é habilitado.
+3. Dado que estou na tela de exportação de dados, quando o campo de e-mail é válido, então o botão "Enviar" é habilitado.
+4. Dado que estou na tela de exportação de dados, quando o campo de e-mail não é válido, então o botão "Enviar" é desabilitado.
+5. Dado que estou na tela de exportação de dados e o campo de e-mail é válido, quando tocar no botão "Enviar", então recebo um e-mail com um arquivo Excel ou CSV com os dados das contas Appoio e é exibido um alerta informando se a operação foi realizada com sucesso ou não.
+  a. Verificar formato sugerido do Excel em anexo.
+
+**Anexos:**
+<div align="center">
+  <img src="resources/user-stories/ap-17-1.png" width="400" alt="Fluxo para exportar os dados">
+</div>
+
+**Notas:**
+- Exportar dados dos usuários: gênero, ano de nascimento e estado/cidade
+- Aba no fluxo de ADM, alerta após exportação, rota do backend com geração de CSV/Excel e envio por e-mail
+
+</details>
+
+<details>
+<summary><b>AP-18</b> – Exportar - completo</summary>
+
+> **Como** administrador, **gostaria de** exportar dados de acesso aos tutoriais pelos usuários, **para** analisar o uso do app e melhorar a aplicação e os tutoriais publicados
+
+_Essa story será refinada se houver tempo para executá-la na última sprint, ou se a stakeholder aumentar a prioridade._
+
+**Notas:**
+- Exportar dados de acesso dos usuários aos tutoriais (perfil dos usuários que acessam os tutoriais)
+- Será refinada mais para frente, caso tenhamos tempo para executar essa story
+
+</details>
+
+<details>
+<summary><b>AP-19</b> – Registro de acesso para exportação</summary>
+
+> **Como** administrador, **gostaria de** registrar os acessos dos usuários aos tutoriais, **para** exporta-los e analisar o uso do app
+
+_Essa story será refinada se houver tempo para executá-la na última sprint, ou se a stakeholder aumentar a prioridade._
+
+</details>
+
+### ADM:Criar tutorial
+
+<details>
+<summary><b>AP-20</b> – Notificação de novo tutorial para revisão</summary>
+
+> **Como** administrador, **gostaria de** ser notificado sempre que houver um novo tutorial para revisar, **para** analisar e publicar assim que possível
+
+**Critérios de aceite:**
+1. Dado que um usuário comum está criando um tutorial, quando este usuário tocar o botão "Enviar Appoio", então recebo um e-mail informando que há um novo tutorial aguardando curadoria.
+
+**Notas:**
+- E-mail sempre que um novo tutorial é submetido para aprovação
+- Atualizar rota no backend de novo tutorial para enviar e-mail para ADM
+
+</details>
+
+<details>
+<summary><b>AP-21</b> – Novo tutorial (adm)</summary>
+
+> **Como** administrador, **gostaria de** criar um tutorial, **para** adicionar mais conteúdo de qualidade à plataforma
+
+**Critérios de aceite:**
+1. Dado que estou logado como administrador, quando selecionar o menu "Enviar Appoio", então sou levado à tela de novo tutorial e sou capaz de realizar o cadastro de um novo tutorial com múltiplos passos, imagens e vídeos (reusar o que foi desenvolvido nas USs AP-12 e AP-13).
+2. Dado que estou logado como administrador e terminei de informar os passo de um novo tutorial, quando tocar no botão "Publicar Appoio", então o tutorial é publicado para usuários comuns.
+  a. Também não recebo um e-mail notificando que há um tutorial aguardando curadoria, porque não preciso revisar tutoriais por mim criados.
+
+**Anexos:**
+<div align="center">
+  <img src="resources/user-stories/ap-21.png" width="600" alt="Fluxo de novo appoio (resumido)">
+</div>
+
+**Notas:**
+- Criar tutorial como ADM, sem passar pela curadoria
+- Reusar componentes do fluxo do usuário normal e colocar em nova aba do ADM, alerta de tutorial adicionado, redirecionar para aba "Curadoria", e atualizar rota no backend para não enviar e-mail para ADM e já publicar tutorial
+
+</details>
+
+### ADM:Aprovados
+
+<details>
+<summary><b>AP-22</b> – Listagem de tutoriais aprovados</summary>
+
+> **Como** administrador, **gostaria de** explorar os tutoriais disponíveis na plataforma, **para** verificar e manter a qualidade do conteúdo oferecido aos usuários
+
+**Critérios de aceite:**
+1. Dado que eu esteja logado como administrador, quando eu selecionar a aba "Aprovados", então a sub-aba "Aplicativos" deve estar selecionada e a listagem de tutoriais sobre aplicativos deve ser demonstrada.
+2. Dado que eu esteja logado como administrador e a aba "Aprovados" esteja selecionada e eu esteja em outra sub-aba que não seja a "Aplicativos", quando eu selecionar a sub-aba "Aplicativos", então a listagem de tutoriais sobre aplicativos deve ser demonstrada.
+3. Dado que eu esteja logado como administrador e a aba "Aprovados" esteja selecionada e eu esteja em outra sub-aba que não seja a "Celular", quando eu selecionar a sub-aba "Celular", então a listagem de tutoriais sobre celular deve ser demonstrada.
+4. Dado que eu esteja logado como administrador e a aba "Aprovados" esteja selecionada e eu esteja em outra sub-aba que não seja a "Conceitos", quando eu selecionar a sub-aba "Conceitos", então a listagem de tutoriais sobre conceitos deve ser demonstrada.
+5. Dado que eu esteja logado como administrador e a aba "Aprovados" esteja selecionada, quando eu clicar no card de um tutorial específico da listagem, então eu devo ser redirecionado para a tela de visualização daquele tutorial.
+
+**Anexos:**
+<div align="center">
+  <img src="resources/user-stories/ap-22.png" width="600" alt="Tela de tutoriais aprovados (três abas)">
+</div>
+
+**Notas:**
+- Aba "Aprovados" com as três abas das categorias
+- Apenas a listagem de acordo com a aba selecionada
+- Detalhamento do tutorial redirecionando para a tela de visualização daquele tutorial
+
+</details>
+
+<details>
+<summary><b>AP-23</b> – Remover tutorial publicado</summary>
+
+> **Como** administrador, **gostaria de** remover um tutorial publicado, **para** manter a base de tutoriais sempre atualizada e sem informações irrelevantes
+
+**Critérios de aceite:**
+1. Dado que eu esteja logado como administrador e a aba "Aprovados" esteja selecionada, quando eu clicar em "Remover" no card de um tutorial específico da listagem, então deve ser aberta a modal de confirmação da remoção daquele tutorial.
+2. Dado que eu esteja logado como administrador e a modal de confirmação da remoção de um tutorial esteja aberta, quando eu clicar no "X", então eu devo retornar à listagem anterior.
+3. Dado que eu esteja logado como administrador e a modal de confirmação da remoção de um tutorial esteja aberta, quando eu clicar em "Cancelar", então eu devo retornar à listagem anterior.
+4. Dado que eu esteja logado como administrador e a modal de confirmação da remoção de um tutorial esteja aberta, quando eu clicar em "Remover", então o tutorial deve ser removido permanentemente do sistema e a mensagem "Removido!" deve ser exibida.
+
+**Anexos:**
+<div align="center">
+  <img src="resources/user-stories/ap-23-1.png" width="200" alt="Tela de aprovados com menu de opções de um appoio">
+  <img src="resources/user-stories/ap-23-2.png" width="400" alt="Alerta e confirmação de remoção de tutorial">
+</div>
+
+**Notas:**
+- Remover/deletar tutorial aprovado
+- Menu com opção de remover tutorial, alerta com confirmação, rota no backend e atualizar listagem após remoção
+
+</details>
+
+<details>
+<summary><b>AP-24</b> – Buscar tutoriais (adm)</summary>
+
+> **Como** administrador, **gostaria de** buscar tutoriais publicados, **para** encontrar um tutorial com facilidade
+
+**Critérios de aceite:**
+1. Dado que eu esteja logado como administrador e a aba "Aprovados" esteja selecionada, quando eu selecionar a barra de busca e digitar algum texto, então deve ser demonstrada a listagem dos tutoriais que contenham aquele texto ou em uma de suas tags, ou em seu título, ou no nome do aplicativo (caso aquele tutorial seja sobre um aplicativo).
+
+**Anexos:**
+<div align="center">
+  <img src="resources/user-stories/ap-24.png" width="200" alt="Tela de aprovados com busca">
+</div>
+
+**Notas:**
+- Busca nos aprovados
+- Adicionar searchbar, realizar a pesquisa e atualizar a listagem
+- Busca por tag, título do Appoio e nome do aplicativo
+
+</details>
+
+<details>
+<summary><b>AP-25</b> – Editar tutorial</summary>
+
+> **Como** administrador, **gostaria de** editar um tutorial publicado, **para** mantê-lo sempre atualizado
+
+**Critérios de aceite:**
+1. Dado que eu esteja logado como administrador e a aba "Aprovados" esteja selecionada, quando eu clicar em "Editar" no card de um tutorial específico da listagem, então eu devo ser redirecionado para a tela de edição de tutorial com todos os campos recolhidos.
+2. Dado que eu esteja logado como administrador e esteja na tela de edição de tutorial, quando eu clicar na seta de retorno, então eu devo retornar à listagem anterior.
+3. Dado que eu esteja logado como administrador e esteja na tela de edição de tutorial e um dos campos esteja recolhido, quando eu clicar na seta correspondente a esse campo, então esse campo deve ser expandido.
+4. Dado que eu esteja logado como administrador e esteja na tela de edição de tutorial e um dos campos esteja expandido, quando eu clicar na seta correspondente a esse campo, então esse campo deve ser recolhido.
+5. Dado que eu esteja logado como administrador e esteja na tela de edição de tutorial, quando eu alterar o tutorial e clicar em "Salvar", então o tutorial deve ser salvo e deve ser aberta uma modal indicando que o tutorial foi salvo.
+
+**Anexos:**
+<div align="center">
+  <img src="resources/user-stories/ap-25-1.png" width="200" alt="Tela de aprovados com menu de opções de um appoio">
+  <img src="resources/user-stories/ap-25-4.png" width="800" alt="Fluxo de edição de um appoio">
+</div>
+
+**Notas:**
+- Editar um tutorial aprovado
+- Reusar componentes do fluxo do usuário normal para ter a opção de expandir/recolher os campos "Informações" e "Passo a passo", rota no backend e voltar para tela anterior (de listagem)
+
+</details>
+
 ## Sprints
 
 Nessa seção, encontram-se as user stories por sprint com status de aceite, assim como a EAP do projeto e uma definição de pronto para as USs.