{"id":28497884,"url":"https://github.com/adarshvishwakarma12/crm-software","last_synced_at":"2026-04-10T15:05:07.893Z","repository":{"id":296444022,"uuid":"993402897","full_name":"AdarshVishwakarma12/crm-software","owner":"AdarshVishwakarma12","description":"Custom CRM software with multi-user access, project tracking, task management, and trash recovery, built using Django.","archived":false,"fork":false,"pushed_at":"2025-07-27T06:11:01.000Z","size":41231,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-27T08:24:49.801Z","etag":null,"topics":["bootstrap4","crm","css","deployed","django","docker","docker-compose","github-container-registry","google-oauth2","html","javascript","python3","role-based-access-control"],"latest_commit_sha":null,"homepage":"https://ctrlcrm.pythonanywhere.com/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AdarshVishwakarma12.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-30T18:20:23.000Z","updated_at":"2025-06-02T22:15:44.000Z","dependencies_parsed_at":"2025-07-27T08:28:12.938Z","dependency_job_id":null,"html_url":"https://github.com/AdarshVishwakarma12/crm-software","commit_stats":null,"previous_names":["adarshvishwakarma12/crm-software"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/AdarshVishwakarma12/crm-software","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdarshVishwakarma12%2Fcrm-software","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdarshVishwakarma12%2Fcrm-software/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdarshVishwakarma12%2Fcrm-software/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdarshVishwakarma12%2Fcrm-software/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AdarshVishwakarma12","download_url":"https://codeload.github.com/AdarshVishwakarma12/crm-software/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdarshVishwakarma12%2Fcrm-software/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278722724,"owners_count":26034461,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bootstrap4","crm","css","deployed","django","docker","docker-compose","github-container-registry","google-oauth2","html","javascript","python3","role-based-access-control"],"created_at":"2025-06-08T13:06:55.926Z","updated_at":"2025-10-07T04:44:34.639Z","avatar_url":"https://github.com/AdarshVishwakarma12.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Customer Relationship Management Software – CRM\n\n**CRM software built with Django to organize contacts, tasks, documents, and user roles efficiently.**\n\n## Overview\n\nThis project provides core features of a customer relationship management system, including contact management, task tracking, document storage, and multi-user access. It is designed for individuals and small teams who need an easy-to-use tool without the overhead of complex enterprise solutions.\n\n## Key Features\n\n- **User Authentication**  \n  Register, login, logout, and Google OAuth integration.\n\n- **Dashboard Overview**  \n  Centralized view of total contacts, tasks, documents, and recent activity.\n\n- **Contact Management**  \n  Organize clients by project, view detailed info, and manage soft-delete/restore.\n\n- **Task Management**  \n  Create and track tasks with priorities, status updates, and related entities.\n\n- **Document Storage**  \n  Upload and manage files linked to contacts or projects, with restore support.\n\n- **Role-Based Access Control**  \n  Assign granular permissions (read/write/delete) to users across the app.\n\n- **Multi-User Account Switching**  \n  Switch between personal and shared accounts for collaborative workspaces.\n\n- **Activity Tracking**  \n  Automatic logging of recent actions for historical context.\n\n- **Theme Support**  \n  Light, dark, and system themes with persistent local storage.\n\n- **Trash System**  \n  Soft-delete logic for reversible deletion of tasks, contacts, and documents.\n\n- **Feedback Submission**  \n  Built-in form for sending issues, or suggestions.\n\n## Tech Stack\n\n- **Backend:** Django\n- **Frontend:** HTML/CSS (Django templating)\n- **Database:** SQLite (default, can be switched)\n- **Hosting:** PythonAnywhere (demo)\n\n## Live Demo\n\n[Live Application](https://ctrlcrm.pythonanywhere.com)\n\n## Running from Source\nFollow these steps to run the project on your local machine:\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/AdarshVishwakarma12/crm-software.git\n   ```\n\n2. Navigate to the project directory:\n   ```bash\n   cd crm-software\n   ```\n\n3. Start the Docker service on your machine.\n\n4. Build and run the Docker containers:\n   ```bash\n   docker-compose up -d --build\n   ```\n\n5. Open your browser and navigate to:\n   ```\n   http://localhost:8000\n   ```\n\n6. Bingo! The application is now running locally.\n\n## Running via Docker Image (Recommended)\nFollow these steps to run the project on your local machine:\n\n1. Make sure Docker is installed and running\n\n2. Pull the latest image\n   ```bash\n   docker pull ghcr.io/adarshvishwakarma12/crm-software:latest\n   ```\n\n3. Run the container\n   ```bash\n   docker run -p 8000:8000 ghcr.io/adarshvishwakarma12/crm-software:latest\n   ```\n\n4. Open your browser and navigate to:\n   ```\n   http://localhost:8000\n   ```\n\nYou should now see the CRM application running.\n\n## Environment Variables\n\nThe app uses environment variables for email configuration (send-feedback section).\n\nIn `docker-compose.yml` / `Dockerfile`, placeholder values are provided for development:\n\n```yaml\nEMAIL_HOST_USER=none@gmail.com\nEMAIL_HOST_PASSWORD=None\n```\n\nThese are **not real credentials**. To use actual email features, replace them with valid SMTP credentials.\n\n## Disclaimer\n\n\u003e This project is actively being improved and is intended for educational or small-scale personal use. While fully functional, it may lack the scalability and advanced features found in commercial CRM systems.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadarshvishwakarma12%2Fcrm-software","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadarshvishwakarma12%2Fcrm-software","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadarshvishwakarma12%2Fcrm-software/lists"}