diff --git a/docs/modelagem/cenarios.md b/docs/modelagem/cenarios.md new file mode 100644 index 00000000..1384717a --- /dev/null +++ b/docs/modelagem/cenarios.md @@ -0,0 +1,266 @@ +# Cenários + +## Introdução +Cenários são como histórias em evolução que descrevem o que acontece em um ambiente específico, destacando as interações entre as pessoas envolvidas. Geralmente, essas interações envolvem o sistema em desenvolvimento e os participantes externos, como usuários ou outros sistemas. A característica mais importante de um cenário é que ele fornece uma representação concreta de uma atividade que os usuários executam ao realizar uma tarefa específica. + +Esses cenários desempenham um papel crucial na fase de levantamento de requisitos de sistemas de software. Eles são usados para descrever como os usuários irão utilizar o sistema e como o sistema se conecta com outros sistemas externos. Isso ajuda a entender e identificar novos requisitos de forma eficaz.[¹] + +## Metodologia + +A metodologia para criar cenários envolve a identificação de partes interessadas, coleta de informações, definição do escopo, identificação de cenários, descrição detalhada, validação, documentação e uso. Essa abordagem flexível adapta-se às necessidades do projeto, com a participação ativa das partes interessadas. +Os cenários do aplicativo Skoob foram criados com base nas técnicas de priorização (Moscow, Three-Level Scale e First Things First) utilizadas na elicitação de requisitos. +Dessa forma, os cenários serão representados conforme a tabela 1. + + +| Elemento | Descrição | +|-------------|--------------------------------------------------| +| Título | O nome ou assunto central do cenário. | +| Objetivo | A razão ou propósito para a existência do cenário. | +| Contexto | As condições iniciais, o ambiente físico e a cronologia do cenário. | +| Recursos | Itens inanimados com os quais os participantes interagem. | +| Ator | Indivíduos ou entidades organizacionais envolvidos no cenário. | +| Episódios | Ações realizadas pelos atores, muitas vezes com a participação de outros, usando os recursos. | +| Restrições | Regras ou limitações que afetam a execução dos episódios. | +| Exceção | Planos ou procedimentos para lidar com situações extraordinárias ou erros inesperados durante o cenário. | + +
+

Tabela 1: Modelo dos cenários. (Fonte: Shaíne Oliveira, 2023).

+
+ +## Cenários encontrados +As tabelas 2 a representam os cenários que foram identificados para o aplicativo Skoob. + + + +#### **C01: Adicionando um Livro à Estante Pessoal** + +| Elemento | Descrição | +|-------------|--------------------------------------------------| +| Título | Adicionar Livro à Estante | +| Objetivo | Permitir que os usuários organizem e gerenciem seus livros pessoais. | +| Contexto | O usuário está logado em sua conta no aplicativo. Ele está em casa, com acesso à internet. | +| Recursos | Smartphone ou computador, conexão com a internet. | +| Ator | Usuário do Skoob. | +| Episódios | 1. O usuário pesquisa um livro.
2. O usuário encontra o livro desejado.
3. O usuário clica no botão "Adicionar à Estante". | +| Restrições | O livro deve estar disponível na base de dados do Skoob. | +| Exceção | Se o livro não for encontrado, o sistema exibe uma mensagem de erro. | + +
+

Tabela 2: Cenário 01. (Fonte: Shaíne Oliveira, 2023).

+
+ +#### **C02: Avaliando um Livro Lido** + +| Elemento | Descrição | +|-------------|--------------------------------------------------| +| Título | Avaliar Livro Lido | +| Objetivo | Permitir que os usuários avaliem e compartilhem suas opiniões sobre livros lidos. | +| Contexto | O usuário, em sua residência, conectado à internet, está logado em sua conta e deseja avaliar um livro recentemente lido. | +| Recursos | Smartphone ou computador, conexão com a internet. | +| Ator | Usuário do Skoob. | +| Episódios | 1. O usuário acessa sua estante pessoal.
2. O usuário seleciona o livro que deseja avaliar.
3. O usuário atribui uma classificação e escreve uma resenha.
4. O usuário confirma a avaliação. | +| Restrições | O livro deve estar na estante do usuário. | +| Exceção | Se o usuário tentar avaliar um livro que não está em sua estante, o sistema exibe uma mensagem de erro. | + +
+

