1. Tecnologias utilizadas:

• Python
• Fastapi
• MongoDB

2. Bibliotecas utilizadas:

• Fastapi
• BSON
• Decimal128
• Pydantic
• Typing

3. Requisitos para execução da aplicação:

• Instalar Python 3
• Instalar Visual Studio Code

4. Como executar a aplicação

• Clonar repositório

• Copiar SSH ou HTTPS do repositório

• Na máquina local, no terminal do git execute o comando:
  git clone + <linkdorepositório>

• Sugere-se a criação de um ambiente virtual para isolar as dependências do projeto. Para isso, siga os passoas abaixo:

Dentro da pasta onde foi clonado o repositório, execute o comando no terminal
Windows: python -m venv + <nomedoambiente>

• Para ativar o ambiente virtual criado, execute no terminal:
  Windows: nomedoambiente\Scripts\activate.bat

• Com o ambiente virtual criado e instalado, instale as dependências do projeto executando os arquivos 'requirements.txt', 'Fastapi", 'uvicorn' 'requests' e 'motor', no terminal com os comandos:
  Windows: pip install -r requirements.txt - https://pypi.org/project/to-requirements.txt/ pip install fastapi - https://pypi.org/project/fastapi/ pip install uvicorn - https://pypi.org/project/uvicorn/ pip install motor - https://pypi.org/project/motor/

• Após as dependencias do projeto instaladas execute o uvicorn para execução dos casos de testes:
  Windows: uvicorn main:app --reload

5. Executar as aplicações:

• Acessar o Swagger pelo caminho: http://localhost:8000/docs
• Rota principal
• Post de produto
• Get de produto pelo código
• Delete de produto pelo código
• Update de produto pelo código
• Get de todos os produtos
• Get de produto por categoria
• Post de usuário
• Get de usuário por e-mail
• Delete de usuário por e-mail
• Post de endereço
• Get de todos os endereços cadastrados
• Get de endereço por e-mail do usário
• Delete do endereço pelo _id
• Post de carrinho
• Put para inserir produto pelo código no carrinho
• Get carrinho por e-mail do usuário
• Put para fechar carrinho
• Get para buscar carrinhos fechados do usuário por e-mail
• Get para buscar a quantidade de carrinhos fechados do usuário por e-mail
• Delete carrinho pelo e-mail do usuário

6. Detalhes do desenvolvimento do projeto:

• Cadastro de clientes

1. Cadastrar um cliente. a. Processo em que inserimos um novo cliente no sistema. - OK
   b. Cada cliente precisa ter pelo menos um nome e um e-mail. - OK
   c. O cliente deve informar um email válido (ao menos 3 caracteres, conter um @) - OK
   d. O e-mail do cliente deve ser único, ou seja, não há dois clientes no sistema com o mesmo e-mail. - OK
   e. Podemos ter dois clientes com o mesmo nome; mas, cada um com um e-mail diferente. - OK
   
2. Cadastrar um endereço.
   a. Processo de inserir um endereço para o cliente. - OK
   b. Cada endereço precisa ter pelo menos um CEP, logradouro, número, cidade e estado. - OK
   c. O mesmo endereço pode ser cadastrado para mais de um cliente. - OK
   
3. Pesquisar um cliente.
   a. Informado o e-mail de um cliente, apresentamos os seus dados. - OK
   
4. Pesquisar um endereço.
   a. Informando o e-mail de um cliente, apresentamos seus endereços. - OK
   
5. Remover um cliente. (Opcional)
   a. Remover um cliente pode remover também os endereços relacionados. - OK
   b. Ao remover um cliente remover também carrinho aberto. - OK
   
6. Remover um endereço. (Opcional)
   a. Com base em alguma chave, por exemplo, é possível remover o endereço do cliente. - OK
   

• Gerenciamento de produtos
  

1. Cadastrar um produto.
   a. Processo em que registra-se um novo produto no sistema. - OK
   b. Cada produto precisa ter pelo menos um nome, uma descrição e um código único. - OK
   c. Um produto pode ter um preço de venda, que é um valor superior a R$ 0,01. - OK
   d. Um produto pode ter um valor de estoque, que é um valor superior a 0. - OK
   e. O código do produto informado no processo de cadastro deve ser único, ou seja, não há dois produtos no sistema com o mesmo código. - OK
   f. Os nomes dos produtos podem ser únicos. - OK
   g. Campos adicionais podem ser informados conforme a categoria do seu projeto. - OK
   
