iudicium / root_shop

A versatile Django and Vue.js framework for ecommerce.

R00T SHOP

I've designed a versatile ecommerce framework. It comes equipped with an intuitive user interface and a powerful set of features, ensuring a seamless shopping experience for customers. This framework represents a significant step in enhancing my own skills while providing a valuable resource for others to build their successful online businesses.

Table of Contents

• Introduction
• Features
• Getting Started
• Installation
• Usage

Features

1. Custom Cart Integration 🛒 Experience seamless and personalized shopping with our custom-built cart feature. Add, modify, and track your selected products effortlessly. Whether you're shopping for one item or a whole wishlist, our cart has got you covered!

2. ViewSets for Enhanced Functionality 🚀 I've harnessed the power of Django Rest Framework's ViewSets to provide you with dynamic and efficient API endpoints. Our ViewSets offer a streamlined way to interact with the backend, ensuring smooth data retrieval and updates.

3. User-Friendly API 🤝 Embrace the simplicity and ease of use with our API. I've crafted it to be intuitive and developer-friendly, making it a breeze for you to integrate, consume, and extend the functionalities of our E-commerce website.

Getting Started

To set up the project locally for development, follow these steps:

1. Clone the Repository:

    git clone https://github.com/r00tk3y/root_shop.git
   

2. Navigate to the Project Directory:

   cd root_shop
   

Installation

1. Create a virtual environment && Activate it:

   python -m venv venv 
   source venv/bin/activate
   

2. Install Dependencies

   cd webshop
   pip install -r requirements.txt
   

3. Frontend

   Enter the django_frontend directory and find a detailed README.md about
   installation of the frontend
   

4. Migrate Database

   python manage.py makemigrations
   python manage.py migrate
   

5. Create a superuser

   python mange.py createsuperuser
   

6. Set up env variables

   1. Remove the .template in webshop/.env.template
   2. Set desired environment variables
   

7. python manage.py shell
   
   from django.core.management.utils import get_random_secret_key
   print(get_random_secret_key())
   
   >>>gw^9ej(l4vq%d_06xig$vw+b(-@#00@8l7jlv77=sq5r_sf3nu
   Random key generator, obviosly do not use the one above.
   

Usage

1. Running server

   python manage.py runserver
   

2. Fixtures

   python manage.py loaddata fixtures/data.json
   superuser -> admin:admin
   

3. Docker

    Apply migrations before running
    docker-compose up -d
   

Notes

1. Install dark reader so that the white theme does not hurt your eyes :D