megamayoy / django-ra-erp

A Django based framework to create diverse business solutions, equipped with a reporting engine and a responsive dashboard.

Ra Framework

A light-weight effective Django based framework to create business applications and various resource planing systems (ERP), equipped with a reporting engine and a responsive dashboard.

Demo

Please visit Installation Demo, Credentials are admin/adminpassword

The code for the installation demo (which is the tutorial found in the docs) can be viewed and installed Here

Updates

Release Date is set to July the first 2020.

The Django Ra ERP reporting engine is released in a separate package django-slick-reporting

Features

• A responsive dashboard built on top of Django's admin and Bootstrap AdminLte theme.
• Using Django Slick Reporting for report Engine to compute and chart several types of reports with simple lines of code.
• A charting capabilities
• A widget system to display reports and its charts on dashboard home , or on object's view pages.
• Tools and goodies to extend and customize the framework behavior from top to bottom.
• Python 3.6 / 3.7 / 3.8
• Django 2.2, 3.0 Compatible

Installation

$ pip install django-ra-erp

Quick start

1. Create a virtual environment and install ra-framework from Pypi

   $ mkvirtualenv ra-env (or `virtualenv` if you dont have mkvirtualenv)
   $ pip install django-ra-erp

2. Once Ra installed, it provides a command to generate a new project.

   $ ra-admin start myproject

   This will create a new project folder myproject, based on a template containing everything you need to get started. You can always integrate ra framework to your existing project, please refer to the docs Integrating into an existing django project

3. Run the usual commands needed for any django project

   $ ./manage.py migrate
   $ ./manage.py createsuperuser
   $ ./manage.py runserver

4. Voila!! Your site should now up and running at http://localhost:8000. Enter your super user credentials and login.

Documentation

Available on Read The Docs

Please Proceed to the tutorial Create a sales application Part 1

Testing and contribution

To run the test suite, first, create and activate a virtual environment. Then clone the repo, install the test requirements and run the tests:

# 1. Clone and install requirements
$ git clone [e-mail]:ra-systems/RA.git
$ cd tests
$ python -m pip install -e ..
$ python -m pip install -r requirements/py3.txt

# 2. Set the test database connection details in the environment
$ export DATABASE_NAME=<database name>
$ export DATABASE_USER=<database user>
$ export DATABASE_PASSWORD=<database password if any>

# 3. Run the tests
$ ./runtests.py
# And for Coverage report
$ coverage run --include=../* runtests.py [-k]
$ coverage html

For more information on contributing, we honor Django's guidelines.