2. Atualizar os dados de um produto.
   a. Poderemos atualizar os dados de um produto com base no seu código. - OK
   b. O código do produto não pode ser alterado [PRÓXIMA IMPLEMENTAÇÃO] c. O nome do produto pode ser alterado. - OK
   d. Quaisquer outros campos do produto que existam em seu projeto poderão ser atualizados. - OK
   
3. Pesquisar um produto.
   a. Informado o código do produto, apresentamos os seus dados. - OK
   
4. Pesquisar um produto pelo nome.
   a. Informe um texto para o nome do produto, então iremos pesquisar pelos produtos que contenham o nome informado.
   
5. Remover um produto. (Opcional)
   a. Poderemos remover um produto com base em seu código. - OK
   b. Atentar neste caso: Este produto está em algum carrinho de compras? O que fazer? O seu grupo irá decidir.
   

• Carrinho de compras

1. Abertos: Cada cliente pode ter apenas um carrinho de compras aberto na aplicação. - OK
   
2. Fechados: São os carrinhos de compras os quais a compra já foi fechada. - OK
   Solicitamos o seguinte:
   
3. Criar um carrinho de compras aberto e adicionar itens ao carrinho.
   a. Todo carrinho de compras deve conter um cliente. - OK
   b. É opcional, ter um produto inicialmente. [Em nossa implementação, o carrinho é criado vazio]
   c. Se há um produto um mais produtos, na criação do carrinho, informe a quantidade de cada produto. No seu trabalho, você pode começar com apenas um produto. - OK
   d. Ao criar o carrinho, você deve:
   i. Validar se o cliente existe - OK
   ii. Validar se o produto a ser adicionado no carrinho existe - OK
   iii. Verificar se o cliente já possui um carrinho aberto. Caso contrário criar um carrinho novo. - OK
   iv. Validar se a quantidade de itens do produto a ser adicionado no carrinho está disponível no estoque (opcional). OK
   e. Ao adicionar um item no carrinho, o mesmo terá o valor total e quantidade de itens atualizado - OK
   
4. Alterar a quantidade de itens do carrinho novo.
   a. No carrinho novo, com base no produto informado, a quantidade é modificada.
   b. Para isto:
   i. Validar se produto existe no carrinho - OK
   ii. Validar se existe estoque para a quantidade desejada do produto (opcional). - OK
   iii. Atualizar o valor total e quantidade de itens do carrinho - OK
   c. Se o carrinho zerar o número de itens, ou seja, o cliente removeu todos os itens do carrinho, o mesmo pode ser excluído. - Não foi feito
   
5. Consultar carrinho de compras aberto:
   a. Informar o cliente e retornar os dados do carrinho e produtos - OK
   
6. Consultar os carrinhos fechados de um cliente (opcional). - OK
   
7. Consultar os produtos e suas quantidades em carrinhos fechados (opcional). - OK
   
8. Consultar quantos carrinhos fechados os clientes possuem (opcional). - OK
   
9. Fechar o carrinho aberto:
   a. Simplesmente pode-se mudar o tipo do carrinho de compras para “fechado”. - OK
   b. Opcionalmente, o grupo pode adicionar o seguinte:
   i. Identificar o endereço do cliente que será utilizado como o de entrega. - OK
   ii. Validar se o estoque pedido dos itens ainda está disponível, se estiver reduzir do estoque dos produtos a quantidade de itens do produto no carrinho (Muito opcional). - Não foi feito
   iii. Associar um identificador ao carrinho de compras como sendo o número do pedido.
   
10. Excluir carrinho do cliente (opcional) - OK a. Quer o carrinho seja aberto ou fechado, podemos remover o carrinho do sistema. - OK

• Entregas extras realizadas

• Documentar a API Rest com o Swagger/OpenAPI ou RedDoc. - OK
• Organizar e estruturar o código do projeto. - OK
• Montar um arquivo README.md detalhando o projeto. - OK

• Próximas implementações:

• Criação de testes unitários
• A API poderá utilizar algum recurso de autorização e autenticação
• O projeto poderá gerar mensagens de log ou utilizar mecanismos de logging
• Realizar o deploy da aplicação
• Hospedagem em alguma plataforma como o Heroku e/ou ainda ter um arquivo Dockerfile ou docker-compose que ajude em seu futuro deploy/teste