No description
Find a file
2026-09-26 08:18:14 +00:00
crm_core Scaffold Phase 1 CRM models and apps 2026-09-26 07:31:43 +00:00
custom_objects fix(custom_objects): allow blank=True on CustomRecord.data 2026-09-26 07:44:38 +00:00
frontend fix(security, workflows, outreach): remove hardcoded credentials, connect runFlow API, test outreach engine, add requirements.txt 2026-09-26 08:18:14 +00:00
openforce fix(security, workflows, outreach): remove hardcoded credentials, connect runFlow API, test outreach engine, add requirements.txt 2026-09-26 08:18:14 +00:00
outreach Scaffold Phase 1 CRM models and apps 2026-09-26 07:31:43 +00:00
tests fix(security, workflows, outreach): remove hardcoded credentials, connect runFlow API, test outreach engine, add requirements.txt 2026-09-26 08:18:14 +00:00
workflows fix(security, workflows, outreach): remove hardcoded credentials, connect runFlow API, test outreach engine, add requirements.txt 2026-09-26 08:18:14 +00:00
.coveragerc Scaffold Phase 1 CRM models and apps 2026-09-26 07:21:21 +00:00
.gitignore chore: gitignore frontend node_modules 2026-09-26 07:45:21 +00:00
manage.py Scaffold Phase 1 CRM models and apps 2026-09-26 07:21:21 +00:00
pytest.ini Scaffold Phase 1 CRM models and apps 2026-09-26 07:21:21 +00:00
README.md docs: add project README.md documenting architecture, features, and setup 2026-09-26 08:07:24 +00:00
requirements.txt fix(security, workflows, outreach): remove hardcoded credentials, connect runFlow API, test outreach engine, add requirements.txt 2026-09-26 08:18:14 +00:00

OpenForce — Salesforce Recreation in Django & Vue 3

OpenForce is an enterprise-grade Customer Relationship Management (CRM) platform recreating the core capabilities of Salesforce using Python/Django 4.2 REST Framework on the backend and Vue 3 + TailwindCSS + Pinia on the frontend.

Key Features

  1. Standard CRM Tracking:

    • Leads: Complete lifecycle tracking with atomic lead conversion (Lead -> Account + Contact + Opportunity).
    • Accounts: Hierarchical organization tracking (parent-child relationships).
    • Contacts: Person records mapped to accounts with full contact details.
    • Opportunities: Pipeline stage management with automatic expected revenue calculations (Amount * Probability%).
    • Activities & Tasks: Polymorphic task logging across Leads, Contacts, and Accounts with completion tracking.
  2. Dynamic Custom Objects Metamodel:

    • Create custom schemas (CustomObjectDefinition + CustomFieldDefinition) on the fly like Salesforce __c objects.
    • Dynamic JSONB storage with PostgreSQL GIN index (idx_custom_record_data_gin).
    • Dynamic Draft-07 JSONSchema validation on record creation and partial PATCH updates.
    • RESTful dynamic endpoints: /api/custom/<object_name>/.
  3. Visual Flow Builder (Automation DAG Engine):

    • Visual workflow editor powered by @vue-flow/core.
    • Kahn's algorithm topological sorting with cycle detection and dangling edge prevention.
    • Conditional branch evaluation and execution tracing with idempotency keys.
  4. Outreach & Email Campaigns:

    • Safe merge-tag template engine ({{ first_name }}, {{ company }}).
    • Campaign batch dispatching with 1x1 transparent tracking pixel injection.

Running Locally

Backend (Django)

python manage.py migrate
python manage.py collectstatic --noinput
python manage.py runserver 0.0.0.0:8000

Running Tests

pytest --cov=crm_core --cov=custom_objects --cov=workflows --cov=outreach