Creating an Enterprise Resource Planner (ERP) software that may helps me managing my company. Currently WIP.
About my prod env: code has been build and tested on Django 4.0.2 and Python 3.8.8 running on Win11 machine.
- Clone the project:
git clone https://github.com/carloocchiena/django_erp.git
. - Create a virtual environment (conda
conda create -n my_env pip python=3.8
) (pythonpython3 -m venv my_env
). - Activate your virtual environment: (conda
conda activate my_env
) (Linux/MacOSsource my_env/bin/activate
) (Windowssource my_env/Scripts/activate
). - Install requirements.txt:
pip install -r requirements.txt
. - Create a
.env
file with your SECRET KEY - Navigate to the
erp
folder you want. - Make migrations with:
python manage.py makemigrations
and apply them withpython manage.py migrate
. - Let's start the engine with
python manage.py runserver
. - Have fun! :)
Run it in Docker with docker-compose up django_erp
The underlying idea is being able to quickly create templates for Companies and Products and cloning them upon necessity.
Payments and Invoices are expected to be inserted from time to time.
The filtered views allow to have a quick overview of how's the business going, specifically having in mind the daily checks you have to perform on outstanding credits and debits and invoices.
I may be willing to extend reporting features a bit, it depends from the free time I have to allocate on this project.
To run the automated test, input python manage.py test --parallel auto --verbosity=2
.
Use predefined docker-compose service if docker is available:
docker-compose -f docker-compose.test.yaml run --rm django_erp_tests
At the moment there are more near 100 test cases, covering from models, to forms, to views, and their underlying logics.
I took a personal challenge in tryin to do the whole project with Bootstrap 5, without using CSS stylesheet (that is in fact just made up of 3 row of code).
List of all the available feature as per 14 Sept 2022
Data entry
Automations
I created also some additional walktrought that should help you configuring your Django project:
Every feedback and contributions are welcome. Please just:
- Open an issue and discuss the changes you'd like to make or the bug\issue you'd like to report.
- Once ready to submit a pull request, provide proof of the testing you've done.