Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/MicroPyramid/Django-CRM
Open Source CRM based on Django
https://github.com/MicroPyramid/Django-CRM
crm crm-online crm-platform crm-system django django-crm open-source python3
Last synced: about 2 months ago
JSON representation
Open Source CRM based on Django
- Host: GitHub
- URL: https://github.com/MicroPyramid/Django-CRM
- Owner: MicroPyramid
- License: mit
- Created: 2017-05-24T11:15:47.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-03-09T21:08:38.000Z (9 months ago)
- Last Synced: 2024-04-16T01:47:51.562Z (8 months ago)
- Topics: crm, crm-online, crm-platform, crm-system, django, django-crm, open-source, python3
- Language: Python
- Homepage: https://bottlecrm.io
- Size: 6.69 MB
- Stars: 1,801
- Watchers: 116
- Forks: 839
- Open Issues: 95
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-django - Django-CRM - Customer relationship management dashboard where you can manage customers at sales of the organization. It Provides to manage leads information and its activity, track issues from leads, manage contacts to send emails of leads and accounts. (CRM)
- jimsghstars - MicroPyramid/Django-CRM - Open Source CRM based on Django (Python)
README
# 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](https://github.com/MicroPyramid/Django-CRM)
2. Frontend UI [React CRM](https://github.com/MicroPyramid/react-crm "React CRM")
3. Mobile app [Flutter CRM]("https://github.com/MicroPyramid/flutter-crm")
## Runcode
Runcode is online developer workspace. It is cloud based simple, secure and ready to code workspaces, assuring high performance & fully configurable coding environment. With runcode you can run django-crm(API) with one-click.
- Open below link to create django-crm workspace on [RunCode](https://runcode.io/ "RunCode"). It will create django-crm API
[](https://runcode.io)
- After running API, Go to Frontend UI [React CRM](https://github.com/MicroPyramid/react-crm "React CRM") project to create new workspace with runcode.
## Docs
Please [Click Here](http://django-crm.readthedocs.io "Click Here") for latest documentation.
## Project Modules
This project contains the following modules:
- Contacts
- Companies
- Leads
- Accounts
- Invoices (todo)
- Cases (todo)
- Opportunity (todo)
## Try for free [here](https://bottlecrm.io/)
## Installation Guide
We recommend ubuntu 20.04. These instructions are verified for ubuntu 20.04.
#### To install system requirements
```
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 modify 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
workon
```
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.
### Docker / docker-compose
in order to use docker, please run the next commands after cloning repo:
```
docker build -t djcrm:1 -f docker/dockerfile .
docker-compose -f docker/docker-compose.yml up
```
**Note**: you must have docker/docker-compose installed on your host.
### next steps
```
python manage.py migrate
python manage.py runserver
```
- Then open http://localhost:8000/swagger/ in your browser to explore API.
- After running API, Go to Frontend UI [React CRM](https://github.com/MicroPyramid/react-crm "React CRM") project to configure Fronted UI to interact with API.
## Start celery worker in another terminal window
celery -A crm worker --loglevel=INFO
### Useful tools and packages
```
pipdeptree # to see pip dependency tree
black # to format code to meet python coding standards
pip-check -H # to see upgradable packages
isort # to sort imports in python
```
### Community
Get help or stay up to date.
- [Issues]()
- Follow [@micropyramid]() on Twitter
- Ask questions on [Stack Overflow]()
- Chat with community [Gitter]()
- For customizations, email to
## 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](https://micropyramid.com/contact-us/)
# Trigger deploy