Este é um projeto de e-commerce desenvolvido ccom Django e banco de dados PostgreSQL (hospedado na plataforma Neon) e arquivos de media armazenados no Cloudinary. A plataforma permite o cadastro de usuários, gerenciamento de produtos, controle de estoque, promoções, carrinho de compras, pedidos, formas de envio e métodos de pagamento.

Este sistema foi desenvolvido com o objetivo de simular um ambiente real de loja virtual, cobrindo desde o cadastro e visualização de produtos até a finalização do pedido com diferentes formas de pagamento.

O modelo relacional foi cuidadosamente desenhado para suportar as principais operações de um e-commerce, incluindo:

• Usuários com diferentes tipos de acesso (cliente, administrador)
• Produtos com variações, imagens e controle de estoque
• Carrinho de compras e histórico de pedidos
• Pagamentos e diferentes métodos (cartão, transferência, etc.)
• Promoções aplicadas a produtos
• Formas de envio com cálculo de taxas

• Python 3.11+
• Django 4.x
• PostgreSQL (via Neon)
• Django REST Framework
• Token Authentication
• HTML/CSS/JAVASCRIPT para o painel

• Cadastro, login e autenticação de usuários
• CRUD de produtos com categorias e marcas
• Gerenciamento de estoque e movimentações
• Carrinho de compras e adição de itens
• Registro de pedidos com múltiplos itens
• Histórico de pedidos por usuário
• Cadastro e aplicação de promoções e cupons
• Integração com múltiplos métodos de pagamento
• Emissão de comprovantes e rastreamento de status
• Cálculo automático de taxas de envio e pagamentos

1. Clone o repositório

git clone https://github.com/ximana/ecommerce-django.git
cd ecommerce-django

2. Crie e ative um ambiente virtual

python -m venv venv
source venv/bin/activate  # No Windows: venv\Scripts\activate

3. Instale as dependências

pip install -r requirements.txt

4. Configure variáveis de ambiente

Crie um arquivo .env na raiz com os dados da sua base Neon:

# Cloudinary Configuration
CLOUDINARY_CLOUD_NAME=xxxxx
CLOUDINARY_API_KEY=xxxxxx
CLOUDINARY_API_SECRET=xxxxxx

# Django Configuration
SECRET_KEY=sua_secret_key_aqui
DEBUG=True

# Base de dados
DATABASE_URL = "postgresql://xxxxxx"

5. Aplique as migrações e rode o servidor

python manage.py makemigrations
python manage.py migrate

6. Crie um superusuário

python manage.py createsuperuser

7. Inicie o servidor

python manage.py runserver

Acesse o projeto em: http://localhost:8000

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues e enviar pull requests.

Este projeto está licenciado sob a MIT License.

Desenvolvido por \Paulo Ximana.