Tabela 3: Cenário 02. (Fonte: Shaíne Oliveira, 2023).

+
+ + +#### **C03: Realizando o Login** + +| Elemento | Descrição | +|-------------|--------------------------------------------------| +| Título | Realizar Login | +| Objetivo | Permitir que os usuários acessem suas contas no aplicativo. | +| Contexto | O usuário, em sua residência, conectado à internet, iniciou o aplicativo Skoob e deseja acessar sua conta. | +| Recursos | Smartphone ou computador, conexão com a internet. | +| Ator | Usuário do Skoob. | +| Episódios | 1. O usuário abre o aplicativo Skoob.
2. O usuário clica na opção "Login".
3. O usuário insere seu nome de usuário e senha.
4. O usuário clica no botão "Entrar". | +| Restrições | As credenciais de login devem ser válidas. | +| Exceção | Se as credenciais forem inválidas, o sistema exibe uma mensagem de erro. | + +
+

Tabela 4: Cenário 03. (Fonte: Shaíne Oliveira, 2023).

+
+ + + +#### **C04: Pesquisando Livros** + +| Elemento | Descrição | +|-------------|--------------------------------------------------| +| Título | Pesquisar Livros | +| Objetivo | Permitir que os usuários encontrem livros de seu interesse no aplicativo. | +| Contexto | O usuário, em sua residência, conectado à internet, está logado em sua conta e deseja encontrar um livro específico. | +| Recursos | Smartphone ou computador, conexão com a internet. | +| Ator | Usuário do Skoob. | +| Episódios | 1. O usuário acessa a função de pesquisa no aplicativo.
2. O usuário insere o título ou autor do livro desejado na barra de pesquisa.
3. O usuário clica no botão "Pesquisar".
4. O sistema exibe os resultados da pesquisa. | +| Restrições | A pesquisa deve retornar resultados válidos com base no título ou autor fornecidos. | +| Exceção | Se nenhum resultado for encontrado, o sistema exibe uma mensagem indicando que nenhum livro corresponde à pesquisa. | + +
+

Tabela 5: Cenário 04. (Fonte: Shaíne Oliveira, 2023).

+
+ +#### **C05: Adicionando Comentários em Posts** + +| Elemento | Descrição | +|-------------|--------------------------------------------------| +| Título | Adicionar Comentários em Posts | +| Objetivo | Permitir que os usuários interajam com as postagens, adicionando comentários. | +| Contexto | O usuário, em sua residência, conectado à internet, está logado em sua conta e deseja interagir com uma postagem. | +| Recursos | Smartphone ou computador, conexão com a internet. | +| Ator | Usuário do Skoob. | +| Episódios | 1. O usuário navega pelo feed de postagens.
2. O usuário seleciona uma postagem específica.
3. O usuário escreve seu comentário na caixa de texto.
4. O usuário clica no botão "Comentar". | +| Restrições | O comentário deve atender aos critérios de moderação e políticas do aplicativo. | +| Exceção | Se o comentário violar as políticas do aplicativo, ele não será publicado, e o sistema exibirá uma mensagem informando a violação. | + +
+

Tabela 6: Cenário 05. (Fonte: Shaíne Oliveira, 2023).

