From 25da41647c86c874e1c0ab3371c1214ae09351e2 Mon Sep 17 00:00:00 2001 From: Thanesh14 <152308211+Thanesh14@users.noreply.github.com> Date: Fri, 18 Oct 2024 19:18:40 +0530 Subject: [PATCH] README.md new EeazyCRM is an open-source CRM built with Flask, designed to help small and medium-sized businesses manage leads, contacts, deals, and more. It includes key features like pipeline management, reporting, and customizable settings. The project is still under development, with future plans for integrations like WordPress, Google Contacts, and MailChimp. Easily installable with Python and PostgreSQL, EeazyCRM aims to provide a flexible, user-friendly CRM solution. --- README.md | 106 ++++++++++++++++++++++++++++++------------------------ 1 file changed, 60 insertions(+), 46 deletions(-) diff --git a/README.md b/README.md index 88a33b07..9f2c2b94 100644 --- a/README.md +++ b/README.md @@ -61,52 +61,66 @@ create a new database with the following commands. Installation Steps ============ -1. Create a virtual environment using the following commands - .. code-block:: python - - virtualenv -p python3 eeazycrm - source eeazycrm/bin/activate - -2. Add github repository using the following command - - .. code-block:: python - - cd eeazycrm - git remote add origin https://github.com/jagjot2008/EeazyCRM - git pull origin master - -3. Now create the configuration file using the command - .. code-block:: python - - cp config_vars.example config_vars.py - - Open the config_vars.py file and add the database connection - parameters in the PRODUCTION DATABASE SETTINGS (Default). - - You can also setup the development and testing settings if you wish to. - -3. Install the dependencies - .. code-block:: python - - pip3 install -r requirements.txt - -4. Create the following environment variables - .. code-block:: python - - EMAIL_USER = - EMAIL_PASS = - - If you want to run flask in development or testing mode set - the following environment variable in addition to the above. - .. code-block:: python - - FLASK_ENV = development, or - FLASK_ENV = testing - -5. Run the command - .. code-block:: python - - python3 run.py +Step 1: Create and Navigate to the Project Directory +bash +mkdir eeazycrm +cd eeazycrm + +Step 2: Initialize Git Repository and Pull Project Code +bash +git init +git remote add origin https://github.com/jagjot2008/EeazyCRM.git +git pull origin master + +Step 3: Create and Activate a Virtual Environment +bash +virtualenv -p python3 eeazycrm_env +source eeazycrm_env/bin/activate + +Step 4: Install the Dependencies +bash +pip3 install -r requirements.txt + +Step 5: Set Up PostgreSQL +Ensure PostgreSQL is running, then open the terminal and execute the following commands: + +bash +psql +CREATE DATABASE eeazy_crm; + +Step 6: Create the Configuration File from Example +bash +cp config_vars.example config_vars.py +Open the config_vars.py file and add the PostgreSQL database connection credentials. For example: + +python +PRODUCTION_DATABASE_URI = 'postgresql://username:password@localhost/eeazy_crm' +You can also set up development and testing configurations if needed. + +Step 7: Set Environment Variables +Configure the environment variables needed for the application: + +bash +export EMAIL_USER= +export EMAIL_PASS= +export FLASK_ENV=development # or 'testing' +If you are using Windows, use set instead of export: + +bash +set EMAIL_USER= +set EMAIL_PASS= +set FLASK_ENV=development + +Step 8: Run the Application for the First Time (Installation Wizard) +bash +python3 run.py +This will run the installation wizard. Follow the on-screen instructions. + +Step 9: Restart the Application After Installation +Once the installation is complete, stop the application and restart it: + +bash +python3 run.py This will run the installation wizard. Follow the instructions in the wizard and after finishing installation, stop the