Please enable JavaScript.

Coggle requires JavaScript to display documents.

Bibliotecar, Circulação, Catalogação (Apenas para funcionário),…

- - - - O funcionário insere o CPF do leitor, seleciona um exemplar disponível e configura a data de devolução.
        Ao inserir o CPF do usuário, é realizada uma requisição que resgata todos os livros emprestados para aquele leitor (com data de empréstimo e de devolução).
        Se o leitor estiver bloqueado pela biblioteca, aparece uma listagem de bloqueios abertos e o funcionário pode liberar o usuário com a ação de pagar e desbloquear ou simplesmente cancelar a ação do empréstimo.
        Algumas observações
        
        Nem todo funcionário pode realizar o empréstimo de um livro. Como foi comentado na Página do Livro, é necessário ter uma permissão para realizar o empréstimo. O nome dessa permissão é :unlock: Criar empréstimo
        
        Ao "bloquear" um leitor, ele fica bloqueado apenas para aquela biblioteca a qual o funcionário pertence, mas ainda desbloqueado para as demais bibliotecas do sistema
        
        Lista de livros emprestados é composta apenas por livros da mesma biblioteca do funcionário, não mostrando empréstimos de outras bibliotecas.
- - - - Cadastrar
        
        O campo base para verificar se um usuário já existe na aplicação é o campo CPF. Se um usuário adicionar um CPF já cadastrado no sistema uma mensagem o informa e o impossibilita de continuar. Porém, se um CPF novo for inserido e um e-mail inserido já tenha sido registrado na aplicação, ao clicar para se cadastrar uma mensagem bloqueia o usuário de dar continuidade.
        Informações extras
        
        O CEP utiliza uma API dos Correios para preencher os campos
        
        Foi alinhado que os campos Estado e Cidade são campos bloqueados, pois num futuro há interesse de realizar relatórios.
        
        No XD não consta, mas também foi inserido o gênero com o mesmo objetivo do tópico anterior: compor os relatórios.
        
        Desenvolvimento
        Essa mesma tela é utilizada diversas vezes na aplicação, com diferentes fluxos/regras de negócios, pois reutilizamos a estrutura para o cadastro de um novo leitor, cadastro de um novo funcionário, edição de leitores/funcionários e visualização do perfil de leitores/funcionários
        Para criar um leitor ou funcionário é necessário uma permissão chamada :unlock:Criar usuário, e quando um funcionário cria um usuário ele é automaticamente vinculado à mesma biblioteca do funcionário que o registrou, dando permissão para qualquer outro funcionário da mesma biblioteca (desde que tenha permissão) para editar e alterar os dados do novo usuário. A permissão para editar uma conta se chama :unlock:Editar usuário, também podendo resetar sua senha, por exemplo
        Agora, se um usuário cria sua própria conta, ela não está vinculada a nenhuma biblioteca. Se o usuário esquecer a sua senha hoje o sistema não permite nenhuma forma de recuperar, pois não há e-mails transacionais ou ação de recuperar senha na plataforma.
    - - Livros mais procurados
        
        A pesquisa por livros mais procurados tem algumas regras aplicadas:
        
        Os livros considerados nessa listagem são apenas dos últimos 30 dias. Se não houver livros "populares" nesse período de tempo, não há nada para compor a listagem, logo essa tela é "resetada".
        
        O que define um livro como "popular"?
        Foi definido que uma ação desencadeiam um "contador" para cada livro:quando um usuário logado na plataforma com as características de um usuário leitor (ou seja, sem um "libraryId" associado), esse evento é disparado e +1 é adicionado no contador daquele livro. Se um funcionário ou um usuário não logado acessa esse livro a requisição não é disparada. Além disso, uma observação: o evento é disparado uma única vez, pois é registrado na sessão do usuário atual (localStorage). Se o usuário deslogar e logar novamente e acessar o mesmo livro, nesse cenário, o evento será disparado novamente.
        Agrupamento por biblioteca
        Os agrupamentos são realizados de acordo a quantidade de "popularidade" dos livros para cada biblioteca
        :red_flag: Mudanças
        
        Como foi comentado, apenas usuários que não possuem um libraryId associado à sua conta podem disparar esse evento, mas com as mudanças que vão vir por conta do uso do aplicativo Lerall será necessário revisitar esse trecho do sistema, pois todos os registros na plataforma agora terão um libraryId associado, mesmo que de uma biblioteca privada" gerada de forma automática.
        
        É necessário corrigir a busca para "biblioteca de origem" > "bibliotecas da mesma cidade" > "demais resultados"
        
        Disponibilidade dos livros
        Os livros possuem um valor de disponibilidade baseado na quantidade de exemplares não reservados e emprestados. Quando um livro tem todos os seus exemplares emprestados e/ou reservados, fica indisponível dentro do sistema. Para fazer o empréstimo e/ou reserva é obrigatório ter um exemplarId associado, isso deve se estender para o Lerall
