🛍 kc-project 🛍

O que é?

kc_project API (Kenzie Commerce Project) é uma API que genrencia dados de compra e venda de produtos variados por seus respectivos usuários (clientes e/ou vendedores), podendo anunciar produtos à venda e também comprar de outros usuários.

O que ela faz?

O kc_project é capaz de:

• Criação de usuário (login e senha);
• Suporta três tipos de usuário (Administrador, Vendedor e Cliente);
• Clientes podem visualizar a lista de items publicadas por todos os vendedores e também realizarem compras, porém não podem vender produtos, a menos que atualizem seu tipo de usuário para vendedor.
• Vendedores cumulam todas as permissões de usuários clientes, porém podem também vender items, visualizar todas as vendas recebidas em cada produtos, alterar status da venda de pedidos recebidos.
• Administradores possuem privilégios para editar, deletar e gerir toda plataforma, produtos e usuários;
• Possui proteção em rotas específicas.
• Faz envio de e-mails ao comprador conforme o vendedor atualiza o status da compra.
• Os usuários (vendedores e clientes) podem criar a sua própria lista de desejos.

🧑‍💻 Como rodar a aplicação?

1. Crie um ambiente virtual com o comando:

python -m venv venv

2. Ative o venv com o comando:

# Linux:
source venv/bin/activate

# Windows (Powershell):
.\venv\Scripts\activate

# Windows (Git Bash):
source venv/Scripts/activate

3. Instale a lista de dependências do projeto:

pip install -r requirements.txt

4. É necessário configurar na máquina local o banco de dados em Postgres de acordo com o arquivo ".env.example";

5. Após, rodar os comandos para realizar as migrações e relações necessárias.:

python manage.py makemigrations

e também

python manage.py migrate

📨 Configuração do envio de email:

📬 Oulook

Para configurar o envio de email pelo django usando o Outlook, configure o seu arquivo .env:

EMAIL_HOST=smtp-mail.outlook.com
EMAIL_PORT=587
EMAIL_HOST_USER=seu_email
EMAIL_HOST_PASSWORD=senha_de_aplicativo

Para gerar a senha de aplicativo no Outlook:

1. Entre nas configurações da conta;
2. Entre em "Segurança";
3. Entre em "Opções de segurança avançadas";
4. Ative a "verificação em duas etapas";
5. E, em "senhas de aplicativo", acesse "Criar uma nova senha de aplicativo";
6. Use a senha criada no campo EMAIL_HOST_PASSWORD do arquivo .env;

📬 Gmail

Para configurar o envio de email pelo django usando o Gmail, configure o seu arquivo .env:

EMAIL_HOST=smtp.gmail.com
EMAIL_PORT=587
EMAIL_HOST_USER=seu_email
EMAIL_HOST_PASSWORD=senha_de_aplicativo

Para gerar a senha de aplicativo no Gmail:

1. Entre nas configurações da conta Google;
2. Clique em Segurança;
3. Habilite a Verificação em duas etapas;
4. Clique em Senhas de app;
5. Clique em Selecionar app -> escolha Outro (nome personalizado);
6. Escolha um nome de sua escolha (ex: Django E-mail) e clique em GERAR;
7. Use a senha criada no campo EMAIL_HOST_PASSWORD do arquivo .env;

---