+
+ +#### **C06: Recuperando a Senha** + +| Elemento | Descrição | +|-------------|--------------------------------------------------| +| Título | Recuperar a Senha | +| Objetivo | Permitir que os usuários recuperem sua senha em caso de esquecimento. | +| Contexto | O usuário, em sua casa com acesso à internet, está logado no aplicativo Skoob, mas esqueceu sua senha de login. | +| Recursos | Smartphone ou computador, conexão com a internet. | +| Ator | Usuário do Skoob. | +| Episódios | 1. O usuário acessa a tela de login do aplicativo.
2. O usuário clica no link "Esqueci minha senha".
3. O sistema solicita ao usuário seu endereço de e-mail registrado.
4. O usuário insere seu endereço de e-mail e clica em "Enviar".
5. O sistema envia um e-mail com instruções para redefinir a senha.
6. O usuário acessa sua caixa de entrada de e-mail, segue as instruções e redefine a senha.
7. O sistema confirma a alteração bem-sucedida da senha. | +| Restrições | O endereço de e-mail fornecido deve estar associado à conta do usuário. | +| Exceção | Se o endereço de e-mail não estiver associado a nenhuma conta, o sistema informa que a recuperação de senha não é possível. | + +
+

Tabela 7: Cenário 06. (Fonte: Shaíne Oliveira, 2023).

+
+ + +#### **C07: Obtendo o Aplicativo em Qualquer Sistema Operacional** + +| Elemento | Descrição | +|-------------|--------------------------------------------------| +| Título | Obtendo o Aplicativo em Qualquer Sistema Operacional | +| Objetivo | Permitir que os usuários acessem o aplicativo Skoob em qualquer sistema operacional compatível. | +| Contexto | O usuário deseja baixar o aplicativo Skoob em um dispositivo com qualquer sistema operacional compatível (por exemplo, Android, iOS, Windows, macOS), e possui acesso à internet na sua casa. | +| Recursos | Dispositivo com sistema operacional compatível, conexão com a internet. | +| Ator | Usuário do Skoob. | +| Episódios | 1. O usuário acessa a loja de aplicativos apropriada para o seu sistema operacional (App Store, Google Play Store, Microsoft Store, etc.).
2. O usuário pesquisa por "Skoob" na loja de aplicativos.
3. O usuário localiza o aplicativo Skoob na lista de resultados.
4. O usuário clica no botão "Baixar" ou "Instalar".
5. O sistema inicia o download e instalação do aplicativo no dispositivo do usuário.
6. O aplicativo Skoob é instalado com sucesso no dispositivo do usuário. | +| Restrições | O dispositivo do usuário deve ser compatível com o sistema operacional e atender aos requisitos de hardware e software do aplicativo. | +| Exceção | Se o dispositivo não for compatível ou não atender aos requisitos mínimos, o usuário não conseguirá baixar e instalar o aplicativo. | + +
+

Tabela 8: Cenário 07. (Fonte: Shaíne Oliveira, 2023).

+
+ + + + +#### **C08: Criando uma Meta de Leitura para o Ano** + +| Elemento | Descrição | +|-------------|--------------------------------------------------| +| Título | Criar uma Meta de Leitura para o Ano | +| Objetivo | Permitir que os usuários estabeleçam uma meta de leitura pessoal para o ano. | +| Contexto | O usuário, em casa ou em qualquer local com acesso à internet, está logado em sua conta no aplicativo Skoob. | +| Recursos | Smartphone, tablet ou computador, conexão com a internet. | +| Ator | Usuário do Skoob. | +| Episódios | 1. O usuário acessa a seção "Metas de Leitura" no aplicativo.
2. O usuário clica no botão "Criar Nova Meta".
3. O sistema solicita ao usuário detalhes da meta, como o número de livros a serem lidos e a data limite para alcançar a meta.
4. O usuário fornece esses detalhes, incluindo o número desejado de livros e a data de conclusão da meta.
5. O sistema confirma a criação da meta. | +| Restrições | A data limite deve ser definida para um período futuro, e o número de livros deve ser um valor inteiro válido. | +| Exceção | Se o usuário tentar criar uma meta com data no passado ou inserir informações inválidas, o sistema exibe uma mensagem de erro. | + +
+

