# salievyt/deo-crm architecture

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

- Interactive diagram: https://gitdiagram.com/salievyt/deo-crm
- Repository: https://github.com/salievyt/deo-crm

## Overview

DEO STUDIO CRM is a multi-channel CRM for a digital studio, with a Django REST API and Next.js web app. The principal workflow is sales work: staff manage leads and clients, convert leads into deals, and track projects and tasks; supporting areas include finance, documents, analytics, communications, automation, and client self-service. Edges reflect excerpted calls or README descriptions; dashed links mark web/API wiring that the supplied evidence does not show directly.

Main entry points: [`backend/config/urls.py`](https://github.com/salievyt/deo-crm/blob/main/backend/config/urls.py) (Django REST API), [`backend/apps/reminders/services.py`](https://github.com/salievyt/deo-crm/blob/main/backend/apps/reminders/services.py) (Reminder engine), [`backend/apps/clients/services.py`](https://github.com/salievyt/deo-crm/blob/main/backend/apps/clients/services.py) (Client health), [`backend/apps/leads/models.py`](https://github.com/salievyt/deo-crm/blob/main/backend/apps/leads/models.py) (Lead pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Identity and access"]
  node_accounts[("Users and roles<br/>[models.py]")]
end

subgraph group_sales["Sales and delivery"]
  node_leads[("Lead pipeline<br/>[models.py]")]
  node_clients[("Client records<br/>[models.py]")]
  node_clienthealth["Client health<br/>[services.py]"]
  node_deals["Deals<br/>[services.py]"]
  node_catalog[("Catalog and stock<br/>[models.py]")]
  node_projects[("Projects<br/>[models.py]")]
  node_tasks[("Tasks<br/>[models.py]")]
end

subgraph group_operations["Business operations"]
  node_finance[("Invoices and finance<br/>[models.py]")]
  node_documents[("Documents<br/>[models.py]")]
  node_analytics["Analytics and reports<br/>[services.py]"]
  node_reminders["Reminder engine<br/>[services.py]"]
end

subgraph group_engagement["Communications and automation"]
  node_calls[("Call records<br/>[models.py]")]
  node_messaging["Messaging channels<br/>[conversations.py]"]
  node_scenarios["Reply automation<br/>[services.py]"]
  node_messenger[("Team messenger<br/>[models.py]")]
  node_ai["AI assistant<br/>[services.py]"]
end

subgraph group_product["User applications"]
  node_web["Web application<br/>[page.tsx]"]
  node_api["Django REST API<br/>[urls.py]"]
  node_cabinet["Client cabinet<br/>[views.py]"]
end

node_staff(("Studio staff"))

node_staff -.->|"uses"| node_web
node_web -.->|"requests data"| node_api
node_api -.->|"authenticates"| node_accounts
node_api -.->|"manages leads"| node_leads
node_api -.->|"manages clients"| node_clients
node_api -.->|"manages deals"| node_deals
node_api -.->|"manages projects"| node_projects
node_api -.->|"manages tasks"| node_tasks
node_api -.->|"serves finance"| node_finance
node_api -.->|"serves documents"| node_documents
node_api -.->|"serves reports"| node_analytics
node_api -.->|"serves messaging"| node_messaging
node_api -.->|"serves assistant"| node_ai
node_api -.->|"serves cabinet"| node_cabinet
node_deals -->|"updates stock"| node_catalog
node_leads -->|"signals events"| node_scenarios
node_scenarios -->|"sends replies"| node_messaging
node_clients -->|"evaluates health"| node_clienthealth
node_clienthealth -->|"checks invoices"| node_finance
node_clienthealth -->|"checks activity"| node_leads
node_clienthealth -->|"checks messages"| node_messenger
node_reminders -->|"scans clients"| node_clients
node_reminders -->|"scans invoices"| node_finance
node_reminders -->|"scans leads"| node_leads
node_reminders -->|"scans tasks"| node_tasks
node_calls -->|"matches callers"| node_clients
node_calls -->|"matches employees"| node_accounts
node_calls -->|"logs events"| node_messaging

click node_web "https://github.com/salievyt/deo-crm/blob/main/frontend/src/app/(dashboard)/dashboard/page.tsx"
click node_api "https://github.com/salievyt/deo-crm/blob/main/backend/config/urls.py"
click node_accounts "https://github.com/salievyt/deo-crm/blob/main/backend/apps/accounts/models.py"
click node_leads "https://github.com/salievyt/deo-crm/blob/main/backend/apps/leads/models.py"
click node_clients "https://github.com/salievyt/deo-crm/blob/main/backend/apps/clients/models.py"
click node_clienthealth "https://github.com/salievyt/deo-crm/blob/main/backend/apps/clients/services.py"
click node_deals "https://github.com/salievyt/deo-crm/blob/main/backend/apps/deals/services.py"
click node_catalog "https://github.com/salievyt/deo-crm/blob/main/backend/apps/catalog/models.py"
click node_projects "https://github.com/salievyt/deo-crm/blob/main/backend/apps/projects/models.py"
click node_tasks "https://github.com/salievyt/deo-crm/blob/main/backend/apps/tasks/models.py"
click node_finance "https://github.com/salievyt/deo-crm/blob/main/backend/apps/finance/models.py"
click node_documents "https://github.com/salievyt/deo-crm/blob/main/backend/apps/documents/models.py"
click node_analytics "https://github.com/salievyt/deo-crm/blob/main/backend/apps/analytics/services.py"
click node_reminders "https://github.com/salievyt/deo-crm/blob/main/backend/apps/reminders/services.py"
click node_calls "https://github.com/salievyt/deo-crm/blob/main/backend/apps/calls/models.py"
click node_messaging "https://github.com/salievyt/deo-crm/blob/main/backend/apps/messaging/services/conversations.py"
click node_scenarios "https://github.com/salievyt/deo-crm/blob/main/backend/apps/scenarios/services.py"
click node_messenger "https://github.com/salievyt/deo-crm/blob/main/backend/apps/messenger/models.py"
click node_ai "https://github.com/salievyt/deo-crm/blob/main/backend/apps/ai_assistant/services.py"
click node_cabinet "https://github.com/salievyt/deo-crm/blob/main/backend/apps/cabinet/views.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_accounts toneBlue
class node_leads,node_clients,node_clienthealth,node_deals,node_catalog,node_projects,node_tasks toneAmber
class node_finance,node_documents,node_analytics,node_reminders toneMint
class node_calls,node_messaging,node_scenarios,node_messenger,node_ai toneRose
class node_web,node_api,node_cabinet,node_staff toneIndigo
```

## Components

### Identity and access

- [Users and roles](https://github.com/salievyt/deo-crm/blob/main/backend/apps/accounts/models.py): `backend/apps/accounts/models.py`

### Sales and delivery

- [Lead pipeline](https://github.com/salievyt/deo-crm/blob/main/backend/apps/leads/models.py): `backend/apps/leads/models.py`
- [Client records](https://github.com/salievyt/deo-crm/blob/main/backend/apps/clients/models.py): `backend/apps/clients/models.py`
- [Client health](https://github.com/salievyt/deo-crm/blob/main/backend/apps/clients/services.py): `backend/apps/clients/services.py`
- [Deals](https://github.com/salievyt/deo-crm/blob/main/backend/apps/deals/services.py): `backend/apps/deals/services.py`
- [Catalog and stock](https://github.com/salievyt/deo-crm/blob/main/backend/apps/catalog/models.py): `backend/apps/catalog/models.py`
- [Projects](https://github.com/salievyt/deo-crm/blob/main/backend/apps/projects/models.py): `backend/apps/projects/models.py`
- [Tasks](https://github.com/salievyt/deo-crm/blob/main/backend/apps/tasks/models.py): `backend/apps/tasks/models.py`

### Business operations

- [Invoices and finance](https://github.com/salievyt/deo-crm/blob/main/backend/apps/finance/models.py): `backend/apps/finance/models.py`
- [Documents](https://github.com/salievyt/deo-crm/blob/main/backend/apps/documents/models.py): `backend/apps/documents/models.py`
- [Analytics and reports](https://github.com/salievyt/deo-crm/blob/main/backend/apps/analytics/services.py): `backend/apps/analytics/services.py`
- [Reminder engine](https://github.com/salievyt/deo-crm/blob/main/backend/apps/reminders/services.py): `backend/apps/reminders/services.py`

### Communications and automation

- [Call records](https://github.com/salievyt/deo-crm/blob/main/backend/apps/calls/models.py): `backend/apps/calls/models.py`
- [Messaging channels](https://github.com/salievyt/deo-crm/blob/main/backend/apps/messaging/services/conversations.py): `backend/apps/messaging/services/conversations.py`
- [Reply automation](https://github.com/salievyt/deo-crm/blob/main/backend/apps/scenarios/services.py): `backend/apps/scenarios/services.py`
- [Team messenger](https://github.com/salievyt/deo-crm/blob/main/backend/apps/messenger/models.py): `backend/apps/messenger/models.py`
- [AI assistant](https://github.com/salievyt/deo-crm/blob/main/backend/apps/ai_assistant/services.py): `backend/apps/ai_assistant/services.py`

### User applications

- [Web application](https://github.com/salievyt/deo-crm/blob/main/frontend/src/app/(dashboard)/dashboard/page.tsx): `frontend/src/app/(dashboard)/dashboard/page.tsx`
- [Django REST API](https://github.com/salievyt/deo-crm/blob/main/backend/config/urls.py): `backend/config/urls.py`
- [Client cabinet](https://github.com/salievyt/deo-crm/blob/main/backend/apps/cabinet/views.py): `backend/apps/cabinet/views.py`

### Other components

- **Studio staff**

## Connections

- Studio staff → Web application: uses (evidence: `README.md`)
- Web application → Django REST API: requests data (evidence: `README.md`)
- Django REST API → Users and roles: authenticates (evidence: `README.md`)
- Django REST API → Lead pipeline: manages leads (evidence: `README.md`)
- Django REST API → Client records: manages clients (evidence: `README.md`)
- Django REST API → Deals: manages deals (evidence: `README.md`)
- Django REST API → Projects: manages projects (evidence: `README.md`)
- Django REST API → Tasks: manages tasks (evidence: `README.md`)
- Django REST API → Invoices and finance: serves finance (evidence: `README.md`)
- Django REST API → Documents: serves documents (evidence: `README.md`)
- Django REST API → Analytics and reports: serves reports (evidence: `README.md`)
- Django REST API → Messaging channels: serves messaging (evidence: `README.md`)
- Django REST API → AI assistant: serves assistant (evidence: `README.md`)
- Django REST API → Client cabinet: serves cabinet (evidence: `README.md`)
- Deals → Catalog and stock: updates stock (evidence: `backend/apps/deals/services.py`)
- Lead pipeline → Reply automation: signals events
- Reply automation → Messaging channels: sends replies (evidence: `backend/apps/scenarios/services.py`)
- Client records → Client health: evaluates health (evidence: `backend/apps/clients/services.py`)
- Client health → Invoices and finance: checks invoices (evidence: `backend/apps/clients/services.py`)
- Client health → Lead pipeline: checks activity (evidence: `backend/apps/clients/services.py`)
- Client health → Team messenger: checks messages (evidence: `backend/apps/clients/services.py`)
- Reminder engine → Client records: scans clients (evidence: `backend/apps/reminders/services.py`)
- Reminder engine → Invoices and finance: scans invoices (evidence: `backend/apps/reminders/services.py`)
- Reminder engine → Lead pipeline: scans leads (evidence: `backend/apps/reminders/services.py`)
- Reminder engine → Tasks: scans tasks (evidence: `backend/apps/reminders/services.py`)
- Call records → Client records: matches callers (evidence: `backend/apps/calls/services.py`)
- Call records → Users and roles: matches employees (evidence: `backend/apps/calls/services.py`)
- Call records → Messaging channels: logs events
