https://github.com/prak112/image-barter-bazaar
E-commerce platform for Barter-exchange of photos and art.
https://github.com/prak112/image-barter-bazaar
django-project html-css python-3
Last synced: 14 days ago
JSON representation
E-commerce platform for Barter-exchange of photos and art.
- Host: GitHub
- URL: https://github.com/prak112/image-barter-bazaar
- Owner: prak112
- License: mit
- Created: 2023-10-09T14:30:02.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-01T19:23:24.000Z (over 1 year ago)
- Last Synced: 2025-03-04T17:50:29.688Z (over 1 year ago)
- Topics: django-project, html-css, python-3
- Language: Python
- Homepage:
- Size: 9.29 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Ecommerce Photo Store - 🎨 Image Barter Bazaar 📸
# Overview
A brief introduction of the project, main features, setup instructions, technologies used and resource credits.
# Contents
- [Aim](#aim)
- [Features](#features)
- [Technologies Used](#technologies-used)
- [Project Setup](#project-setup)
- [Additional Information](#additional-information)
- [Credits](#credits)
# Aim
The aim of the project is to build a functional E-commerce platform with a built-in payment gateway. For tech stack check [Technologies Used](#technologies-used). The platform being a skills demonstration for Full-Stack Development will have browsing functionality and a barter-exchange checkout.
# Features
- Authorize and authenticate Users(Customers) based on their credentials
- Users/Customers can:
- Register and create their own profiles
- Browse *Products* and add items to the *Cart*
- Search *Products* through filters - *Type, Theme & Author*
- Edit their *Cart* - increase/decrease product quantity, remove product
- Upload photographs and/or art to the *Product Inventory* as Payment
# Technologies Used
- **Frontend**
- Figma (UI design)
- HTML
- CSS
- **Backend**
- Django (Python)
- **Database**
- SQLite (Development)
- PostgreSQL 17 (Production)
# Project setup
## Setup Local development environment
- In your `bash` terminal, clone the git repository to a new repository, `repo-name`
```bash
$ git clone https://github.com/prak112/Image-Barter-Bazaar.git
```
- After cloning is successful, navigate to project directory,
```bash
$ cd Image-Barter-Bazaar
```
## Install Python
- Visit [Official Python website](https://www.python.org/) and download Python version == 3.11.2 or 3.11.x
- Verify installed version in the terminal
- For Windows:
```cmd
$ path/to/dir> python --version
Python 3.11.2
```
- For Linux/macOS:
```bash
$ path/to/dir> python --V
Python 3.11.2
```
## Setup Python virtual environment
- Open a terminal or command prompt and navigate to the directory where you want to create your Django project.
- Create a new virtual environment
- For Windows:
```cmd
$ path/to/dir> python -m venv project_env
```
- For Linux/macOS:
```bash
$ path/to/dir> python3 -m venv project_env
```
- where `project_env` will be the new directory with all virtual environment files
- Activate virtual environment using the command based on your operating system
- For Windows:
```cmd
$ path/to/dir> project_env\Scripts\activate.bat
```
- For macOS/Linux:
```bash
$ path/to/dir> source project_env/bin/activate
```
## Install dependencies
- Inside the activated virtual environment, install the project dependencies from `requirements.txt`
```sh
$ (project_env) path/to/dir> pip install -r requirements.txt
```
- Verify if the installed libraries have the required versions from `requirements.txt`
```sh
$ (project_env) path/to/dir> pip list
```
## Execute Project
- Navigate to the project directory (`ecommstore`) where the Django project is located
```sh
$ (project_env) path/to/dir> cd ecommstore
```
## Implement Database schema
- Migrate the database design implemented using Django Models in `models.py` in the apps - `photostore` & `users`
- After creating the neccessary migration files in the `migrations` directory :
```sh
$ (project_env) path/to/dir/ecommstore> python manage.py makemigrations
```
- The above command has no effect if `models.py` is unchanged.
- In that case, we could just migrate existing Django Models at the beginning of the project :
```sh
$ (project_env) path/to/dir/ecommstore> python manage.py migrate
```
## Run server
- After implementing the database schema, run the following command to start the Django development server:
```sh
$ (project_env) path/to/dir/ecommstore> python manage.py runserver
```
# Additional Information
- To know more about project plan, implementation, workflows and further enhancements, see [Wiki](https://github.com/prak112/Image-Barter-Bazaar/wiki)
# Credits
- **Planning assistance**
- ChatGPT (GPT 3.5)
- **Development assistance**
- [](https://codeium.com/badges/main)
- **GitHub CoPilot**
- **Photos**
- *[Pexels](https://www.pexels.com)*
- **Art**
- *Bing Copilot Designer*
[Back To Contents](#contents)