/django_point_of_sale

Grocery Point of Sale (POS) System in Python Django

Primary LanguageHTMLMIT LicenseMIT

Django Point of Sale (POS) 💸

A Point of Sale web app for businesses built with Python and Django for learning purposes.



Table of Contents:

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 and Products Management
  • Clients Management
  • Sales Management

Tech Stack

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

Installation

Prerequisites

Browser Compatibility Notice: Firefox NOT Supported ‼

Please Use Chrome or Edge Browsers ‼

  1. Clone or download the repository:

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

  1. Go to the project directory

cd django_point_of_sale

  1. Create a virtual environment :

PowerShell:

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

Linux:

python3 -m venv venv
source venv/bin/activate

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

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

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

  4. Windows Users (IMPORTANT)‼:

    Only Windows 11 64-bit is supported ‼

    After installing GTK, you need to add it to your system's Path environment variable. Follow these steps:

    • Assuming you installed GTK at: C:\Program Files\GTK3-Runtime Win64\bin
      This will be your new variable that you need to add to Path

    • Refer to this tutorial for detailed instructions on adding to the Path environment variable: Tutorial add to the Path enviroment variable

    • If you encounter an error such as "cannot load library," refer to this documentation for troubleshooting: Missing Library Error

  5. Restart your computer: After completing the steps above, it is essential to restart your computer for the changes to take effect properly. ‼

Run it locally

After restarting your computer

  1. Go to the project directory: cd django_point_of_sale

  2. Activate the virtual enviroment

    PowerShell:

     venv\Scripts\Activate.ps1

    Linux:

    source venv/bin/activate

  3. Go to the django_pos folder: cd django_pos

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

  5. Create superuser python manage.py createsuperuser

    with the following data, or with the data you prefer: username: admin, password: admin, email: admin@admin

  6. Run the server: python manage.py runserver

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

  8. Log In with your superuser credentials.

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

License

This project is under MIT License.

Back to top ⬆️