ShopPharma is an E-Commerce Python/Django application made for pharmaceutical sale businesses. It has features such as authentication,drug lists, carts, coupons, make orders and payments, view order history.
- Python as the server language
- Django Framework as the server framework
- PostgreSQL as the database.
- HTML, CSS, JavaScripts with Bootstrap 4 for the application's frontend.
├── README.md
├── manage.py *** the main driver of the app.
"python manage.py runserver" to run after installing dependences
├── Authentication *** Authentication application
├── static
│ ├── css
│ ├── bootstrap
│ ├── fonts
│ ├── images
│ └── js
└── templates
├── authentications
└── base.html
├── admin.py *** admin app for the authentication
├── forms.py *** forms for rendering on registration and login pages.
├── models.py *** Models for authentication
├── urls.py *** URLS for the authentication application
└── views.py *** View functions for the authentication app
├── cart *** Cart application
├── coupons *** Coupon system application
├── orders *** Orders application
├── shop *** Products applications
├── Shoppharm *** Project folder
│ ├── settings
│ │ ├── base.py *** settings of the project
│ │ ├── development.py *** setting for development environment
│ │ └── production.py *** setting for production environment
└── url.py *** main urls.py file
└── requirements.txt
- Users can signup and login both traditionally and through Facebook, Google OAuth to the e-commerce platform.
- Users can reset their passwords.
- Users can view all listings of drugs on the platform marked as available by the admin.
- Admin can post products on the platform.
- Users can choose to Create, Read, Update, Delete a drug to their cart and checkout to make payment.
- Users that make orders will recieve emails confirming their orders have been recieved by the admin.
- Users can view history of all their purchases.
- Admin can view all orders created and can print PDF of the invoices.
- Admin can download orders as csv file for Data Analysis or other purposes.
Users can signup onto the system with details such as First Name, Last Name, Email Addresse, Telephone, Password.
Users will be authenticated using only their Email Address and Password.
To start and run the local development server, Clone the repository, run the virtual environment and install all requirements.
- Initialize and activate a virtualenv:
git clone https://github.com/Emmanuel-Okyere/shoppharma.git
$ cd YOUR_PROJECT_DIRECTORY_PATH/
$ virtualenv --no-site-packages env
$ source env/bin/activate --linux
for windows run
venv/Scripts/activate- Install the dependencies:
$ pip install -r requirements.txt
- Run the development server:
python manage.py makemigrations
python manage.py migrate
python manage.py runserver- Navigate to Home page http://127.0.0.1:8000/
You can access the live application using the provided link below.
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
This project is still under development.