- - - - Empréstimos
        
        Meus empréstimos
        (Apenas para funcionário)
        
        Minhas reservas
        (Apenas para funcionário)
        
        Um funcionário pode ter reserva de livros na plataforma disponibilizados por outras bibliotecas, então para enxergarmos esse perfil com características de leitor foi necessário criar essa página. Em resumo, o funcionário tem a lista de todas as reservas de livros que foram realizados
        
        Um funcionário pode ter empréstimo de livros na plataforma disponibilizados por outras bibliotecas, então para enxergarmos esse perfil com características de leitor foi necessário criar essa página. Em resumo, o funcionário tem a lista de todos os empréstimos de livros que foram realizados, listando os livros de qualquer biblioteca - incluindo a qual ele trabalha
        
        Contexto de funcionário
        São listadas todos os empréstimos realizados por funcionários (de uma mesma biblioteca) no sistema. O funcionário possui as seguintes ações:
        
        Devolução: registrar devolução do livro no sistema
        
        Renovar: estender prazo de devolução de um empréstimo
        
        Devolução com atraso
        Grupo de ações aparece para o funcionário, sendo as ações permitidas:
        
        Registrar devolução aplicando taxa de atraso (valor equivalente a "multa" que foi alinhado)
        
        Registrar devolução e bloquear usuário até X data
        
        Apenas registrar devolução, sem aplicação de taxa ou bloqueio do usuário.
        
        As duas primeiras ações só ficam disponíveis caso o usuário possua a permissão de criar suspensões
        Para criar um empréstimo é necessário a permissão :unlock:Criar empréstimo.
        
        Contexto de leitor
        São listadas todos os empréstimos realizados para o perfil
      - Contexto de funcionário
        São listadas todas as reservas realizadas por leitores dentro da plataforma para a biblioteca do funcionário logado. Nessa página, o usuário pode realizar as seguintes ações:
        
        Emprestar um livro: converte uma reserva em um empréstimo, com as mesmas características citadas no Empréstimo do Livro, com a diferença de que o funcionário não precisa inserir o CPF do leitor nem escolher o exemplar, pois por padrão isso é salvo automaticamente. Resta apenas configurar a data de devolução e realizar o empréstimo;
        
        Cancelar reserva: Exclui a reserva do sistema
        
        Além disso, as reservas são listadas com as seguintes características: Aguardando retirada (ou pendente), Confirmada e Cancelada
        Para realizar essa ação o funcionário deve possuir as permissões de :unlock: Editar reserva e :unlock:Criar empréstimo
      - Contexto de leitor
        São listadas todas as reservas realizadas pelo perfil
- - - - Ação que gera um link que pode ser compartilhado com outras pessoas e só é disponibilizada para um perfil "funcionário".
        Esse link possui é composto por:
        Ambiente da aplicação + 'libraryToken' + token da biblioteca
        Quando é acessado, esse token fica salvo no navegador (storage) do usuário e dependendo de qual o contexto que ele se aplica uma ação é executada:
        
        Usuário possui conta, mas não está logado: ao se logar, o sistema confere se há alguma informação do storage do usuário e se possuir um 'libraryToken" dispara uma requisição associando o perfil do usuário com a biblioteca
        
        Usuário possui conta e está logado: ao ser redirecionado para o sistema, automaticamente é disparada uma requisição e esse usuário passa a estar vinculado com a biblioteca
        
        Usuário não possui conta: ao se cadastrar no sistema, automaticamente é disparada uma requisição e esse usuário passa a estar vinculado com a biblioteca
        
        Em todos os três cenários, após o vínculo estar estabelecido o token é removido do storage para que novos registros naquela máquina não sejam influenciados