# jorgebendekj/trycrm architecture

> Architecture diagram of the GitHub repository jorgebendekj/trycrm, 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/jorgebendekj/trycrm
- Repository: https://github.com/jorgebendekj/trycrm

## Overview

Ribentek AI is an agent-first CRM: users and connected systems provide records and activity; a durable agent researches, evaluates evidence, updates CRM records, and schedules follow-ups, while users review results in the workspace. The API also serves CRM and settings workflows and ingests connected-channel activity. The README documents major integrations and agent capabilities; sampled source/index references establish several service dependencies, but much of the UI and integration implementation was not sampled, so their internal links are omitted.

Main entry points: [`packages/db/src/client.ts`](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/packages/db/src/client.ts) (Postgres data), [`apps/agent/agent/lib/run-runtime.ts`](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/agent/agent/lib/run-runtime.ts) (Agent runtime), [`apps/api/src/agent/agent-queue.service.ts`](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/agent/agent-queue.service.ts) (Agent queue), [`apps/api/src/contacts/contacts.service.ts`](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/contacts/contacts.service.ts) (Contacts service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["CRM Workspace"]
  node_workspace_ui["CRM and agent UI<br/>[page.tsx]"]
  node_agent_builder_ui["Agent builder"]
end

subgraph group_api["CRM API"]
  node_api_entry["API routes<br/>[create-app.ts]"]
  node_contacts["Contacts service"]
  node_companies["Companies service"]
  node_deals["Deals service<br/>[deals.service.ts]"]
  node_fields["Custom fields<br/>[fields.service.ts]"]
  node_tracking_ingest["Visitor tracking"]
  node_agent_queue["Agent queue"]
end

subgraph group_agent["Durable Agent"]
  node_agent_dispatch["Task dispatch<br/>[dispatch.ts]"]
  node_agent_tasks["Task leasing<br/>[tasks.ts]"]
  node_agent_runtime["Agent runtime<br/>[run-runtime.ts]"]
  node_agent_tools["Research and CRM tools"]
  node_agent_runner["Team agent runner<br/>[agent.ts]"]
end

subgraph group_integrations["Connected Channels"]
  node_whatsapp["WhatsApp filing"]
  node_mail_sync["Mailbox sync"]
  node_voice_runtime["Voice runtime<br/>[main.py]"]
end

subgraph group_data["Persistence"]
  node_database[("Postgres data<br/>[client.ts]")]
  node_crm_activity["CRM activity stamps"]
end

node_user(("CRM user"))

node_user -->|"uses"| node_workspace_ui
node_workspace_ui -.->|"requests CRM"| node_api_entry
node_user -->|"describes agent"| node_agent_builder_ui
node_agent_builder_ui -.->|"bridges conversations"| node_agent_runtime
node_contacts -->|"queues work"| node_agent_queue
node_contacts -->|"triggers agent"| node_agent_queue
node_companies -->|"queues work"| node_agent_queue
node_companies -->|"triggers agent"| node_agent_queue
node_deals -->|"triggers agent"| node_agent_queue
node_agent_dispatch -->|"leases due"| node_agent_tasks
node_agent_dispatch -->|"starts sessions"| node_agent_runtime
node_agent_runtime -->|"schedules follow-ups"| node_agent_tasks
node_agent_runner -->|"queries CRM"| node_agent_runtime
node_agent_runtime -.->|"runs research"| node_agent_tools
node_agent_runtime -->|"reads and writes"| node_database
node_agent_tasks -->|"leases tasks"| node_database
node_contacts -->|"reads and writes"| node_database
node_companies -->|"reads and writes"| node_database
node_deals -->|"reads and writes"| node_database
node_fields -.->|"reads and writes"| node_database
node_whatsapp -->|"files messages"| node_crm_activity
node_mail_sync -->|"syncs mail"| node_database
node_voice_runtime -->|"files call summary"| node_crm_activity
node_tracking_ingest -->|"stores events"| node_database
node_crm_activity -.->|"records activity"| node_database

click node_workspace_ui "https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/app/app/(app)/%5Bslug%5D/page.tsx"
click node_agent_builder_ui "https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/app/components/agent-builder/agent-builder-chat.tsx"
click node_api_entry "https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/create-app.ts"
click node_contacts "https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/contacts/contacts.service.ts"
click node_companies "https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/companies/companies.service.ts"
click node_deals "https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/deals/deals.service.ts"
click node_fields "https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/fields/fields.service.ts"
click node_tracking_ingest "https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/tracking/tracking-ingest.service.ts"
click node_agent_queue "https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/agent/agent-queue.service.ts"
click node_agent_dispatch "https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/agent/agent/schedules/dispatch.ts"
click node_agent_tasks "https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/agent/agent/lib/tasks.ts"
click node_agent_runtime "https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/agent/agent/lib/run-runtime.ts"
click node_agent_tools "https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/agent/agent/tools/research_company.ts"
click node_agent_runner "https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/agent/agent/subagents/agent_runner/agent.ts"
click node_whatsapp "https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/whatsapp/whatsapp-webhook.controller.ts"
click node_mail_sync "https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/sync/mailbox-sync.service.ts"
click node_voice_runtime "https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/voice-agent/main.py"
click node_database "https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/packages/db/src/client.ts"
click node_crm_activity "https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/crm/activity-stamp.service.ts"

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_workspace_ui,node_agent_builder_ui,node_user toneBlue
class node_api_entry,node_contacts,node_companies,node_deals,node_fields,node_tracking_ingest,node_agent_queue toneAmber
class node_agent_dispatch,node_agent_tasks,node_agent_runtime,node_agent_tools,node_agent_runner toneMint
class node_whatsapp,node_mail_sync,node_voice_runtime toneRose
class node_database,node_crm_activity toneIndigo
```

## Components

### CRM Workspace

- [CRM and agent UI](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/app/app/(app)/%5Bslug%5D/page.tsx): `apps/app/app/(app)/[slug]/page.tsx`
- [Agent builder](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/app/components/agent-builder/agent-builder-chat.tsx): `apps/app/components/agent-builder/agent-builder-chat.tsx`

### CRM API

- [API routes](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/create-app.ts): `apps/api/src/create-app.ts`
- [Contacts service](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/contacts/contacts.service.ts): `apps/api/src/contacts/contacts.service.ts`
- [Companies service](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/companies/companies.service.ts): `apps/api/src/companies/companies.service.ts`
- [Deals service](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/deals/deals.service.ts): `apps/api/src/deals/deals.service.ts`
- [Custom fields](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/fields/fields.service.ts): `apps/api/src/fields/fields.service.ts`
- [Visitor tracking](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/tracking/tracking-ingest.service.ts): `apps/api/src/tracking/tracking-ingest.service.ts`
- [Agent queue](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/agent/agent-queue.service.ts): `apps/api/src/agent/agent-queue.service.ts`

### Durable Agent

- [Task dispatch](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/agent/agent/schedules/dispatch.ts): `apps/agent/agent/schedules/dispatch.ts`
- [Task leasing](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/agent/agent/lib/tasks.ts): `apps/agent/agent/lib/tasks.ts`
- [Agent runtime](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/agent/agent/lib/run-runtime.ts): `apps/agent/agent/lib/run-runtime.ts`
- [Research and CRM tools](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/agent/agent/tools/research_company.ts): `apps/agent/agent/tools/research_company.ts`
- [Team agent runner](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/agent/agent/subagents/agent_runner/agent.ts): `apps/agent/agent/subagents/agent_runner/agent.ts`

### Connected Channels

- [WhatsApp filing](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/whatsapp/whatsapp-webhook.controller.ts): `apps/api/src/whatsapp/whatsapp-webhook.controller.ts`
- [Mailbox sync](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/sync/mailbox-sync.service.ts): `apps/api/src/sync/mailbox-sync.service.ts`
- [Voice runtime](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/voice-agent/main.py): `apps/voice-agent/main.py`

### Persistence

- [Postgres data](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/packages/db/src/client.ts): `packages/db/src/client.ts`
- [CRM activity stamps](https://github.com/jorgebendekj/trycrm/blob/claude/multitenancy-saas-crm-85d2lz/apps/api/src/crm/activity-stamp.service.ts): `apps/api/src/crm/activity-stamp.service.ts`

### Other components

- **CRM user**

## Connections

- CRM user → CRM and agent UI: uses (evidence: `README.md`)
- CRM and agent UI → API routes: requests CRM
- CRM user → Agent builder: describes agent (evidence: `README.md`)
- Agent builder → Agent runtime: bridges conversations
- Contacts service → Agent queue: queues work (evidence: `apps/api/src/contacts/contacts.service.ts`)
- Contacts service → Agent queue: triggers agent (evidence: `apps/api/src/contacts/contacts.service.ts`)
- Companies service → Agent queue: queues work (evidence: `apps/api/src/companies/companies.service.ts`)
- Companies service → Agent queue: triggers agent (evidence: `apps/api/src/companies/companies.service.ts`)
- Deals service → Agent queue: triggers agent (evidence: `apps/api/src/deals/deals.service.ts`)
- Task dispatch → Task leasing: leases due (evidence: `README.md`)
- Task dispatch → Agent runtime: starts sessions (evidence: `README.md`)
- Agent runtime → Task leasing: schedules follow-ups (evidence: `apps/agent/agent/lib/run-runtime.ts`)
- Team agent runner → Agent runtime: queries CRM
- Agent runtime → Research and CRM tools: runs research
- Agent runtime → Postgres data: reads and writes (evidence: `apps/agent/agent/lib/run-runtime.ts`)
- Task leasing → Postgres data: leases tasks (evidence: `apps/agent/agent/lib/tasks.ts`)
- Contacts service → Postgres data: reads and writes (evidence: `apps/api/src/contacts/contacts.service.ts`)
- Companies service → Postgres data: reads and writes (evidence: `apps/api/src/companies/companies.service.ts`)
- Deals service → Postgres data: reads and writes (evidence: `apps/api/src/deals/deals.service.ts`)
- Custom fields → Postgres data: reads and writes
- WhatsApp filing → CRM activity stamps: files messages (evidence: `apps/api/src/whatsapp/whatsapp-webhook.controller.ts`)
- Mailbox sync → Postgres data: syncs mail (evidence: `apps/api/src/sync/mailbox-sync.service.ts`)
- Voice runtime → CRM activity stamps: files call summary (evidence: `README.md`)
- Visitor tracking → Postgres data: stores events (evidence: `apps/api/src/tracking/tracking-ingest.service.ts`)
- CRM activity stamps → Postgres data: records activity
