# sk-sanju/xenoerp architecture

> Architecture diagram of the GitHub repository sk-sanju/xenoerp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sk-sanju/xenoerp
- Repository: https://github.com/sk-sanju/xenoerp

## Overview

XenoCRM is a multi-tenant CRM and business-operations application. A user submits requests to the Django CRM views, which handle lead and business workflows against domain models; specialized document, messaging, notification, and HR components support those workflows. The domain spans organization and permissions, leads, projects and agreements, campaigns and content, activities, support, services, finance, and HR. The README is empty, so capabilities are inferred from the indexed modules and model excerpts; unsampled routes and integrations are omitted where their wiring is not evidenced.

Main entry points: [`crm/views.py`](https://github.com/sk-sanju/xenoerp/blob/main/crm/views.py) (CRM request views), [`crm/whatsapp_service.py`](https://github.com/sk-sanju/xenoerp/blob/main/crm/whatsapp_service.py) (WhatsApp messaging), [`hr/views.py`](https://github.com/sk-sanju/xenoerp/blob/main/hr/views.py) (HR workflows), [`crm/event_notifications.py`](https://github.com/sk-sanju/xenoerp/blob/main/crm/event_notifications.py) (Event notifications)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_crm_views["CRM request views<br/>[views.py]"]
end

subgraph group_crm["CRM workflows"]
  node_document_views["Document workflows<br/>[document_views.py]"]
  node_crm_forms["CRM forms<br/>[forms.py]"]
end

subgraph group_domains["Business domains"]
  node_org_access["Organizations and access<br/>[models.py]"]
  node_leads["Leads<br/>[models.py]"]
  node_projects["Projects and agreements<br/>[models.py]"]
  node_services["Services<br/>[models.py]"]
  node_activities["Activities and tasks<br/>[models.py]"]
  node_campaigns["Campaigns<br/>[models.py]"]
  node_content["Content tracking<br/>[models.py]"]
  node_support["Support tickets<br/>[models.py]"]
  node_finance["Finance and documents<br/>[models.py]"]
end

subgraph group_operations["Messaging and HR"]
  node_event_notifications["Event notifications"]
  node_reminder_scheduler["Reminder scheduler<br/>[apps.py]"]
  node_whatsapp["WhatsApp messaging"]
  node_hr_views["HR workflows<br/>[views.py]"]
  node_hr_forms["HR forms<br/>[forms.py]"]
  node_hr_models["HR records<br/>[models.py]"]
end

node_user(("CRM user"))
node_meta_api(("Meta API<br/>external service"))

node_user -->|"submits requests"| node_crm_views
node_crm_views -->|"uses access"| node_org_access
node_crm_views -->|"manages leads"| node_leads
node_crm_views -->|"manages projects"| node_projects
node_crm_views -->|"manages services"| node_services
node_crm_views -->|"manages activities"| node_activities
node_crm_views -->|"uses finance models"| node_finance
node_crm_views -->|"delegates documents"| node_document_views
node_crm_views -->|"uses forms"| node_crm_forms
node_crm_views -->|"sends messages"| node_whatsapp
node_crm_views -->|"uses notifications"| node_event_notifications
node_crm_views -->|"uses domain models"| node_campaigns
node_crm_views -->|"uses domain models"| node_content
node_crm_views -->|"uses domain models"| node_support
node_crm_views -->|"uses domain models"| node_projects
node_reminder_scheduler -->|"runs checks"| node_event_notifications
node_event_notifications -->|"uses CRM models"| node_crm_views
node_whatsapp -->|"logs activity"| node_activities
node_whatsapp -->|"sends API request"| node_meta_api
node_crm_views -.->|"HR routing unverified"| node_hr_views
node_hr_views -->|"uses forms"| node_hr_forms
node_hr_views -->|"manages HR records"| node_hr_models
node_hr_forms -->|"forms model data"| node_hr_models
node_hr_models -->|"references CRM models"| node_crm_views

click node_crm_views "https://github.com/sk-sanju/xenoerp/blob/main/crm/views.py"
click node_org_access "https://github.com/sk-sanju/xenoerp/blob/main/core/models.py"
click node_leads "https://github.com/sk-sanju/xenoerp/blob/main/leads/models.py"
click node_projects "https://github.com/sk-sanju/xenoerp/blob/main/projects/models.py"
click node_services "https://github.com/sk-sanju/xenoerp/blob/main/services/models.py"
click node_activities "https://github.com/sk-sanju/xenoerp/blob/main/activities/models.py"
click node_campaigns "https://github.com/sk-sanju/xenoerp/blob/main/campaigns/models.py"
click node_content "https://github.com/sk-sanju/xenoerp/blob/main/content_tracker/models.py"
click node_support "https://github.com/sk-sanju/xenoerp/blob/main/support/models.py"
click node_finance "https://github.com/sk-sanju/xenoerp/blob/main/finance/models.py"
click node_document_views "https://github.com/sk-sanju/xenoerp/blob/main/crm/document_views.py"
click node_crm_forms "https://github.com/sk-sanju/xenoerp/blob/main/crm/forms.py"
click node_event_notifications "https://github.com/sk-sanju/xenoerp/blob/main/crm/event_notifications.py"
click node_reminder_scheduler "https://github.com/sk-sanju/xenoerp/blob/main/crm/apps.py"
click node_whatsapp "https://github.com/sk-sanju/xenoerp/blob/main/crm/whatsapp_service.py"
click node_hr_views "https://github.com/sk-sanju/xenoerp/blob/main/hr/views.py"
click node_hr_forms "https://github.com/sk-sanju/xenoerp/blob/main/hr/forms.py"
click node_hr_models "https://github.com/sk-sanju/xenoerp/blob/main/hr/models.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_crm_views,node_user toneBlue
class node_document_views,node_crm_forms toneAmber
class node_org_access,node_leads,node_projects,node_services,node_activities,node_campaigns,node_content,node_support,node_finance,node_meta_api toneMint
class node_event_notifications,node_reminder_scheduler,node_whatsapp,node_hr_views,node_hr_forms,node_hr_models toneRose
```

## Components

### Application entry

- [CRM request views](https://github.com/sk-sanju/xenoerp/blob/main/crm/views.py): `crm/views.py`

### CRM workflows

- [Document workflows](https://github.com/sk-sanju/xenoerp/blob/main/crm/document_views.py): `crm/document_views.py`
- [CRM forms](https://github.com/sk-sanju/xenoerp/blob/main/crm/forms.py): `crm/forms.py`

### Business domains

- [Organizations and access](https://github.com/sk-sanju/xenoerp/blob/main/core/models.py): `core/models.py`
- [Leads](https://github.com/sk-sanju/xenoerp/blob/main/leads/models.py): `leads/models.py`
- [Projects and agreements](https://github.com/sk-sanju/xenoerp/blob/main/projects/models.py): `projects/models.py`
- [Services](https://github.com/sk-sanju/xenoerp/blob/main/services/models.py): `services/models.py`
- [Activities and tasks](https://github.com/sk-sanju/xenoerp/blob/main/activities/models.py): `activities/models.py`
- [Campaigns](https://github.com/sk-sanju/xenoerp/blob/main/campaigns/models.py): `campaigns/models.py`
- [Content tracking](https://github.com/sk-sanju/xenoerp/blob/main/content_tracker/models.py): `content_tracker/models.py`
- [Support tickets](https://github.com/sk-sanju/xenoerp/blob/main/support/models.py): `support/models.py`
- [Finance and documents](https://github.com/sk-sanju/xenoerp/blob/main/finance/models.py): `finance/models.py`

### Messaging and HR

- [Event notifications](https://github.com/sk-sanju/xenoerp/blob/main/crm/event_notifications.py): `crm/event_notifications.py`
- [Reminder scheduler](https://github.com/sk-sanju/xenoerp/blob/main/crm/apps.py): `crm/apps.py`
- [WhatsApp messaging](https://github.com/sk-sanju/xenoerp/blob/main/crm/whatsapp_service.py): `crm/whatsapp_service.py`
- [HR workflows](https://github.com/sk-sanju/xenoerp/blob/main/hr/views.py): `hr/views.py`
- [HR forms](https://github.com/sk-sanju/xenoerp/blob/main/hr/forms.py): `hr/forms.py`
- [HR records](https://github.com/sk-sanju/xenoerp/blob/main/hr/models.py): `hr/models.py`

### Other components

- **CRM user**
- **Meta API**: external service

## Connections

- CRM user → CRM request views: submits requests (evidence: `crm/views.py`)
- CRM request views → Organizations and access: uses access (evidence: `crm/views.py`)
- CRM request views → Leads: manages leads (evidence: `crm/views.py`)
- CRM request views → Projects and agreements: manages projects (evidence: `crm/views.py`)
- CRM request views → Services: manages services (evidence: `crm/views.py`)
- CRM request views → Activities and tasks: manages activities (evidence: `crm/views.py`)
- CRM request views → Finance and documents: uses finance models (evidence: `crm/views.py`)
- CRM request views → Document workflows: delegates documents (evidence: `crm/views.py`)
- CRM request views → CRM forms: uses forms (evidence: `crm/views.py`)
- CRM request views → WhatsApp messaging: sends messages (evidence: `crm/views.py`)
- CRM request views → Event notifications: uses notifications (evidence: `crm/views.py`)
- CRM request views → Campaigns: uses domain models
- CRM request views → Content tracking: uses domain models
- CRM request views → Support tickets: uses domain models
- CRM request views → Projects and agreements: uses domain models
- Reminder scheduler → Event notifications: runs checks (evidence: `crm/apps.py`)
- Event notifications → CRM request views: uses CRM models (evidence: `crm/event_notifications.py`)
- WhatsApp messaging → Activities and tasks: logs activity (evidence: `crm/whatsapp_service.py`)
- WhatsApp messaging → Meta API: sends API request (evidence: `crm/whatsapp_service.py`)
- CRM request views → HR workflows: HR routing unverified (evidence: `hr/views.py`)
- HR workflows → HR forms: uses forms (evidence: `hr/views.py`)
- HR workflows → HR records: manages HR records (evidence: `hr/views.py`)
- HR forms → HR records: forms model data (evidence: `hr/forms.py`)
- HR records → CRM request views: references CRM models (evidence: `hr/models.py`)