Tabela 9: Cenário 08. (Fonte: Shaíne Oliveira, 2023).

+
+ +#### **C09: Cadastro/Login com Credenciais do Facebook** + +| Elemento | Descrição | +|-------------|--------------------------------------------------| +| Título | Cadastro/Login com Credenciais do Facebook | +| Objetivo | Permitir que os usuários cadastrem-se e façam login no aplicativo Skoob usando suas credenciais do Facebook. | +| Contexto | O usuário está interessado em se cadastrar ou fazer login no aplicativo Skoob e possui uma conta válida no Facebook. O usuário está em qualquer local com acesso à internet. | +| Recursos | Dispositivo com acesso à internet, conta válida no Facebook. | +| Ator | Usuário do Skoob. | +| Episódios | 1. O usuário acessa a tela de cadastro ou login no aplicativo Skoob.
2. O usuário opta pela opção "Cadastrar/Login com o Facebook".
3. O sistema redireciona o usuário para a página de login do Facebook.
4. O usuário insere suas credenciais de login do Facebook (ID e senha).
5. O Facebook autentica as credenciais do usuário e autoriza o acesso ao Skoob.
6. O usuário é redirecionado de volta ao aplicativo Skoob, agora logado com suas credenciais do Facebook. | +| Restrições | O usuário deve ter uma conta válida no Facebook, e as credenciais do Facebook devem ser corretas. | +| Exceção | Se as credenciais do Facebook estiverem incorretas, o sistema exibe uma mensagem de erro. Se o usuário não tiver uma conta no Facebook, o sistema informa que a opção não está disponível para ele. | + +
+

Tabela 10: Cenário 09. (Fonte: Shaíne Oliveira, 2023).

+
+ +#### **C10: Visualizando Informações Gerais de um Livro Cadastrado** + +| Elemento | Descrição | +|-------------|--------------------------------------------------| +| Título | Visualizar Informações Gerais de um Livro Cadastrado | +| Objetivo | Permitir que os usuários acessem e visualizem informações detalhadas sobre um livro cadastrado, como sinopse, autor, quantidade de páginas, etc. | +| Contexto | O usuário está logado em sua conta no aplicativo Skoob, com acesso à internet, e deseja obter informações detalhadas sobre um livro específico. | +| Recursos | Smartphone, tablet ou computador, conexão com a internet. | +| Ator | Usuário do Skoob. | +| Episódios | 1. O usuário pesquisa um livro específico no aplicativo Skoob.
2. O usuário encontra o livro desejado nos resultados da pesquisa.
3. O usuário clica no título do livro para acessar a página de detalhes do livro.
4. O sistema exibe informações gerais, como sinopse, autor, quantidade de páginas e outras informações relevantes sobre o livro. | +| Restrições | O livro deve estar cadastrado na base de dados do Skoob, e o usuário deve ter permissão para acessar suas informações. | +| Exceção | Se o livro não estiver cadastrado na base de dados ou o usuário não tiver permissão para acessar as informações, o sistema exibe uma mensagem indicando a indisponibilidade dos detalhes. | + +
+

Tabela 11: Cenário 10. (Fonte: Shaíne Oliveira, 2023).

+
+ +#### **C11: Acessando a Aba de Lançamentos de Livros** + +| Elemento | Descrição | +|-------------|--------------------------------------------------| +| Título | Acessar a Aba de Lançamentos de Livros | +| Objetivo | Permitir que os usuários acessem a seção dedicada aos lançamentos de livros no aplicativo Skoob. | +| Contexto | O usuário está logado em sua conta no aplicativo Skoob, com acesso à internet, e deseja explorar os lançamentos mais recentes de livros. | +| Recursos | Smartphone, tablet ou computador, conexão com a internet. | +| Ator | Usuário do Skoob. | +| Episódios | 1. O usuário abre o aplicativo Skoob.
2. O usuário navega pela barra de menu ou guias na interface do aplicativo.
3. O usuário seleciona a guia "Lançamentos" ou "Novos Livros".
4. O sistema exibe uma lista dos livros mais recentes lançados no mercado. | +| Restrições | A guia de "Lançamentos" deve estar disponível e ser acessível para o usuário. | +| Exceção | Se a guia de "Lançamentos" não estiver disponível ou o usuário não tiver permissão para acessá-la, o sistema informa que a função não está disponível para ele. | + +
+

