/Store

Stock Management System, Built using Django

Primary LanguagePython

Stocky

Dashboard

Stocky is Stock Management System, Built using Django framework

Why Stocky

You can use this project to Add, edit and manage all these models

  1. Company information.
  2. Branches.
  3. Branches managers and their permissions.
  4. Products.
  5. Product quantities
  6. Imports.
  7. Sales.
  8. Invoices.

The project contains a dashboard to

  1. Review all remaining quantities.
  2. Charts to show progress.
  3. Filter using a date to review how was your progress on this date.

Technologies

To build this project we used several technologies

  1. Django framework
  2. MySQL
  3. Docker
  4. Wkhtmltopdf package

Installation

Add envirnoment vriables

copy .env.example to .env and fill the values of the variables, Example

# MySQL Env. variables
MYSQL_ROOT_PASSWORD=root
MYSQL_DATABASE=django-dbname
MYSQL_USERNAME=root
MYSQL_PASSWORD=root

# Database host
DB_HOST=db
DB_PORT=3306

Install and run docker

The benefit to having docker in your project is you don't need to worry about dependencies, just install docker, docker-compose and docker-machine then run

$ docker-compose build
$ docker-compose up

Run

  1. Create superuser for login
$ docker-compose exec web python manage.py createsuperuser
  1. to generate random data for testing
$ docker-compose exec web python generateData.py