šŸ OBES - Sebo Online

Para pessoas que buscam adquirir livros por preƧos mais acessĆ­veis e contribuir para a preservaĆ§Ć£o do meio ambiente, que encontram dificuldades em ter acesso a livros novos devido aos preƧos elevados. O OBES Ć© uma plataforma online de vendas e doaĆ§Ć£o de livros usados que oferece preƧos mais acessĆ­veis e uma grande variedade de tĆ­tulos em comparaĆ§Ć£o Ć s lojas fĆ­sicas tradicionais. Nosso produto contribui para a formaĆ§Ć£o de uma sociedade mais instruĆ­da e crĆ­tica, alĆ©m de colaborar para a preservaĆ§Ć£o do meio ambiente por meio da reutilizaĆ§Ć£o de recursos.

Watch the video

Links

Front-End: https://obes-larasouzabr.vercel.app/
Back-End: https://obes-backend.onrender.com/api-docs
Trello: https://trello.com/invite/b/MC20sLvY/ATTIf5c4e8abfc2a48081ddbffa0f810648269533432/user-stories-mapeamento
Artefatos: https://drive.google.com/drive/folders/1V3NrhX5OvRjm1KLqPux-yRqRDqPz6E20?usp=sharing

šŸ§‘ā€šŸ’» Membros da equipe

508159 ā€“ Lara Gabrielly Souza Batista Lima - Engenharia de Software 508653 ā€“ Victor Anthony Pereira Alves - Engenharia de Software 509278 ā€“ VinĆ­cius Lemos AraĆŗjo - Engenharia de Software 516098 ā€“ Antonio Herik Cosmo Martins - Engenharia de Software

šŸ§‘ā€šŸ¤ā€šŸ§‘ PapĆ©is ou tipos de usuĆ”rio da aplicaĆ§Ć£o

Resumo dos Envolvidos

Nome DescriĆ§Ć£o Responsabilidades
E01- Leitores Leitores Ć”vidos procuram comprar livros usados ou raros, alĆ©m de doar livros que nĆ£o sĆ£o mais utilizados por eles. - Assegurar que o sistema tem utilidade e poderĆ” ser mantido;- Utilizar o sistema com frequĆŖncia.
E02- Estudantes Estudantes que buscam encontrar livros didƔticos usados a preƧos acessƭveis. Garantir que a proposta do sistema esteja sendo cumprida a fins educacionais;
E03- InstituiƧƵes de ensino InstituiƧƵes de ensino que buscam popular suas devidas bibliotecas e fornecer uma acessibilidade cultural para seus estudantes. - Assegurar que o sistema tem utilidade e poderĆ” ser mantido;- Utilizar o sistema quando necessĆ”rio. - Garantir que o sistema tem carĆ”ter de extensĆ£o. - Aprova financeiramente (instituiƧƵes privadas)
E04- Bibliotecas Bibliotecas que procuram novos livros para popular suas prateleiras. -Assegurar que o sistema tem utilidade e poderĆ” ser mantido;- Utilizar o sistema quando necessĆ”rio. - Garantir que o sistema tem carĆ”ter de extensĆ£o,
E05- Grupos de estudos e clubes de leitura Determinados grupos procuram acessar livros por um valor abaixo da mĆ©dia e encontrar estoques de livros para doar. - Utilizar o sistema como um promotor da acessibilidade cultural; - Promover uma cultura de democratizaĆ§Ć£o da leitura utilizando o sistema como meio/modo.
E06- ONGā€™s OrganizaƧƵes sem fins lucrativos que buscam arrecadar fundos atravĆ©s da venda de livros usados. -Utilizar o sistema como um promotor da acessibilidade cultural; -Promover uma cultura de democratizaĆ§Ć£o da leitura utilizando o sistema como meio/modo.

Resumo dos UsuƔrios

Nome DescriĆ§Ć£o Responsabilidades Envolvido
UC - UsuĆ”rio Comum Leitores Ć”vidos que procurem comprar livros usados ou raros, alĆ©m de doar livros que nĆ£o sĆ£o mais utilizados por eles. Pessoas que desejam doar livros usados para que outros possam desfrutar deles. - Vender livros usados.- Doar livros usados.- Comprar livros usados por preƧos acessĆ­veis.- Avaliar vendedores. E01, E02
UI - UsuĆ”rio Institucional InstituiƧƵes de ensino que buscam popular suas devidas bibliotecas e seus acervos para fornecer uma acessibilidade cultural para seus estudantes. OrganizaƧƵes sem fins lucrativos que buscam arrecadar fundos atravĆ©s da venda de livros usados. - Utilizar o sistema para encontrar livros para doaĆ§Ć£o.- Filtrar livros e vendedores.- Avaliar vendedores. E03, E04, E06

