ashwin31 / django-crm

Django-CRM

============

Django CRM is opensource CRM developed on django framework. It has all the basic features of CRM to start with. We welcome code contributions and feature requests via github.

This is divided into three parts

1. Backend API Django CRM
2. Frontend UI React CRM
3. Mobile app Flutter CRM

http://django-crm.readthedocs.io for latest documentation

This project contains the following modules:

• Contacts
• Companies
• Leads
• Accounts
• Invoices (todo)
• Cases (todo)
• Opportunity (todo)

Try for free here

Installation

We recommend ubuntu 20.04. These instructions are verified for ubuntu 20.04.

To install required software

sudo apt update && sudo apt upgrade -y

sudo apt install python-is-python3 xvfb libfontconfig wkhtmltopdf python3-dev python3-pip build-essential libssl-dev libffi-dev python3-venv redis-server redis-tools virtualenv -y

Install dependencies

Optional (based on personal choice)

sudo apt update && sudo apt upgrade -y && sudo apt install zsh python3-virtualenv

sh -c "$(wget -O- https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

pip install virtualenvwrapper

echo "source /home/ubuntu/.local/bin/virtualenvwrapper.sh" >> ~/.zshrc

If you want to install postgres, follow https://www.postgresql.org/download/

to change postgresql root password

sudo -u postgres psql
ALTER USER postgres WITH PASSWORD 'root';

Create and activate a virtual environment.

if you installed and configured virtualenv wrapper then use the following

mkvirtualenv <env_name>
workon <env_name>

or else

virtualenv venv
source venv/bin/activate

Install the project's dependency after activating env

pip install -r requirements.txt

env variables

• Then refer to env.md for environment variables and keep those in the .env file in the current folder as your project is in.

next steps

python manage.py migrate
python manage.py runserver

Then open http://localhost:8000/swagger/ in your borwser to explore API.

start celery worker in another terminal window

celery -A tasks worker --loglevel=INFO

Useful tools and packages

pipdeptree # to see pip dependancy tree
black # to format code to meet python coding standards
pip-check -H  # to see upgradable packages

Community

Get help or stay up to date.

• Issues
• Follow @micropyramid on Twitter
• Ask questions on Stack Overflow
• Chat with community Gitter
• For customisations, email to [email protected]

Credits

Contributors

This project exists thanks to all the people who contribute!

Feature requests and bug reports

We welcome your feedback and support, raise github issue if you want to report a bug or request new feature. we are glad to help.

For commercial support Contact us

trigger deploy