# rustdzhur/synergia_crm_client architecture

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

## Overview

Firmspace is a Next.js business platform combining CRM, collaboration, finance, operations and integrations. The main workflow is an authenticated organization member using the CRM interface to manage records and business processes through API routes backed by shared domain services and persistence. Finance supports invoices, exports and stock; collaboration includes calendar, mail and messaging integrations. The graph emphasizes documented runtime paths and README capabilities; several UI-to-API links and unsampled subsystem internals are not evidenced in the excerpts, so they are not asserted.

Main entry points: [`lib/prisma.ts`](https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/prisma.ts) (Prisma database), [`app/api`](https://github.com/rustdzhur/synergia_crm_client/tree/main/app/api) (API routes), [`app/api/calendar/route.ts`](https://github.com/rustdzhur/synergia_crm_client/blob/main/app/api/calendar/route.ts) (Calendar API), [`lib/integrations.ts`](https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/integrations.ts) (Integration credentials)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Product entry"]
  node_crm_ui["CRM interface<br/>[index.tsx]"]
  node_api["API routes"]
end

subgraph group_crm["CRM workspace"]
  node_records["CRM records<br/>[route.ts]"]
  node_deals["Deals pipeline<br/>[index.tsx]"]
  node_tasks["Tasks and projects<br/>[index.tsx]"]
end

subgraph group_finance["Finance operations"]
  node_finance_ui["Finance workspace<br/>[index.tsx]"]
  node_invoices["Invoice API<br/>[route.ts]"]
  node_totals["Invoice calculations<br/>[totals.ts]"]
  node_exports["Data export<br/>[route.ts]"]
  node_stock["Stock API<br/>[route.ts]"]
  node_warehouse["Warehouse operations<br/>[warehouse.ts]"]
end

subgraph group_collab["Collaboration"]
  node_collab_ui["Collaboration workspace<br/>[Chat.tsx]"]
  node_channels["Messaging channels<br/>[index.ts]"]
  node_mail["Email service<br/>[index.ts]"]
  node_calendar_route["Calendar API<br/>[route.ts]"]
  node_calendar_sync["Calendar synchronization<br/>[sync.ts]"]
  node_google["Google services<br/>[index.ts]"]
end

subgraph group_core["Shared services"]
  node_auth["Authentication and access<br/>[auth.ts]"]
  node_database[("Prisma database<br/>[prisma.ts]")]
  node_integrations["Integration credentials<br/>[integrations.ts]"]
  node_oauth["Mail OAuth<br/>[oauth.ts]"]
  node_crypto["Secret encryption<br/>[crypto.ts]"]
  node_errorhub["Database error reporting<br/>[errorHub.ts]"]
end

node_member(("Organization member"))
node_external_providers(("External providers"))

node_member -.->|"uses"| node_crm_ui
node_crm_ui -.->|"requests"| node_api
node_api -->|"authenticates"| node_auth
node_api -->|"reads and writes"| node_database
node_api -.->|"routes records"| node_records
node_deals -.->|"uses API"| node_api
node_tasks -.->|"uses API"| node_api
node_collab_ui -.->|"uses API"| node_api
node_calendar_route -->|"authenticates"| node_auth
node_calendar_route -->|"finds calendars"| node_google
node_calendar_route -->|"starts sync"| node_calendar_sync
node_calendar_route -->|"checks OAuth"| node_oauth
node_calendar_route -->|"reads and writes"| node_database
node_finance_ui -.->|"uses API"| node_api
node_invoices -->|"authenticates"| node_auth
node_invoices -->|"cleans items"| node_totals
node_invoices -->|"reads and writes"| node_database
node_exports -->|"authenticates"| node_auth
node_exports -->|"computes totals"| node_totals
node_exports -->|"reads invoices"| node_database
node_stock -->|"authenticates"| node_auth
node_stock -->|"uses warehouse"| node_warehouse
node_stock -->|"reads and writes"| node_database
node_channels -->|"loads credentials"| node_integrations
node_channels -->|"stores messages"| node_database
node_mail -->|"refreshes tokens"| node_oauth
node_mail -->|"packs secrets"| node_integrations
node_mail -->|"syncs messages"| node_database
node_integrations -->|"encrypts secrets"| node_crypto
node_integrations -->|"stores integrations"| node_database
node_google -->|"refreshes tokens"| node_oauth
node_google -->|"packs secrets"| node_integrations
node_google -->|"stores connections"| node_database
node_database -->|"reports failures"| node_errorhub
node_external_providers -.->|"messaging"| node_channels
node_external_providers -.->|"email"| node_mail

click node_crm_ui "https://github.com/rustdzhur/synergia_crm_client/blob/main/components/crm/index.tsx"
click node_api "https://github.com/rustdzhur/synergia_crm_client/tree/main/app/api"
click node_auth "https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/auth.ts"
click node_records "https://github.com/rustdzhur/synergia_crm_client/blob/main/app/api/records/route.ts"
click node_deals "https://github.com/rustdzhur/synergia_crm_client/blob/main/components/crm/CRM/DealsBoard/index.tsx"
click node_tasks "https://github.com/rustdzhur/synergia_crm_client/blob/main/components/crm/Tasks/index.tsx"
click node_collab_ui "https://github.com/rustdzhur/synergia_crm_client/blob/main/components/crm/Collaboration/Chat.tsx"
click node_channels "https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/channels/index.ts"
click node_mail "https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/mail/index.ts"
click node_calendar_route "https://github.com/rustdzhur/synergia_crm_client/blob/main/app/api/calendar/route.ts"
click node_calendar_sync "https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/calendar/sync.ts"
click node_google "https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/google/index.ts"
click node_finance_ui "https://github.com/rustdzhur/synergia_crm_client/blob/main/components/crm/Finance/index.tsx"
click node_invoices "https://github.com/rustdzhur/synergia_crm_client/blob/main/app/api/invoices/route.ts"
click node_totals "https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/finance/totals.ts"
click node_exports "https://github.com/rustdzhur/synergia_crm_client/blob/main/app/api/export/route.ts"
click node_stock "https://github.com/rustdzhur/synergia_crm_client/blob/main/app/api/stock/route.ts"
click node_warehouse "https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/finance/warehouse.ts"
click node_database "https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/prisma.ts"
click node_integrations "https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/integrations.ts"
click node_oauth "https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/mail/oauth.ts"
click node_crypto "https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/crypto.ts"
click node_errorhub "https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/errorHub.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_crm_ui,node_api toneBlue
class node_records,node_deals,node_tasks toneAmber
class node_finance_ui,node_invoices,node_totals,node_exports,node_stock,node_warehouse toneMint
class node_collab_ui,node_channels,node_mail,node_calendar_route,node_calendar_sync,node_google toneRose
class node_auth,node_database,node_integrations,node_oauth,node_crypto,node_errorhub,node_member,node_external_providers toneIndigo
```

## Components

### Product entry

- [CRM interface](https://github.com/rustdzhur/synergia_crm_client/blob/main/components/crm/index.tsx): `components/crm/index.tsx`
- [API routes](https://github.com/rustdzhur/synergia_crm_client/tree/main/app/api): `app/api`

### CRM workspace

- [CRM records](https://github.com/rustdzhur/synergia_crm_client/blob/main/app/api/records/route.ts): `app/api/records/route.ts`
- [Deals pipeline](https://github.com/rustdzhur/synergia_crm_client/blob/main/components/crm/CRM/DealsBoard/index.tsx): `components/crm/CRM/DealsBoard/index.tsx`
- [Tasks and projects](https://github.com/rustdzhur/synergia_crm_client/blob/main/components/crm/Tasks/index.tsx): `components/crm/Tasks/index.tsx`

### Finance operations

- [Finance workspace](https://github.com/rustdzhur/synergia_crm_client/blob/main/components/crm/Finance/index.tsx): `components/crm/Finance/index.tsx`
- [Invoice API](https://github.com/rustdzhur/synergia_crm_client/blob/main/app/api/invoices/route.ts): `app/api/invoices/route.ts`
- [Invoice calculations](https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/finance/totals.ts): `lib/finance/totals.ts`
- [Data export](https://github.com/rustdzhur/synergia_crm_client/blob/main/app/api/export/route.ts): `app/api/export/route.ts`
- [Stock API](https://github.com/rustdzhur/synergia_crm_client/blob/main/app/api/stock/route.ts): `app/api/stock/route.ts`
- [Warehouse operations](https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/finance/warehouse.ts): `lib/finance/warehouse.ts`

### Collaboration

- [Collaboration workspace](https://github.com/rustdzhur/synergia_crm_client/blob/main/components/crm/Collaboration/Chat.tsx): `components/crm/Collaboration/Chat.tsx`
- [Messaging channels](https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/channels/index.ts): `lib/channels/index.ts`
- [Email service](https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/mail/index.ts): `lib/mail/index.ts`
- [Calendar API](https://github.com/rustdzhur/synergia_crm_client/blob/main/app/api/calendar/route.ts): `app/api/calendar/route.ts`
- [Calendar synchronization](https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/calendar/sync.ts): `lib/calendar/sync.ts`
- [Google services](https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/google/index.ts): `lib/google/index.ts`

### Shared services

- [Authentication and access](https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/auth.ts): `lib/auth.ts`
- [Prisma database](https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/prisma.ts): `lib/prisma.ts`
- [Integration credentials](https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/integrations.ts): `lib/integrations.ts`
- [Mail OAuth](https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/mail/oauth.ts): `lib/mail/oauth.ts`
- [Secret encryption](https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/crypto.ts): `lib/crypto.ts`
- [Database error reporting](https://github.com/rustdzhur/synergia_crm_client/blob/main/lib/errorHub.ts): `lib/errorHub.ts`

### Other components

- **Organization member**
- **External providers**

## Connections

- Organization member → CRM interface: uses
- CRM interface → API routes: requests
- API routes → Authentication and access: authenticates (evidence: `app/api/invoices/route.ts`)
- API routes → Prisma database: reads and writes (evidence: `app/api/invoices/route.ts`)
- API routes → CRM records: routes records
- Deals pipeline → API routes: uses API
- Tasks and projects → API routes: uses API
- Collaboration workspace → API routes: uses API
- Calendar API → Authentication and access: authenticates (evidence: `app/api/calendar/route.ts`)
- Calendar API → Google services: finds calendars (evidence: `app/api/calendar/route.ts`)
- Calendar API → Calendar synchronization: starts sync (evidence: `app/api/calendar/route.ts`)
- Calendar API → Mail OAuth: checks OAuth (evidence: `app/api/calendar/route.ts`)
- Calendar API → Prisma database: reads and writes (evidence: `app/api/calendar/route.ts`)
- Finance workspace → API routes: uses API
- Invoice API → Authentication and access: authenticates (evidence: `app/api/invoices/route.ts`)
- Invoice API → Invoice calculations: cleans items (evidence: `app/api/invoices/route.ts`)
- Invoice API → Prisma database: reads and writes (evidence: `app/api/invoices/route.ts`)
- Data export → Authentication and access: authenticates (evidence: `app/api/export/route.ts`)
- Data export → Invoice calculations: computes totals (evidence: `app/api/export/route.ts`)
- Data export → Prisma database: reads invoices (evidence: `app/api/export/route.ts`)
- Stock API → Authentication and access: authenticates (evidence: `app/api/stock/route.ts`)
- Stock API → Warehouse operations: uses warehouse (evidence: `app/api/stock/route.ts`)
- Stock API → Prisma database: reads and writes (evidence: `app/api/stock/route.ts`)
- Messaging channels → Integration credentials: loads credentials (evidence: `lib/channels/index.ts`)
- Messaging channels → Prisma database: stores messages (evidence: `lib/channels/index.ts`)
- Email service → Mail OAuth: refreshes tokens (evidence: `lib/mail/index.ts`)
- Email service → Integration credentials: packs secrets (evidence: `lib/mail/index.ts`)
- Email service → Prisma database: syncs messages (evidence: `lib/mail/index.ts`)
- Integration credentials → Secret encryption: encrypts secrets (evidence: `lib/integrations.ts`)
- Integration credentials → Prisma database: stores integrations (evidence: `lib/integrations.ts`)
- Google services → Mail OAuth: refreshes tokens (evidence: `lib/google/index.ts`)
- Google services → Integration credentials: packs secrets (evidence: `lib/google/index.ts`)
- Google services → Prisma database: stores connections (evidence: `lib/google/index.ts`)
- Prisma database → Database error reporting: reports failures (evidence: `lib/prisma.ts`)
- External providers → Messaging channels: messaging
- External providers → Email service: email
