Under development, not production ready yet.

Simple CRM

This project is a Django CRM app with login, signup, dashboard, profile management, and company administration.

Screenshots

Login

Dashboard

Companies

Run locally

Option 1: Docker Compose

From the project root:

docker compose up --build

Then open:

http://localhost:8000/

To stop it:

docker compose down

Option 2: Local virtual environment

1. Open a terminal in the project root.

2. Create and activate a virtual environment if you want an isolated setup:

   python -m venv .venv
   .venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

4. Change into the Django project directory:

   cd piv

5. Apply database migrations:

   python manage.py migrate

6. Start the app:

   python manage.py runserver

7. Open the app in a browser at:

   http://127.0.0.1:8000/
   

Default login and signup

• Signup is available from the login page.
• A user can log in after creating an account or by using an existing Django user.
• The app also includes seeded mock users for local testing if you want sample profile data available in the database.

Useful commands

Create a superuser:

python manage.py createsuperuser

Run tests:

python manage.py test crm

Collect static files:

python manage.py collectstatic