GitHunt
RE

This project is a complete e-commerce platform developed with Django, featuring functionalities such as product management, a shopping cart, and order processing. The user interface is fully responsive and designed using Bootstrap.

๐Ÿ›’ Django E-commerce Project

Welcome to the Django E-commerce project! This repository contains a fully functional online store built using Django for the backend and modern web technologies for the frontend.


๐Ÿ”ง Features

  • User Authentication: Register, log in, and manage accounts.
  • Admin Panel: Fully customizable admin panel for managing products, orders, and users.
  • Product Management: Add, edit, and delete products with categories.
  • Shopping Cart: Seamlessly add, update, and remove items from the cart.
  • Order Processing: Place orders and manage order history.
  • Responsive Design: Optimized for all devices with a clean UI.

๐ŸŸข Backend Technologies

The backend of this project is powered by:

  • Django: A high-level Python web framework.

๐ŸŸก Frontend Technologies

The frontend leverages:

  • HTML
  • CSS
  • Bootstrap
  • JavaScript

๐Ÿš€ Getting Started

Follow these steps to set up the project on your local machine:

1. Clone the Repository

First, clone this repository to your local system using the following command:

git clone git@github.com:rezamardaniDev/PetHome.git

2. Set Up a Virtual Environment

Navigate to the project directory and create a virtual environment to isolate project dependencies:

python -m venv venv

Activate the virtual environment:

  • On Windows:

    venv\Scripts\activate
  • On macOS/Linux:

    source venv/bin/activate

3. Install Dependencies

Install all required Python packages using pip:

pip install -r requirements.txt

4. Run Database Migrations

Set up the database by running the migrations:

python manage.py migrate

5. Run the Development Server

Start the Django development server:

python manage.py runserver

The application will be available at:

http://127.0.0.1:8000/

6. Access the Admin Panel

To log in to the admin panel, use the default credentials:

  • Username: admin
  • Password: admin

The admin panel is accessible at:

http://127.0.0.1:8000/admin/

๐Ÿ“‚ Project Structure

Below is an overview of the project's structure:

PetHome/
โ”œโ”€โ”€ manage.py
โ”œโ”€โ”€ requirements.txt
โ”œโ”€โ”€ db.sqlite3
โ”œโ”€โ”€ app_name/  # Main application folder
โ”‚   โ”œโ”€โ”€ migrations/
โ”‚   โ”œโ”€โ”€ static/
โ”‚   โ”œโ”€โ”€ templates/
โ”‚   โ”œโ”€โ”€ views.py
โ”‚   โ”œโ”€โ”€ models.py
โ”‚   โ””โ”€โ”€ urls.py
โ””โ”€โ”€ ...

๐Ÿ“Œ Contribution Guidelines

Contributions are welcome! To contribute:

  1. Fork the repository.
  2. Create a new branch: git checkout -b feature-branch-name.
  3. Commit your changes: git commit -m 'Add some feature'.
  4. Push to the branch: git push origin feature-branch-name.
  5. Open a pull request.

๐Ÿ“„ License

This project is licensed under the MIT License. See the LICENSE file for details.


๐Ÿ“ž Contact

If you have any questions or feedback, feel free to reach out:


Thank you for checking out this project! Happy coding! ๐ŸŽ‰