Feat/Refactor(Rodar-Projeto/Item): Automatização de Execução, Inclusão do campo Location com id único adicionado ao barcode e Atualização do README

[Potatoyz908]

Descrição do Pull Request

Este Pull Request implementa melhorias no projeto, incluindo a automatização da execução com make run, atualizações no README e a inclusão do campo location como um identificador único para melhorar o match entre itens perdidos e achados.

---

O que foi feito?

1. Adicionado Makefile

• Criado o comando make run, que automatiza o processo de:
  • Navegar para o diretório da API.
  • Rodar docker compose up --build.

2. Atualização do README

• Substituído o comando anterior (cd API && sudo docker compose up --build) por make run.
• Corrigida a URL do frontend no README para refletir o endereço correto.

3. Inclusão de location como ID

• O campo location agora é tratado como uma chave estrangeira para o modelo Location.
• IDs de localização foram incorporados ao barcode dos itens, seguindo a estrutura:

  Barcode: <Categoria><local><Cor><Marca><Valioso>
  

• Criado o modelo Location com os campos:
  • name: Nome do local (ex.: "Restaurante Universitário").
  • location_id: Identificador único (ex.: 02).
• Atualizado o modelo Item para usar location como um campo relacionado.
• Atualizado o ItemSerializer e as views relacionadas para manipular o campo location.

4. Teste de Criação de Item

• Foi possível criar um item com as seguintes características:

  {
      "id": 1,
      "barcode": "010101031",
      "name": "Relógio de Ouro",
      "description": "Relógio encontrado no RU",
      "category": 1,
      "location": 2,
      "color": 1,
      "brand": 1,
      "is_valuable": true,
      "status": "found",
      "found_lost_date": null,
      "created_at": "2025-01-10T07:22:22.111599Z",
      "image_urls": [
          "https://res.cloudinary.com/dbujgidbd/image/upload/v1736493743/uoscu6a5fuqczphhnrbp.ico",
          "https://res.cloudinary.com/dbujgidbd/image/upload/v1736493744/lfaus34p5o9jpc6ykhaj.png",
          "https://res.cloudinary.com/dbujgidbd/image/upload/v1736493745/xgxtmywpo8gsln9s1err.jpg"
      ]
  }

---

Checklist

• Meu código segue as diretrizes do projeto.
• Adicionei testes para cobrir as mudanças.
• Atualizei a documentação, se necessário.

---

Como Testar?

Automatização com Make

1. Certifique-se de ter o Make instalado no ambiente:

   make --version

2. Execute o comando:

   make run

Criação de Item

1. Envie uma requisição POST para criar um item com localização, por exemplo:
   • Endpoint: POST /api/items/
   • Body:

     {
         "name": "Relógio de Ouro",
         "description": "Relógio encontrado no RU",
         "category": 1,
         "location": 2,
         "color": 1,
         "brand": 1,
         "is_valuable": true,
         "status": "found",
         "images": [
             "file1.jpg",
             "file2.jpg",
             "file3.jpg"
         ]
     }

2. Verifique se o barcode inclui corretamente o location e os outros atributos.

[pedroeverton217]

Ótimo Trabalho!! Boa Euller!

[314dro]

Muito boa, Euller!

[leoramiroo]

Ótimo trabalho, Euller!!!