šŸ—“ļø Entidades ou tabelas do sistema

  1. Livros: representa os livros disponĆ­veis para venda/doaĆ§Ć£o no sebo online. Os atributos podem incluir tĆ­tulo, autor, editora, ano de publicaĆ§Ć£o, condiĆ§Ć£o (novo, usado), preƧo, descriĆ§Ć£o e imagem do livro.
  2. UsuƔrios: a entidade que representa os usuƔrios do sistema, incluindo usuƔrio comum e usuƔrio institucional. Os atributos podem incluir nome, endereƧo, telefone, e-mail e senha.
  3. DoaĆ§Ć£o/venda: a entidade que representa as doaƧƵes/vendas feitas pelos usuĆ”rios. Os atributos podem incluir informaƧƵes do cliente e informaƧƵes do livro.
  4. AvaliaƧƵes: a entidade que representa as avaliaƧƵes feitas pelos clientes sobre os livros e usuĆ”rios. Os atributos podem incluir nĆŗmero da avaliaĆ§Ć£o, data, informaƧƵes do cliente, nome do livro ou usuĆ”rio avaliado, nota (em uma escala de 1 a 5) e comentĆ”rio.

šŸš© Principais funcionalidades da aplicaĆ§Ć£o

  • Receber livros disponĆ­veis para doaĆ§Ć£o: assim como todos os sistemas e-commerce, serĆ” implementada no Obes uma plataforma de envios para que os usuĆ”rios registrados acompanhem os pedidos.
  • Colocar livros usados Ć  venda: os usuĆ”rios registrados a qualquer momento poderĆ£o cadastrar livros usados por meio da pĆ”gina de cadastro que ficarĆ” disponĆ­vel no menu.
  • Cadastrar livro para doaĆ§Ć£o: os usuĆ”rios registrados a qualquer momento poderĆ£o cadastrar livros usados por meio da pĆ”gina de cadastro que ficarĆ” disponĆ­vel no menu.
  • Visualizar livros usados que estĆ£o sendo vendidos e doados: o sistema serĆ” dividido em duas categorias, a primeira Ć© o Sebo no qual constarĆ” os livros Ć  venda, essa pĆ”gina ficarĆ” disponĆ­vel tanto para o UC (UsuĆ”rio Comum) quanto para o UI (UsuĆ”rio Institucional). JĆ” a categoria de doaĆ§Ć£o estarĆ” visĆ­vel apenas para o UI, o UC nĆ£o poderĆ” receber livros doados e a pĆ”gina de doaĆ§Ć£o para ele constarĆ” apenas aqueles materiais que ele cadastrou para doaĆ§Ć£o.

šŸ–„ļø Tecnologias e frameworks utilizados

Frontend:

VUE,vue-router, vue-star-rating, vue3-carousel, axios, jwt-decode

Backend:

JavaScript, NodeJs, Express, Postgres, Sequelize, Swagger.

:shipit: OperaƧƵes implementadas para cada entidade da aplicaĆ§Ć£o

Entidade CriaĆ§Ć£o Leitura AtualizaĆ§Ć£o RemoĆ§Ć£o
Livros X X X X
UsuƔrios X X X
DoaĆ§Ć£o/venda X X X X
AvaliaƧƵes

:neckbeard: Rotas da API REST utilizadas

MĆ©todo HTTP URL
POST /api/login
GET /api/addresses
PUT /api/address/{adressID}
DELETE /api/address/{adressID}
GET /api/books
POST /api/books
GET /api/{userId}/books
GET /api/books/{bookID}
PUT /api/books/{bookID}
DELETE /api/books/{bookID}
GET /api/categories
GET /api/categories/{bookId}
GET /api/user
POST /api/user
PUT /api/user
DELETE /api/user
GET /api/user/{userId}
GET /api/donation-orders
GET /api/donation-orders/{bookId}