# jitsucom/jitsu architecture

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

- Interactive diagram: https://gitdiagram.com/jitsucom/jitsu
- Repository: https://github.com/jitsucom/jitsu

## Overview

Jitsu is an event-data platform: client SDKs or HTTP send events to ingest, which routes them into event processing and delivery; destination adapters write to warehouses and SaaS tools. Separate reverse-sync services pull third-party data into warehouses. The README also describes functions, live-event visibility, and identity/profile capabilities. The graph follows documented service responsibilities and shown ingest and worker relationships; unsampled implementation details are omitted rather than inferred.

Main entry points: [`services/rotor/src/lib/workspace-worker.ts`](https://github.com/jitsucom/jitsu/blob/newjitsu/services/rotor/src/lib/workspace-worker.ts) (Event routing), [`bulker/bulkerapp/app/topic_manager.go`](https://github.com/jitsucom/jitsu/blob/newjitsu/bulker/bulkerapp/app/topic_manager.go) (Batch delivery), [`bulker/ingest/router_ingest_handler.go`](https://github.com/jitsucom/jitsu/blob/newjitsu/bulker/ingest/router_ingest_handler.go) (HTTP ingest), [`services/retl-runner/src/main.ts`](https://github.com/jitsucom/jitsu/blob/newjitsu/services/retl-runner/src/main.ts) (Reverse ETL runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Event collection"]
  node_ingest["HTTP ingest"]
end

subgraph group_processing["Event processing"]
  node_rotor["Event routing"]
  node_functions["Event functions<br/>[index.ts]"]
  node_identity[("Identity profiles<br/>[entity-store.ts]")]
end

subgraph group_delivery["Destination delivery"]
  node_bulker["Batch delivery<br/>[topic_manager.go]"]
  node_sql_adapters["Warehouse adapters<br/>[bigquery.go]"]
  node_file_adapters["File adapters"]
  node_api_adapters["SaaS adapters<br/>[webhook.go]"]
end

subgraph group_sync["Connector sync"]
  node_sync_controller["Sync orchestration"]
  node_sidecar["Sync sidecar<br/>[main.go]"]
  node_reverse_runner["Reverse ETL runner<br/>[main.ts]"]
  node_warehouse_query["Warehouse queries<br/>[bigquery.ts]"]
end

subgraph group_operations["Operations and visibility"]
  node_events_log[("Live event log<br/>[events_log.go]")]
  node_admin["Console and API<br/>[api.ts]"]
  node_mcp["MCP operations"]
end

node_senders(("SDKs and senders"))
node_warehouse[("Warehouses")]
node_saas["SaaS destinations"]
node_connector_sources["Connector sources"]

node_senders -->|"send events"| node_ingest
node_ingest -->|"routes events"| node_rotor
node_rotor -->|"runs functions"| node_functions
node_rotor -->|"routes events"| node_bulker
node_bulker -->|"dispatches batches"| node_sql_adapters
node_bulker -.->|"dispatches batches"| node_file_adapters
node_bulker -.->|"dispatches batches"| node_api_adapters
node_sql_adapters -->|"writes data"| node_warehouse
node_file_adapters -->|"writes data"| node_warehouse
node_api_adapters -->|"delivers events"| node_saas
node_rotor -.->|"builds profiles"| node_identity
node_connector_sources -->|"provides data"| node_sidecar
node_sync_controller -->|"starts sync jobs"| node_sidecar
node_sidecar -->|"loads data"| node_warehouse
node_warehouse -.->|"supplies source rows"| node_reverse_runner
node_reverse_runner -->|"queries source"| node_warehouse_query
node_reverse_runner -->|"syncs records"| node_saas
node_ingest -->|"records event activity"| node_events_log
node_admin -->|"exposes operations"| node_mcp

click node_ingest "https://github.com/jitsucom/jitsu/blob/newjitsu/bulker/ingest/router_ingest_handler.go"
click node_rotor "https://github.com/jitsucom/jitsu/blob/newjitsu/services/rotor/src/lib/workspace-worker.ts"
click node_functions "https://github.com/jitsucom/jitsu/blob/newjitsu/libs/core-functions-lib/src/index.ts"
click node_identity "https://github.com/jitsucom/jitsu/blob/newjitsu/libs/core-functions-lib/src/lib/entity-store.ts"
click node_bulker "https://github.com/jitsucom/jitsu/blob/newjitsu/bulker/bulkerapp/app/topic_manager.go"
click node_sql_adapters "https://github.com/jitsucom/jitsu/blob/newjitsu/bulker/bulkerlib/implementations/sql/bigquery.go"
click node_file_adapters "https://github.com/jitsucom/jitsu/blob/newjitsu/bulker/bulkerlib/implementations/google_cloud_storage.go"
click node_api_adapters "https://github.com/jitsucom/jitsu/blob/newjitsu/bulker/bulkerlib/implementations/api_based/webhook.go"
click node_sync_controller "https://github.com/jitsucom/jitsu/blob/newjitsu/bulker/sync-controller/cronjob_controller.go"
click node_sidecar "https://github.com/jitsucom/jitsu/blob/newjitsu/bulker/sync-sidecar/main.go"
click node_reverse_runner "https://github.com/jitsucom/jitsu/blob/newjitsu/services/retl-runner/src/main.ts"
click node_warehouse_query "https://github.com/jitsucom/jitsu/blob/newjitsu/libs/warehouse-query/src/bigquery.ts"
click node_events_log "https://github.com/jitsucom/jitsu/blob/newjitsu/bulker/eventslog/events_log.go"
click node_admin "https://github.com/jitsucom/jitsu/blob/newjitsu/webapps/console/lib/api.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_ingest toneBlue
class node_rotor,node_functions,node_identity,node_warehouse toneAmber
class node_bulker,node_sql_adapters,node_file_adapters,node_api_adapters toneMint
class node_sync_controller,node_sidecar,node_reverse_runner,node_warehouse_query toneRose
class node_events_log,node_admin,node_mcp,node_senders,node_saas,node_connector_sources toneIndigo
```

## Components

### Event collection

- [HTTP ingest](https://github.com/jitsucom/jitsu/blob/newjitsu/bulker/ingest/router_ingest_handler.go): `bulker/ingest/router_ingest_handler.go`

### Event processing

- [Event routing](https://github.com/jitsucom/jitsu/blob/newjitsu/services/rotor/src/lib/workspace-worker.ts): `services/rotor/src/lib/workspace-worker.ts`
- [Event functions](https://github.com/jitsucom/jitsu/blob/newjitsu/libs/core-functions-lib/src/index.ts): `libs/core-functions-lib/src/index.ts`
- [Identity profiles](https://github.com/jitsucom/jitsu/blob/newjitsu/libs/core-functions-lib/src/lib/entity-store.ts): `libs/core-functions-lib/src/lib/entity-store.ts`

### Destination delivery

- [Batch delivery](https://github.com/jitsucom/jitsu/blob/newjitsu/bulker/bulkerapp/app/topic_manager.go): `bulker/bulkerapp/app/topic_manager.go`
- [Warehouse adapters](https://github.com/jitsucom/jitsu/blob/newjitsu/bulker/bulkerlib/implementations/sql/bigquery.go): `bulker/bulkerlib/implementations/sql/bigquery.go`
- [File adapters](https://github.com/jitsucom/jitsu/blob/newjitsu/bulker/bulkerlib/implementations/google_cloud_storage.go): `bulker/bulkerlib/implementations/google_cloud_storage.go`
- [SaaS adapters](https://github.com/jitsucom/jitsu/blob/newjitsu/bulker/bulkerlib/implementations/api_based/webhook.go): `bulker/bulkerlib/implementations/api_based/webhook.go`

### Connector sync

- [Sync orchestration](https://github.com/jitsucom/jitsu/blob/newjitsu/bulker/sync-controller/cronjob_controller.go): `bulker/sync-controller/cronjob_controller.go`
- [Sync sidecar](https://github.com/jitsucom/jitsu/blob/newjitsu/bulker/sync-sidecar/main.go): `bulker/sync-sidecar/main.go`
- [Reverse ETL runner](https://github.com/jitsucom/jitsu/blob/newjitsu/services/retl-runner/src/main.ts): `services/retl-runner/src/main.ts`
- [Warehouse queries](https://github.com/jitsucom/jitsu/blob/newjitsu/libs/warehouse-query/src/bigquery.ts): `libs/warehouse-query/src/bigquery.ts`

### Operations and visibility

- [Live event log](https://github.com/jitsucom/jitsu/blob/newjitsu/bulker/eventslog/events_log.go): `bulker/eventslog/events_log.go`
- [Console and API](https://github.com/jitsucom/jitsu/blob/newjitsu/webapps/console/lib/api.ts): `webapps/console/lib/api.ts`
- **MCP operations**

### Other components

- **SDKs and senders**
- **Warehouses**
- **SaaS destinations**
- **Connector sources**

## Connections

- SDKs and senders → HTTP ingest: send events
- HTTP ingest → Event routing: routes events (evidence: `bulker/ingest/router_ingest_handler.go`)
- Event routing → Event functions: runs functions
- Event routing → Batch delivery: routes events
- Batch delivery → Warehouse adapters: dispatches batches (evidence: `bulker/bulkerapp/app/topic_manager.go`)
- Batch delivery → File adapters: dispatches batches
- Batch delivery → SaaS adapters: dispatches batches
- Warehouse adapters → Warehouses: writes data
- File adapters → Warehouses: writes data
- SaaS adapters → SaaS destinations: delivers events
- Event routing → Identity profiles: builds profiles
- Connector sources → Sync sidecar: provides data
- Sync orchestration → Sync sidecar: starts sync jobs (evidence: `bulker/sync-controller/cronjob_controller.go`)
- Sync sidecar → Warehouses: loads data
- Warehouses → Reverse ETL runner: supplies source rows
- Reverse ETL runner → Warehouse queries: queries source (evidence: `services/retl-runner/src/main.ts`)
- Reverse ETL runner → SaaS destinations: syncs records
- HTTP ingest → Live event log: records event activity (evidence: `bulker/ingest/router_ingest_handler.go`)
- Console and API → MCP operations: exposes operations
