Joao de Barro 🇧🇷

Este projeto é uma aplicação Laravel que utiliza Docker Compose para facilitar o desenvolvimento e a implantação. O projeto inclui funcionalidades para integração com AWS S3 e busca de livros no Google Books API.

Como Iniciar o Projeto

1. Clone o Repositório:

   git clone https://github.com/Casmei/tecnovix-teste.git

   Clone o projeto do Github

   cd tecnovix-teste

   Entre na pasta gerada

2. Configure o Ambiente:

   cp .env.example .env

   Crie um arquivo .env a partir do arquivo de exemplo fornecido.

   Eu edite o arquivo conforme o necessário, adicionando as credenciais do AWS S3, banco de dados e Google Books. | Eu já deixei configurado as envs do banco de dados e do AWS S3 (Minio) ☺️

3. Inicie o Projeto com Docker Compose:

   docker compose up --build

   Este comando inicia todos os serviços definidos no arquivo docker-compose.yml.

---

• Página web: http://localhost:8080
• Documentação da API: http://localhost:8080/api/documentation

Possíveis erros

Por que, ao tentar adicionar um livro, eu me deparo com um erro de Api Key Missing?

Ao tentar usar o buscador de livros, o sistema utiliza a Api do Google Books, o mesmo precisa de uma api key única para funcionar, o erro é decorrente a ausência desse key em seu projeto, para contonar o problema, siga os passos:

• Altere a env do projeto
• Salve as novas envs no projeto

    docker compose up app

• Reinicie o container

Imagem da mensagem de erro da Api Key

Débitos Técnicos

1. Integração com AWS S3: A implementação do AWS S3 foi relativamente simples. No entanto, houve dificuldades na busca de livros na Google Books API, especificamente em como obter e utilizar a URL da imagem para enviar e persistir no bucket S3.

2. Exceções Personalizadas no Laravel: Enfrentei dificuldades ao lidar com exceções personalizadas no Laravel, principalmente devido a mudanças entre as versões 10 e 11. Não consegui descobrir a tempo como alterar o código de status da exceção conforme necessário.

3. Env: Hoje, temos o problema de, uma modificação na env não refletir no projeto, resultando nos passos descritos no erro da api key, de ter que subir de novo o container.

4. "Prefixod da rota API": Houve alguns problemas por parte do laravel ao configurar as rotas com o prefixo API no bootstrap do sistema, não sei se foi algo que eu fiz, ou um problema da versão 11, mas ficava dando sessão expirada.