Tabela 12: Cenário 11. (Fonte: Shaíne Oliveira, 2023).

+
+ +#### **C12: Utilizando o FAQ para Guiar Usuários nas Funcionalidades** + +| Elemento | Descrição | +|-------------|--------------------------------------------------| +| Título | Utilizar o FAQ para Guiar Usuários nas Funcionalidades | +| Objetivo | Permitir que os usuários acessem o FAQ (Frequently Asked Questions - Perguntas Frequentes) no aplicativo Skoob para obter informações e orientações sobre as funcionalidades do sistema. | +| Contexto | O usuário está logado em sua conta no aplicativo Skoob, com acesso à internet, e deseja obter informações sobre como usar as funcionalidades do aplicativo. | +| Recursos | Smartphone, tablet ou computador, conexão com a internet. | +| Ator | Usuário do Skoob. | +| Episódios | 1. O usuário abre o aplicativo Skoob.
2. O usuário navega pela barra de menu ou guias na interface do aplicativo.
3. O usuário localiza a guia "FAQ" ou "Perguntas Frequentes" e clica nela.
4. O sistema exibe uma lista de perguntas frequentes e respostas relacionadas às funcionalidades do aplicativo.
5. O usuário seleciona uma pergunta que corresponde à sua dúvida ou interesse.
6. O sistema exibe a resposta detalhada à pergunta do usuário. | +| Restrições | A guia "FAQ" deve estar disponível e ser acessível para o usuário. As perguntas frequentes devem estar atualizadas e relevantes. | +| Exceção | Se a guia "FAQ" não estiver disponível ou o usuário não encontrar a resposta desejada, ele pode optar por entrar em contato com o suporte ao cliente para obter ajuda adicional. | + + +
+

Tabela 13: Cenário 12. (Fonte: Shaíne Oliveira, 2023).

+
+ + + + + + +## Bibliografia + +[1] CENÁRIOS: Rastreamento de Cenários. [S. l.]. Disponível em: .
+[2] VLC. Cenários. Grupo VLC da disciplina Requisitos de Software, disponível em: https://requisitos-de-software.github.io/2023.1-VLC/#/modelagem/cenarios. Acesso em: 16 de outubro de 2023. + +## Histórico de Versão + +| Versão | Data | Descrição | Autor(es) | Revisor(es) | +| ------ | ---------- | -------------------- | ------------- | ------------- | +| `1.0` | 11/10/2023 | Criação do documento | [Shaíne](https://github.com/ShaineOliveira) | [Ana Caroline](https://github.com/anaaroch) | +| `1.1` | 11/10/2023 | Adição de dois cenários | [Shaíne](https://github.com/ShaineOliveira) | [Ana Caroline](https://github.com/anaaroch) | +| `1.2` | 12/10/2023 | Adição dos cenários 04 e 05 | [Shaíne](https://github.com/ShaineOliveira) | [Ana Caroline](https://github.com/anaaroch) | +| `1.3` | 16/10/2023 | Atualizando "contexto" dos cenários | [Shaíne](https://github.com/ShaineOliveira) | [Ana Caroline](https://github.com/anaaroch) | +| `1.4` | 18/10/2023 | Adiciona novos cenários | [Shaíne](https://github.com/ShaineOliveira) | [Ana Caroline](https://github.com/anaaroch) | +| `1.5` | 23/10/2023 | Adiciona novos cenários | [Shaíne](https://github.com/ShaineOliveira) | Todos |