Documento de Casos de Uso MC436 – Introdução à Engenharia de Software Profª Ariadne Maria Brito Rizzoni Carvalho 1. Índice 2. 3. 4. 5. 5.1 5.2 5.3 5.4 5.5 5.6 5.7 5.8 5.9 5.10 Introdução Descrição dos atores Diagrama de caso de uso Casos de usos Comprar pacote Visualizar aquisições Selecionar pacote Selecionar opções de hotel Fazer feedback Cadastrar destino Cadastrar cliente Visualizar pacotes Cadastrar operador Acessar log do sistema www.viajarfacil.com.br 3 3 4 5 5 7 10 13 15 17 19 21 23 25 2 2. Introdução Continuando nossa especificação do sistema do site ViajarFacil.com.br, construímos agora o documento de especificação de casos de uso. Sua importância para a descrição do sistema é bastante visível: o documento deixa bem claro o que é a funcionalidade, quais são os atores que interagem sobre a mesma e qual o fluxo de atividades no caso de sucesso ou alternativo do caso de uso. A descrição escrita, associado aos diagramas de caso de uso e de sequencia, formam uma base sólida para a compreensão do programa como um todo, tanto pelo cliente quanto pela equipe de implementadores e gerentes do sistema. 3. Descrição dos atores Segue a tabela com todos os atores do sistema e suas respectivas descrições. Nome Descrição Responsabilidades Cliente Pessoa que utilizará o sistema para benefício próprio. Visualizar os pacotes disponíveis no site. Visitante Cliente que não possui cadastro no site. Herda as funções do cliente e poderá também se cadastrar no ViajarFácil. Cadastrado Cliente cadastrado no site que poderá desfrutar de todas as vantagens do sistema. Herda todas as funções do cliente. Poderá comprar um pacote, excluir o próprio cadastro, visualizar aquisições, fazer feedback e imprimir o roteiro. Operador Pessoa para gerenciar o sistema do ViajarFácil Responsável por cadastrar destinos, passeios e guias. Administrador Pessoa que terá acesso total do Herda todas as responsabilidades do operador. sistema ViajarFácil. Em específico gerencia o cadastro de operadores e outros administradores. Acessa a lista de usuários, log do sistema e pagamentos. Sistema de Reserva de Hotel Parceiro responsável por reservar o Hotel escolhido pelo Sistema do ViajarFácil Mostrar todos os hotéis disponíveis em um período de um local passado pelo ViajarFácil. Reservar o Hotel escolhido pelo sistema do ViajarFácil. Sistema de Reserva de Transporte Parceiro responsável por reservar as passagens de avião ou cruzeiro marítimo Mostrar os transportes existentes para a origem, destino e período escolhidos pelo cliente. Reservar as passagens aéreas ou marítimas da opção escolhida pelo cliente cadastrado. Sistema de Bandeira de Parceiro responsável por realizar o pagamento do Realizar o pagamento com cartões de crédito de um pacote comprado pelo cliente cadastrado. www.viajarfacil.com.br 3 Cartão pacote através de cartão de crédito do cliente. Avisar o sistema do ViajarFácil quando o pagamento for realizado. Sistema Bancário Parceiro responsável por gerar o boleto bancário de um pacote escolhido pelo cliente. Gerar o boleto bancário de um pacote com o valor fornecido pelo ViajarFácil. Avisar o sistema do ViajarFácil quando o pagamento do boleto for realizado. Tempo Ator que determinará um certo Liberar as funções que o utilizam após decorrido o período de tempo ocorrer para período estipulado algumas transações do ViajarFácil 4. Diagrama de casos de uso Abaixo está o diagrama de casos de uso do sistema ViajarFácil. www.viajarfacil.com.br 4 Os 10 casos de uso escolhidos para melhor descrição foram: visualizar pacotes, comprar pacote, selecionar pacote, selecionar opções de hotel, fazer feedback, cadastrar destino, visualizar aquisições, cadastrar cliente, cadastrar operador, acessar log do sistema. 5. Casos de uso 5.1 Comprar Pacote 1. Caso de Uso a. Breve descrição O cliente cadastrado, após selecionado o pacote, faz a compra do mesmo. O sistema registra a compra e informa ao cliente que só será confirmado as reservas após a confirmação da primeira parcela. b. Atores Cliente Cadastrado. c. Pré-condições O cliente cadastrado deve estar logado no site e já ter selecionado o pacote desejado. d. Pós-condições O sistema registra a compra no log e o cliente é redirecionado para visualizar sua aquisição. e. Requisitos funcionais Comprar pacote, selecionar pacote, visualizar pacote, selecionar opções de hotel, imprimir roteiro e executar pagamento. f. Requisitos não funcionais Confirmar a compra de pacote em até 5 minutos após o cliente clicar no botão de confirmar a compra. Os dados preenchidos pelo cliente deverão ser guardados com o padrão de segurança ABNT NBR ISO/IEC 17799 : 2005. 2. Fluxo básico a. Será mostrada uma tela com todas as escolhas dele: i. Hotel com estrelas e faixa de preço www.viajarfacil.com.br 5 ii. Destino, origem, período iii. Avião ou cruzeiro selecionado iv. Opções de passeio (caso tenha sido escolhido) v. Guia (caso tenha sido escolhido) vi. Preço total b. O cliente confirma as opções. c. É direcionado para <Include>(Executar Pagamento). d. Após confirmar o pagamento será feito <Include>(Reservar Pacote). e. Os dados da compra do cliente são registrados no log do sistema. f. O cliente é redirecionado para a tela de (Visualizar Aquisições), onde pode verificar o status da sua compra. 3. Fluxos alternativos a. No passo “b” o cliente poderá não confirmar as opções e então será redirecionado para a tela de (Visualizar pacotes). b. No passo “c”, o pagamento pode não ter sido efetuado e as reservas não são feitas. O sistema atualiza o status de (Visualizar Aquisições) para cancelamento de compra. O cliente pode fazer um novo (Selecionar Pacote) e começar o processo de novo. c. No passo “d” alguma reserva pode não ser realizada e então a compra é cancelada e o dinheiro é devolvido ao cliente. 4. Diagrama de sequência a. Cenário de sucesso www.viajarfacil.com.br 6 b. Cenário excepcional 5.2 Visualizar Aquisições 1. Caso de usos a. Breve descrição O cliente cadastrado, após logado no sistema e se já tiver feito uma compra pelo sistema, poderá visualizar em uma janela todas as aquisições feitas. Na mesma janela é possível selecionar o pacote já adquirido e visualizar mais detalhes sobre o mesmo. Se a viagem ainda não foi realizada o cliente pode <Extend>(Cancelar pacote). b. Atores Cliente Cadastrado c. Pré-condições O cliente cadastrado deve estar logado no site e já ter comprado ou reservado pelo menos um pacote. d. Pós-condições O sistema abre uma tela com uma lista simplificada (contendo hora/data da compra, hora/data e destino da viagem e código da aquisição) e cada item selecionado pelo cliente na lista o sistema abre www.viajarfacil.com.br 7 uma outra tela contendo mais detalhes sobre pacote. Se cancelado o pacote o sistema envia uma mensagem para o operador e administrador para que eles possam analisar o caso e realizar as devidas medidas. e. Requisitos funcionais Visualizar aquisições. f. Requisitos não funcionais Interface simples e intuitiva e a funcionalidade deve ser confiável (somente o próprio cliente cadastrado poderá visualizar as informações dos pacotes que adquiriu e/ou cancela-los). 2. Fluxo básico a. Será mostrado uma tela com as aquisições de pacotes feitas pelo cliente de forma simplificada contendo em uma cada linha: i. Código da aquisição; ii. Data e hora da aquisição; iii. Destino da viagem; iv. Data e hora de partida da viagem; v. Status da aquisição. b. Se selecionada um pacote o sistema abre uma janela com informações mais detalhadas sobre o pacote contendo: i. ii. iii. iv. v. vi. vii. viii. ix. x. xi. Código da aquisição; Destino, origem; Data e hora de partida da viagem; Data e hora de retorno da viagem; Local de partida e de retorno; Hotel onde será hospedado; Avião ou cruzeiro selecionado; Opções de passeio (caso tenha sido escolhido); Guia (caso tenha sido escolhido); Preço total e parcelas; Status da aquisição do pacote: não confirmada: pacote foi somente selecionado a partir do sistema. confirmada: foi realizado o pagamento de pelo menos a primeira parcela. concluída: viagem realizada e pagamento realizado totalmente. cancelada: pacote cancelado pelo cliente ou operador/administrador. www.viajarfacil.com.br 8 xii. xiii. xiv. Motivo do cancelamento (Se houver cancelamento por parte do administrador/operdor); Prazo de cancelamento; Prazo dos pagamentos. c. Se selecionado a ação de <Extend>(Cancelar pacote) o sistema envia uma mensagem para o operador e o administrador analisarem o caso. d. Se o pacote for cancelado por qualquer motivo seu status muda pra “cancelado”. e. Se um pacote da lista está com o status “cancelado” por mais de um mês ele é removido de (Visualizar Aquisições). f. Todas as modificações feitas em (Visualizar Aquisições) são registradas no log do sistema. 3. Fluxos alternativos a. A qualquer momento o sistema poderá cancelar a viagem e então todo o dinheiro já pago pelo cliente será devolvido. O administrador altera o status em (Visualizar Aquisições) com o motivo do cancelamento. 4. Diagrama de sequência a. Cenário de sucesso b. Cenário excepcional www.viajarfacil.com.br 9 5.3 Selecionar Pacote 1. Caso de usos a. Breve descrição O cliente após estar logado no sistema pode montar o seu pacote de viagem selecionando várias opções que o pacote pode oferecer, como: origem, destino, hotel, período, transporte, passeios locais e guia. b. Atores Cliente Cadastrado c. Pré-condições O cliente cadastrado deve estar logado no sistema. d. Pós-condições O sistema abre uma tela com a lista final das opções selecionadas sobre o pacote, registra o pacote no log do sistema, coloca os dados do pacote em (Visualizar Aquisições) e redireciona o cliente para (Comprar Pacote). e. Requisitos funcionais www.viajarfacil.com.br 10 Selecionar pacote, comprar pacote. visualizar pacotes. f. Requisitos não funcionais As opções devem ser de fácil entendimento, a lista final deve ser mostrada em no máximo 10 segundos e ela deve ser simples e intuitiva. 2. Fluxo básico a. b. c. d. e. f. 3. Será mostrado na tela uma lista de opções simplificadas e intuitivas sobre cada item a seguir: i. Origem; ii. Destino; iii. Período; iv. Hotel; v. Transporte; vi. Passeio (sim ou não); vii. Guia (sim ou não); Após selecionadas as opções simplificadas passa-se para uma nova pagina com opções mais detalhadas e específicas de cada item da lista anterior selecionada. Caso não haja um opção mais detalha mostra-se somente a opção anteriormente escolhida. Após a seleção do item “b” mostra-se o pacote final e o cliente deve confirmá-lo. Após a confirmação, o cliente é redirecionado para (Comprar Pacote). O sistema registra no log o pacote selecionado pelo cliente. O sistema manda os dados do pacote para (Visualizar Aquisições). Fluxo alternativo a. Quando o cliente entrar no item “b” do fluxo básico ele pode querer modificar algo já selecionada anteriormente pelo item “a”. Voltando para a pagina anterior todos o itens selecionados pelo cliente ainda estará selecionado. b. No item “c” do fluxo básico o cliente pode não confirmar o pacote final podendo assim retornar tanto para o item “a” ou item “b” do fluxo básico. 4. Diagrama de sequência www.viajarfacil.com.br 11 a. Cenário de sucesso b. Cenário excepcional www.viajarfacil.com.br 12 5.4 Selecionar Opções de Hotel 1. Caso de usos a. Breve descrição O cliente pode, durante a seleção de pacote em (Selecionar Pacote), filtrar as possibilidades por meio da categoria do hotel (estrelas) e da faixa de preço que deseja pagar. Ao selecionar um hotel, poderá verificar a disponibilidade num certo período e ler possíveis indicações. b. Atores Clientes cadastrados c. Pré-condições O cliente cadastrado deve estar logado no sistema e estar na pagina de (Seleciona Pacote). d. Pós-condições O sistema recebe a opção escolhida e junta com as outras de (Selecionar Pacote). e. Requisitos funcionais Selecionar pacote, visualizar pacote. f. Requisitos não funcionais A interface deve ser simples e intuitiva e a lista de hotéis deve ser formada e mostrada em no máximo 10 segundos. 2. Fluxo básico a. Em (Selecionar Opções de Hotel) o cliente informa os seguintes itens: i. Categoria do hotel; ii. Faixa de preço. b. Em outra pagina de (Selecionar Opções de Hotel) o sistema mostra para o cliente as possibilidades de hotéis de acordo com as opções escolhidas por ele. c. O cliente escolhe o hotel. d. O sistema deixa selecionado o hotel em (Selecionar Pacote). e. O cliente continua em (Selecionar Pacote). www.viajarfacil.com.br 13 3. Fluxo alternativo a. No item “b” do fluxo básico o cliente pode clicar em uma opção de hotel para ver a disponibilidade e possíveis indicações. b. Em “e” do fluxo básico o cliente pode mudar de ideia sobre o hotel escolhido anteriormente. Assim volta para a seleção de hotel. c. Após o item “a” pode não haver hotel na especificação escolhida pelo cliente, assim o cliente deve modificar os dados sobre categoria do hotel e faixa de preço até que haja um hotel que se encaixe nas especificações. 4. Diagrama de sequência a. Cenário de sucesso b. Cenário excepcional www.viajarfacil.com.br 14 5.5 Fazer Feedback 1. Caso de Uso a. Breve descrição O cliente cadastrado poderá, logo após o fim do período da viagem do pacote comprado, enviar um feedback sobre a experiência de utilizar os serviços oferecidos pelo ViajarFacil.com.br. O preenchimento do mesmo é opcional. b. Atores Cliente Cadastrado e Tempo c. Pré-condições O Cliente deve estar logado no site ter adquirido um pacote e a data de acesso ao sistema deve ser superior à data de fim do período de viagem do pacote adquirido. d. Pós-condições Ao término do preenchimento, o cliente recebe na tela uma mensagem de agradecimento e é redirecionada, depois de 5 segundos para a tela de visualizar pacote. O log do sistema é atualizado e o administrador por visualizar o feedback emitido pelo cliente. e. Requisitos funcionais Fazer Feedback, cadastrar passeio, cadastrar guia. www.viajarfacil.com.br 15 f. Requisitos não funcionais O questionário de feedback deverá conter perguntas com alternativas, obrigatoriamente conterá a pergunta “De 0 a 10, quanto você indicaria o ViajarFacil.com.br para um amigo” e o cliente deverá ser capaz de preenchê-lo integralmente em, no máximo, 10 minutos. 2. Fluxo básico a. Período da viagem comprada se encerra e a opção de feedback fica disponível na tela de visualizar pacotes b. Cliente seleciona opção de fazer o feedback c. Questionário é respondido e enviado d. Mensagem de agradecimento é exibida e. Cliente retorna para a tela de Visualizar Pacotes 3. Fluxos alternativos No passo d, o cliente pode não querer responder todo o questionário no momento, então nesse caso ele selecionará a opção de salvar o questionário respondido até o momento e retornar para a tela de Visualizar Pacotes. 4. Diagrama de sequência a. Cenário de sucesso b. Cenário Excepcional www.viajarfacil.com.br 16 5.6 Cadastrar destino 1. Caso de Uso a. Breve descrição O Operador do Sistema poderá cadastrar novos destinos para a venda dos pacotes turísticos. O Sistema de Reserva do Hotel receberá as informações do novo destino cadastrado para fornecer a lista de vagas disponíveis para o mesmo. a. Atores Operador do Sistema c. Pré-condições O Operador deve estar logado na parte de administração do sistema. d. Pós-condições Após o cadastro, o novo destino ficará disponível para escolha dos clientes do ViajarFacil.com.br. Log do sistema é atualizado. e. Requisitos funcionais Cadastrar destino, cadastrar passeio e cadastrar guia. www.viajarfacil.com.br 17 f. Requisitos não funcionais Cadastro deve ser preenchido em, no máximo, 15 minutos. 2. Fluxo básico a. Operador do Sistema insere os seguintes dados do novo destino: 1. Nome do local; 2. País; 3. Clima; 4. Pontos turísticos; b. Operador do sistema insere novo extend<Cadastrar Guia> c. Operador do sistema insere novo extend<Cadastrar Passeio> d. Informações do destino são enviadas para o Sistema de Reserva de Hotel e. Novo destino fica disponível na lista de pacotes para venda 3. Fluxos alternativos a. O passo c é opcional, sendo que o Operador do sistema pode cadastrar um novo Guia (através de extend<Cadastrar Guia>) em qualquer momento posterior ao cadastro do Destino. b. O passo d é opcional, sendo que o Operador do sistema pode cadastrar em novo Passeio (através de extend<Cadastrar Passeio>) em qualquer momento posterior ao cadastro do Destino. 4. Diagrama de sequência a. Cenário de sucesso b. Cenário Excepcional www.viajarfacil.com.br 18 5.7 Cadastrar Cliente 1. Caso de Uso a. Breve descrição O cliente Visitante do ViajarFacil.com.br pode se cadastrar no site, tendo então acesso liberado à aquisição de pacotes de viagem. b. Atores Cliente Visitante c. Pré-condições Cliente Visitante deve ter entrado no site do ViajarFacil.com.br e acessado a página de cadastro d. Pós-condições Liberada a aquisição de pacotes para o usuário, log do sistema é atualizado. e. Requisitos funcionais Cadastrar Cliente, Visualizar pacotes. f. Requisitos não funcionais Cliente deve ser capaz de se cadastrar em, no máximo 5 minutos. 2. Fluxo básico www.viajarfacil.com.br 19 a. Cliente visitante acessa a página de cadastro do ViajarFácil.com.br b. Cliente preenche o formulário 1. Nome completo; 2. RG; 3. CPF; 4. Data de Nascimento; 5. Estado Civil; 6. Endereço residencial; 7. Telefone fixo; 8. Celular; 9. Nome de Usuário; 10. E-mail; 11. Senha de login; 12. Como conheceu o site; c. Cliente recebe confirmação por e-mail d. Log do sistema é atualizado e. Cliente ganha acesso à aquisição de pacotes 3. Fluxos alternativos a. O passo “b” pode não ser concluído, neste caso o cadastro não é realizado e o cliente volta para a página inicial b. O passo “c” pode não se completar por problemas com e-mail inválido do cliente, neste caso, o cliente terá de fazer um cadastro novo, com um e-mail válido. 4. Diagrama de sequência a. Cenário de sucesso www.viajarfacil.com.br 20 b. Cenário Excepcional 5.8 Visualizar pacotes 1. Caso de Uso a. Breve descrição Os clientes, cadastrados ou visitantes, poderão visualizar os pacotes oferecidos pelo ViajarFacil.com assim que acessarem o site. b. Atores Cliente Cadastrado e Visitante c. Pré-condições O cliente deve entrar na seção do site correspondente à visualização dos pacotes. d. Pós-condições www.viajarfacil.com.br 21 Selecionado o pacote, o cliente é redirecionado para página de login do sistema, com a finalidade de dar continuidade ao processo de compra do pacote. e. Requisitos funcionais Visualizar pacotes f. Requisitos não funcionais As informações dos pacotes devem ser claras e objetivas. O sistema deverá mostrar datas de viagem marcadas para o pacote, meio de transporte, passeios e principais locais de visita. A diagramação e restrição de espaço devem ser respeitadas, de tal forma que o número de informações seja restrito, podendo o cliente averiguar as demais assim que clicar no pacote para mais detalhes. Além disso, deve haver paginação se o número de pacotes ultrapassar 10, de tal forma que a estética do site seja preservada. 2. Fluxo básico a. Cliente entra no site b. Seleciona a seção de pacotes. c. Cliente seleciona o pacote que lhe interessa, clicando no botão "informações" para conhecer os detalhes do pacote (período de viagem, origem, destino, vôo ou cruzeiro, hotel, guia e preço). 3. Fluxos alternativos O passo "c" pode não ser concluído, de tal forma que o sistema não exiba as informações do pacote. Neste caso, deve retornar à tela de pacotes e exibir uma janela de erro ao usuário, solicitando-lhe nova tentativa. 4. Diagrama de sequência a. Cenário de sucesso www.viajarfacil.com.br 22 b. Cenário Excepcional 5.9 Cadastrar operador 1. Caso de Uso a. Breve descrição www.viajarfacil.com.br 23 O administrador poderá cadastrar operadores do sistema e outros administradores. b. Atores Administrador do sistema. c. Pré-condições O administrador deve estar logado na parte de administração do sistema. d. Pós-condições O banco de dados de usuários do sistema é atualizado. O novo usuário passa a estar disponível para login. Sistema volta para o painel de administração. e. Requisitos funcionais Cadastrar operador f. Requisitos não funcionais O tempo de resposta do sistema, ao finalizar o cadastro, deve ser inferior a 10 segundos. 2. Fluxo básico a. Administrador do sistema seleciona Cadastrar operador na seção de administração do sistema. b. Administrador do sistema insere dos dados do novo operador (usuário e senha). c. Administrador do sistema clica no botão salvar. 3. Fluxos alternativos a. O passo "a" pode falhar, caso o usuário insira a senha errada. O sistema volta à tela de login, informando que a entrada da senha foi incorreta. b. O passo "d" pode não ser concluído caso os campos usuário e senha não respeitam o número mínimo de caracteres (seis) ou o padrão de encriptação adotado (obrigatoriamente composta por caracteres alfanuméricos). Neste caso, o sistema informa o erro ao operador do sistema, indicando o campo a ser corrigido (ou ambos, se for o caso). 4. Diagrama de sequência www.viajarfacil.com.br 24 a. Cenário de sucesso b. Cenário Excepcional 5.10 Acessar log do sistema 1. Caso de Uso a. Breve descrição www.viajarfacil.com.br 25 O sistema deverá conter um log com todas as transações efetuadas pelo cliente (seleção, compra, pagamento, impressão), operador (inclusão/exclusão/edição de destino, guia, passeio) e administrador (inclusão/exclusão/edição de operador, acesso de pagamento). b. Atores Administrador c. Pré-condições O operador do sistema deve estar logado na parte de administração do sistema. d. Pós-condições O sistema deve exibir uma lista com todas as modificações feitas por usuários do sistema, sejam transações do cliente, ações do operador ou do administrador. Essa lista é passível de filtro por ator (cliente, operador de sistema ou administrador), por ação (cliente: seleção, compra, pagamento ou impressão; operador: inclusão/edição/exclusão de destino, guia ou passeio; administrador: inclusão/edição/remoção de operador, acesso aos pagamentos) . e. Requisitos funcionais Acesso ao log do sistema. f. Requisitos não funcionais O log deverá ser gerado em até 15 segundos. 2. Fluxo básico a. Administrador do sistema faz login no sistema b. Administrador do sistema acessa seção de log do sistema. c. Administrador do sistema seleciona filtros adequados para geração do log esperado. 3. Fluxos alternativos a. O passo "c" pode não ser concluído, de tal forma que o sistema exiba o log inteiro ao invés de uma parte (filtrada do todo). 4. Diagrama de sequência www.viajarfacil.com.br 26 a. Cenário de sucesso b. Cenário Excepcional Diego Zilioti Fabiano de Sousa - RA: 090914 Diego Sanches Rubini - RA: 090927 Murilo Travarelli - RA: 094985 Roberto Hirozaku Usui - RA: 095960 Tiago de Lima Ferreira - RA: 093120 www.viajarfacil.com.br 27