LibraryFree

Escopo

• Aplicação web e mobile voltada para controle, doação e empréstimo de livros que permite:

1. Cadastrar todos os livros que o usuário possui ou que ele deseja adquirir
2. Aos usuários Incluir organizações que permitirão o movimento de livros
3. Solicitar os livros via sistema e aprovação/negação pelo dono
4. Selecionar o processo de entrega (pessoal, Correios, Malote, etc) pelos usuários
5. Pontuar de acordo com os empréstimos realizados de forma a ser qualificado publicamente.
6. Disponibilizar um Chat para contato
7. Gerenciar os empréstimos e devoluções notificando prazos e gerando multas quando houver atrasos
8. Solicitar feedbacks após o empréstimo e/ou devolução

Requisitos Funcionais

1. CRUD de Livros (Júlia)
   1. Criar uma página para cada operação do CRUD
   2. Verificar se o usuário tem permissão para realizar a operação
2. CRUD de Usuário (Júlia)
   1. Criar uma página para cada operação do CRUD
   2. Verificar se o usuário tem permissão para realizar a operação
3. Buscar livros disponíveis para empréstimo (Gustavo)
   1. Receber os termos da busca por um campo (linha de formulário)
   2. Realizar a busca no banco de dados (SELECT)
   3. Filtrar os resultados por localidade, datas, valor, gênero ou popularidade
   4. Permitir múltiplos filtros simultaneamente
   5. Exibir o resultado da pesquisa em uma página
4. Reservar livro disponível (Gustavo)
   1. Exibir somente livros disponíveis
   2. Página para reserva de livros
   3. Requerir um livro não disponível
5. Avisar de datas para devolução (Marc Sué)
   1. Enviar e-mail / sms de aviso um dia antes da data de devolução
6. Capturar ISBN do livro (Marc Sué)
   1. Criar função para ativar a câmera do smartphone para capturar o código do ISBN no momento de cadastro do livro
   2. Criar função para digitar o código do ISBN no momento do cadastro do livro
7. Dispor Livros em estantes virtuais conforme gênero (Pedro)
   1. Realizar a busca no banco de dados (SELECT) dos gêneros que o usuário possui
   2. Para cada estante. realizar a busca no banco de dados (SELECT) dos livros que pertencem aquele gênero
   3. Exibir o resultado da pesquisa em uma página
8. Permutar livros (Luana)
   1. Informar uma lista de usuários que desejam trocar livro(s) que não possuem, por outro(s) possuem
9. Emprestar livros (Luana) (Marc Sué)
   1. Catálogo de livros dos usuários
   2. Informar endereço do usuário que está pedindo o livro, o tempo que o deseja ter e a reputação atual do usuário
   3. Calcular frete, emitir etiqueta, informar prazo para devolução (além do tempo de entrega)
10. Devolver livros (Ademar)
    1. Informar endereço de retorno ao dono do livro
    2. Calcular frete e emitir etiqueta para devolução
    3. Qualificar usuário pelo empréstimo e pela devolução
11. Vender livros (Mateus)
    1. Receber num formulário o preço e as opções de frete oferecidas pelo vendedor
    2. Atualizar o livro no banco de dados (UPDATE) marcando-o como posto à venda
    3. Disponibilizar um botão para que interessados possam entrar em contato com o vendedor
12. Gerenciar livros emprestados (Leonardo)
    1. Realizar a busca no banco de dados (SELECT) dos livros, filtrando para ter como resultado somente aqueles que estão emprestados
    2. Exibir o resultado da pesquisa em uma página
13. Prorrogar data de devolução
    1. Exibir formulário para receber a mensagem de prorrogação e a quantidade de dias
    2. Enviar solicitação via e-mail para o dono do livro
    3. Aumentar (ou não) o prazo de devolução de acordo com a resposta do dono
    4. Enviar e-mail de confirmação (ou não confirmação) da prorrogação ao solicitante
14. Qualificar usuário
    1. Criar atributo de créditos do usuário (positivo, negativo e neutro)
    2. Criar função para qualificar o usuário após um empréstimo / venda
    3. Qualificar solicitante e atendente do pedido de empréstimo / venda
15. Formar "lista de espera" para livros
    1. O usuário solicita um livro já emprestado e fica na "lista de espera" dele
    2. Sua posição na lista de espera é classificada tanto por data de solicitação quanto por créditos (qualificação)
16. Gerar etiqueta de identificação
    1. Gerar um código de barras para cada livro cadastrado
    2. Salvar automaticamente código de barras nas informações do livro

Tarefas (para o Treinamento)

Gerais (todos devem fazer)

1. Resolver os exercícios de Python no URI
2. Realizar o fork do projeto no GitHub
3. Fazer, pelo menos, um pull request ao projeto
4. Desenhar pelo menos uma tabela do diagrama do banco de dados
5. Contribuir com o desenvolvimento do projeto web final (escolher tarefa específica)
6. Seguir as regras da pep-8 (bônus)
7. Criar um nome mais comercial

Específicas

1. Documentar o projeto
2. Criar o script de teste unitário do projeto
3. Implementar a busca de livros com filtros
4. Implementar o CRUD de Livros
5. Implementar o cadastro, login/logout e perfil do usuário
6. Implementar as páginas de exibição dos livros por categoria/filtro
7. Implementar o sistema de permutação
8. Implementar o sistema de empréstimo
9. Implementar o sistema de devolução
10. Implementar o sistema de negociação de prazos
11. Implementar o sistema de gerenciamento dos livros emprestados
12. Implementar o sistema de multa (simples, sem gerar cobrança direta)
13. Implementar o sistema de vendas (simples, sem gerar cobrança direta)
14. Implementar o sistema de emails
15. Criar o banco de dados
16. Implementar as tabelas por meio de ORM

Requisitos não-funcionais

• Interpretador: CPython 3.4
• Framework web: Django 1.9 e Flask 0.10
• SGBD: PostgreSQL 9.4
• Versionamento: Git
• Servidor HTTP: Gunicorn 19.4

Autores

• Júlia Rizza
• Luiz Cláudio Theodoro

Colaboradores

• Eustáquio Fernandes Júnior
• Matheus Silva Santos
• Gustavo Gardusi
• Pedro Henrique da Costa Avelar
• Marc Sué Pires Morais Junior
• Kethllen Andrey Santos

Projetos Similares

OpenLibrary

O Openlibrary é um projeto de catalogação e viabilização de empréstimos e vendas de livros, totalmente gratuito, feito pela InternetArchive.

Ele é feito em Python com a api de wiki Infogami (que é baseada em web.py) e tem seu código fonte disponível no github. Há também uma página com instruções para contribuições assim como uma documentaçao para desenvolvedores. Há também o link da "central de desenvolvedores" que contém todos os acima, além de links para outras páginas e também está disponibilizado o download do banco de dados do projeto.