Biblioteca Digital

Aplicação Web para Gerenciamento de Biblioteca

Index	Home	Cadastro

Este release notes tem como objetivo apresentar a versão 1.0.0 do projeto de gerenciamento de uma biblioteca com suas funcionalidades atuais e futuras.

a.Data de liberação:

No dia 22 de Maio de 2018 foi entregue a Biblioteca Digital Solution versão 1.0.0

b.Funcionalidades implementadas

• Cadastro manual de usuário
• Validação de login
• Validação de usuário (admin)
• Consulta de livros
• Cadastro manual de livros (admin)
• Busca automatizada de detalhes do livro com uso da API do Google (admin)
• Prazo máximo de duração do empréstimo (07 dias)
• Empréstimo de livros (máximo um livro por usuário)
• Reserva de livros (máximo uma reserva por usuário)
• Notificação de efetuamento de empréstimo de livros (via email)
• Notificão de alerta para a devolução de livros (via email à partir do 5º dia do prazo do empréstimo)
• Notificação de disponibilidade do livro
• Notificação de disponibilidade de reserva
• Devolução de livros
• Relatar avarias do livro (admin)

c.Funcionalidades não implementadas

• Uso do login da Cognizant (SSO)
• Sugestão de livros caso ele não exista no sistema
• Renovar empréstimo do livro
• Usuário admim pode gerenciar outros usuários (admin)
• Bloqueio da página do usuário (botões),caso ele não devolva o livro no prazo determinado (até que ele devolva o livro)
• Geração de relatórios de livros por meio de filtro por categorias (acesso para o usuário)
• Amostra de livros em destaque
• Lista de livros desejados pelo usuario (Wish List :heart:)
• Mostrar livros mais procurados no mês
• Mostrar o Top 10 dos usuarios do aplicativo (os que mais lêem)
• Tela para o admin ver os livros sugeridos pelo usuário (admin)
• Usuário poderá pegar mais livros emprestados de uma única vez (empréstimo curto prazo)
• Mais reservas poderão ser feitas por unidade de livro
• Recomendações de livros entre usuários
• Sugestão de leitura
• Tela para o admin com lista de livros sugeridos pelos usuários (admin)
• Empréstimo de curto prazo
• Tela com lista de emprestimos para poder ser editada pelo usuário
• Notificação de prazo de reserva do usuário para o admin (admin)
• Exportar informações de reserva para a agenda do usuário
• Pop-up com as avarias do livro (página de detalhes do livro)
• Perfil do usuário no menu
• Funcionalidade do botão de esqueci minha senha
• Página do perfil do usuário
• ID ao invés do e-mail & excluir um campo do formulário (Ex.: enviar e-mail com 695042@cognizant.com)
• Favicon (...!)

Tools used:

• Eclipse EE 4.4.0/4.7.3a*;
• MySQL 5.7.7*;
• Maven;
• Hibernate;
• Spring;
• Thymeleaf 3.0.9;
• Bootstrap 4.1.0;

• and Markdown:octocat:.

  * Open a Software Request in OneIT.

Problemas Conhecidos

Lógica Empréstimo/Reserva/Wishlist

Problema na lógica da integração das regras de negócio quando se há mais de um empréstimo por livro e por usuário. Limitamos a quantidade de empréstimos por livro para o máximo de 01 empréstimo e máximo de 01 reserva

Mais de um livro por ISBN

Não há uma regularização sobre o ISBN ser único mundialmente. Na API do Google, houve casos em que encontramos +27 livros para um mesmo ISBN.

Outros problemas

Aqui temos um histórico dos últimos bugs que encontramos --> Issues

Como começar

Utilizando o Git (GitHub) em equipe

Optamos por utilizar o GitHub como ferramenta para gerenciamento de versão num repositório privado.

Se o projeto continuar nele, sugerimos que planejem os processos de utilização dessa ferramenta utilizando a sugestão do Github e deixar a Master somente para versões disponíveis para uso do usuário final (restrita), uma branch de Homologação (restrita), e uma branch para cada dev (se estiverem em pair-programing, uma para os dois).

Também indicamos a utilizar a aba Issues para tracking de bugs (se necessário) e a aba Projects (ou, como nós, o Trello) para gerenciar o projeto.

Comecem clonando o repositório com o GitHub Desktop

Importem o projeto para o Eclipse e deixem o Maven cuidar das dependências (Spring, Hibernate, ThymeLeaf) Criem um banco com o nome de "biblioteca_db", o Hibernate se encarregará de criar as tabelas.

Thymeleaf como motor de templates construídos com Bootstrap

Todas as páginas são geradas utilizando templates "tageados" com Thymeleaf. Os templates ficam em resources/templates.

:star: UI Kit Design :star:

Foi montada a UI Kit Design para guiar a identidade visual da aplicação. Consulte-a no repositório base

Documentação e Fluxograma

Documentamos grande parte do software e criamos o fluxograma para auxiliar no entendimento Encorajamos a utilização da documentação de forma colaborativa e sempre pensando em quem lerá ela. Corrijam, ampliem, melhorem :)

Consulta API Google Books

A consulta através do ISBN do livro é realizada no Front-End utilizando JavaScript Após inserir um ISBN, os detalhes do livro serão preenchidos automaticamente Lembre-se: O erro relatado sobre um ISBN para mais de um livro. Caso haja mais de um, o primeiro relacionado será preenchido

Contribuições

1º Graduation Program:

Alexandre	Bruno	Diego	Francisco :octocat:	Iury
Guilherme	Jackson	Luís Ângelo :octocat:	Philipe	Raquel

Scrum Master

Márcio - Scrum Master

2º Graduation Program:

###Preencher###

Versionamento

Nós recomendamos utilizar o SemVer para versionamento. Para verificar as versões disponíveis da Biblioteca Digital, veja as tags no repositório.

README.MD > README.PDF

Utilizamos o site MarkDown to PDF para converter o documento no formato .MD para .PDF, entretanto por se tratar de um repositório privado, alguns links podem quebrar :cry:. Para isso, realizamos algums correções pontuais no .PDF em Small PDF

Indicamos o uso do README.MD dentro do repositório como documento primário