Django Point of Sale (POS) 💸

Point of Sale web app for businesses made with Python and Django for learning purposes

Table of Contents:

• Features
• Screenshots
• Tech Stack
• Installation
• Run it locally
• Contributing
• License

Screenshots

Click Here

Features

• Login Page with User authentication
• Dashboard Page with statistics and graphs
• DataTables with print, copy, to CSV, and to PDF buttons
• Categories Management (CRUD)
• Products Management (CRUD)
• Point of Sale (POS)
  • Search and add product to list
  • Calculate automatically the subtotal, grand total, tax amount
  • Remove product from the list
  • Update Item Quantity and Recalculate Total
  • Choose sale customer
  • Sale validation paid amount and at least one product
• Sales Management
  • List all Sales
  • View Sale details
  • Print Sale Receipt

Tech Stack

• Frontend: HTML, CSS, JavaScript, Boostrap, SweetAlert, DataTables,
• Backend: Django, Python, Ajax, SQLite,

Installation

1. Clone or download the repository:

git clone https://github.com/betofleitass/django_point_of_sale

2. Go to the project directory

cd django_point_of_sale

3. Create a virtual environment :

PowerShell:

 python -m venv venv
 venv\Scripts\Activate.ps1

Linux:

python3 -m venv venv
source venv/bin/activate

4. Install dependencies:
   pip install -r requirements.txt

5. Update pip and setuptools
   python -m pip install --upgrade pip setuptools

6. Install GTK to create the PDF files:
   Official documentation

7. If you have Windows (Important)‼:
   Add GTK to your path variables, suppose you installed GTK at:
   C:\Program Files\GTK3-Runtime Win64\bin
   That will be your new path variable

• Tutorial add to path variable

• If you get an error like cannot load library

8. Restart your computer

Run it locally

1. Go to the project directory: cd django_point_of_sale

2. Make database migrations:
   python manage.py makemigrations and python manage.py migrate

3. Create superuser python manage.py createsuperuser

   with the following data: username: admin, password: admin, email: admin@admin

4. Run the server: python manage.py runserver

5. Open a browser and go to: http://127.0.0.1:8000/

Contributing

Contributions are always welcome!

• Fork this repository;

• Create a branch with your feature: git checkout -b my-feature;

• Commit your changes: git commit -m "feat: my new feature";

• Push to your branch: git push origin my-feature.

Authors

• @betofleitass

License

This project is under MIT License.

Back to top ⬆️