|
Projeto com Back-end e Front-end desenvolvido com API RESTful para um desafio técnico, com intuito de criar um catálogo de livros a partir de um arquivo JSON estático, que não podia ser modificado.
Foi construído com C#, ASP .NET Core (Versão 8.0), HTML, CSS e Razor, com arquitetura em camadas baseada em MVC. Este projeto fornece funcionalidades de busca flexível, ordenação por preço, cálculo de frete e exibição de detalhes utilizando rotas.
Como o arquivo JSON estava em inglês, foi mantido o mesmo idioma inglês como padrão para seguir com todo desenvolvimento em código.
O nome “Arbooks” foi escolhido como uma referência ao Pokémon Arbok, do anime Pokémon, combinado com a palavra “Books”, em alusão ao catálogo de livros proposto.
As instruções relacionadas ao Visual Studio neste README.md, seguem passos da ferramenta no idioma PT-BR.
- 📄 Apresentação do catálogo JSON.
- 🔍 Busca flexível por nome, autor ou outros dados (indiferente da digitação).
- 📊 Ordenação por preço de forma ascedente ou decrescente (lista completa ou em resultados).
- 📘 Exibição dos detalhes de cada livro em outra página.
- 💰 Cálculo do frete baseado em 20% do valor do livro.
- 🎨 Front-end interativo desenvolvido como bônus, além da possibilidade de teste via Swagger.
- 🧪 Testes unitários que testam a exibição, busca, ordenação e cálculo de frete.
- .NET Core 8 (Framework principal de desenvolvimento)
- ASP .NET Core Web MVC e API (Arquitetura de API e MVC)
- Visual Studio Community 17.12.1 (IDE de desenvolvimento)
✨ O projeto também segue boas práticas de:
- Conventional Commits
- SOLID
- Clean Code
- Microsoft Visual Studio 17.12.1 ou Superior (Em caso de visualização por IDE)
- .NET Core 8 ou Superior
- Git (Clonagem do Repositório)
Este projeto também conta com "Release", que mostra duas imagens de cada fase do desenvolvimento:
-
Version1-BackendOnly: Mostra como ficou a interface somente com o back-end.
-
Version2-Backend-Frontend: Mostra como ficou a interface com back-end e front-end.
-
Link dos Releases: https://github.com/AlianeAmaral/arbooks-livraria/releases
- Caso queira executar por Linha de Comando e testar somente a API Backend:
git clone https://github.com/AlianeAmaral/arbooks-livraria.git
cd arbooks-livraria
dotnet run
- Cole o link do Swagger no seu navegador:
- Link do Swagger: http://localhost:5013/swagger/index.html
- Ou caso queira executar via Visual Studio, clone o repositório e acesse a solução.
- No Gerenciador de Soluções, clique com botão direito no projeto "Arbooks.API".
- Clique em "Depurar" e depois em "Iniciar Nova Instância".
- Uma página vai abrir automaticamente no seu navegador permitindo realizar os testes abaixo.
📌 Permite testar a busca com letras maiúsculas, minúsculas, acentos, palavras incompletas ou especificações que estão nos detalhes, assim como a ordem de preço crescente ou decrescente, tanto para a lista total quanto para os resultados de uma busca:
GET book/search
💭 Sugestões de entrada, para busca:
jou
éd
💭 Sugestões de entrada, para ordenar preço, teste com lista total e com busca filtrada:
k
- priceAsc para ascendente.
- priceDesc para decrescente.
📌 Permite testar a exibição dos detalhes por ID:
GET book/details
💭 Sugestão de entrada, para exibir detalhes:
2
📌 Permite testar o cálculo de frete por livro:
GET book/calculateshipping
💭 Sugestões de entrada, para cálculo do frete por objeto ID:
1
4
- É necessário configurar para que o back-end inicie junto com o front-end, para isso siga os próximos passos.
- Clique com o botão direito no projeto "Arbooks.API" e depois em "Configurar Projetos de Inicialização".
- Deixe "Arbooks.API" e "Arbooks.Web" com a ação de "Iniciar", e deixe-os nesta sequência:
- 1º: Arbooks.API
- 2º: Arbooks.Web
- Clique em "Ok" e inicie o projeto na interface da IDE ou no terminal com: dotnet run.
- Uma página do navegador deve abrir o site com back-end e front-end funcionando para você interagir.
- Conferir se o projeto está parado.
- Clique com botão direito no projeto "Arbooks.Test" e depois em "Executar Testes".
- No Gerenciador de Testes, será apresentado o resultado de cada teste.
✨ O que está sendo testado?
- Apresentação do catálogo JSON.
- Busca por palavra independente de maiúsculas, minúsculas, acentuações, palavras incompletas ou dados que estão nos detalhes.
- Busca não encontrada, que deve retornar resultado vazio.
- Ordem crescente ou decrescente, na lista completa e na lista de resultados de uma busca.
- Cálculo do frete por ID do objeto.
arbooks-livraria/
│
├─ Arbooks.API
│ ├── Properties
│ ├── Controllers
│ ├── appsettings.json
│ ├── Arbooks.API.http
│ └── Program.cs
├─ Arbooks.Business
│ ├── DTOs
│ ├── Models
│ ├── Repository
│ ├── Services
│ └── books.json
├─ Arbooks.Test
│ └── Business
├─ Arbooks.Web
│ ├── Properties
│ ├── wwwroot
│ ├── Controllers
│ ├── DTOs
│ ├── Views
│ ├── appsettings.json
│ └── Program.cs
└──.gitignore
└── arbooks-livraria.sln
└── README
Um cliente tem necessidade de buscar livros em um catálogo. Esse cliente quer ler e buscar esse catálogo de um arquivo JSON, e esse arquivo não pode ser modificado. Então com essa informação, é preciso desenvolver:
Criar uma API para buscar produtos no arquivo JSON disponibilizado.
Que seja possível buscar livros por suas especificações(autor, nome do livro ou outro atributo)
É preciso que o resultado possa ser ordenado pelo preço.(asc e desc)
Disponibilizar um método que calcule o valor do frete em 20% o valor do livro.
Será avaliado no desafio:
Organização de código;
Manutenibilidade;
Princípios de orientação à objetos;
Padrões de projeto;
Teste unitário
Para nos enviar o código, crie um fork desse repositório e quando finalizar, mande um pull-request para nós.
O projeto deve ser desenvolvido em C#, utilizando o .NET Core 3.1 ou superior.
Gostaríamos que fosse evitado a utilização de frameworks, e que tivesse uma explicação do que é necessário para funcionar o projeto e os testes.