# rcarubbi/pipelinebuilder architecture

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

- Interactive diagram: https://gitdiagram.com/rcarubbi/pipelinebuilder
- Repository: https://github.com/rcarubbi/pipelinebuilder
- Video tour (about a minute): https://gitdiagram.com/rcarubbi/pipelinebuilder/video

## Overview

Pipeline Builder is a browser-based Blockly designer backed by a .NET API. Users compose and validate a linear pipeline, save or import its JSON definition, then run a saved revision or attach it to a schedule; runs execute immutable snapshots and expose history and results. The graph includes design, API/application, execution and scheduling stages, plus persistence and file I/O. Several backend orchestration and repository calls were not sampled, so those links are omitted or marked unverified rather than inferred.

Main entry points: [`frontend/src/pipeline/api.ts`](https://github.com/rcarubbi/pipelinebuilder/blob/main/frontend/src/pipeline/api.ts) (API client), [`frontend/src/Router.tsx`](https://github.com/rcarubbi/pipelinebuilder/blob/main/frontend/src/Router.tsx) (Page router), [`frontend/src/App.tsx`](https://github.com/rcarubbi/pipelinebuilder/blob/main/frontend/src/App.tsx) (Blockly designer), [`backend/src/PipelineBuilder.Application/UseCases/Runs`](https://github.com/rcarubbi/pipelinebuilder/tree/main/backend/src/PipelineBuilder.Application/UseCases/Runs) (Run orchestration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_design["Pipeline design"]
  node_router["Page router<br/>[Router.tsx]"]
  node_pipeline_pages["Pipeline list<br/>[PipelinesPage.tsx]"]
  node_designer["Blockly designer<br/>[App.tsx]"]
  node_workspace["Workspace compiler<br/>[workspace.ts]"]
  node_exchange["JSON exchange<br/>[exchange.ts]"]
  node_api_client["API client<br/>[api.ts]"]
  node_logs_page["Execution logs"]
  node_schedules_page["Schedule editor<br/>[SchedulesPage.tsx]"]
end

subgraph group_api["API and application"]
  node_pipeline_api["Pipeline endpoints"]
  node_runs_api["Run endpoints<br/>[RunsController.cs]"]
  node_schedules_api["Schedule endpoints"]
  node_schema_api["Schema discovery"]
  node_pipeline_usecases["Pipeline use cases<br/>[Pipelines]"]
  node_validation["Definition validation"]
end

subgraph group_execution["Execution and files"]
  node_run_usecases["Run orchestration<br/>[Runs]"]
  node_worker["Execution worker"]
  node_pipeline_files["Pipeline processing<br/>[PipelineFiles.cs]"]
  node_input_reader["Input reader"]
  node_api_reader["API input<br/>[ApiInputReader.cs]"]
  node_postgres_reader["Postgres input"]
end

subgraph group_schedule["Schedules and storage"]
  node_scheduling["Schedule orchestration<br/>[Schedules]"]
  node_trigger_job["Schedule trigger job"]
  node_persistence[("Persistence<br/>[Persistence]")]
end

node_user(("User"))
node_browser(("Browser user"))

node_user -->|"uses"| node_router
node_router -->|"routes to"| node_pipeline_pages
node_router -->|"opens"| node_designer
node_router -->|"routes to"| node_logs_page
node_router -->|"routes to"| node_schedules_page
node_pipeline_pages -->|"requests"| node_api_client
node_designer -->|"compiles workspace"| node_workspace
node_designer -->|"saves and runs"| node_api_client
node_designer -->|"imports and exports"| node_exchange
node_api_client -->|"calls API"| node_pipeline_api
node_api_client -->|"calls API"| node_runs_api
node_api_client -->|"calls API"| node_schedules_api
node_api_client -->|"calls API"| node_schema_api
node_pipeline_api -->|"dispatches to"| node_pipeline_usecases
node_pipeline_api -->|"validates through"| node_validation
node_pipeline_usecases -.->|"stores definitions"| node_persistence
node_runs_api -.->|"dispatches to"| node_run_usecases
node_run_usecases -.->|"queues execution"| node_worker
node_worker -.->|"executes snapshot"| node_pipeline_files
node_pipeline_files -->|"reads input"| node_input_reader
node_input_reader -->|"reads API data"| node_api_reader
node_input_reader -->|"reads PostgreSQL"| node_postgres_reader
node_pipeline_files -->|"writes outputs"| node_user
node_schedules_api -.->|"dispatches to"| node_scheduling
node_scheduling -.->|"registers triggers"| node_trigger_job
node_trigger_job -.->|"queues scheduled runs"| node_run_usecases
node_scheduling -.->|"stores schedules"| node_persistence
node_run_usecases -.->|"records run history"| node_persistence

click node_router "https://github.com/rcarubbi/pipelinebuilder/blob/main/frontend/src/Router.tsx"
click node_pipeline_pages "https://github.com/rcarubbi/pipelinebuilder/blob/main/frontend/src/pages/PipelinesPage.tsx"
click node_designer "https://github.com/rcarubbi/pipelinebuilder/blob/main/frontend/src/App.tsx"
click node_workspace "https://github.com/rcarubbi/pipelinebuilder/blob/main/frontend/src/blockly/workspace.ts"
click node_exchange "https://github.com/rcarubbi/pipelinebuilder/blob/main/frontend/src/pipeline/exchange.ts"
click node_api_client "https://github.com/rcarubbi/pipelinebuilder/blob/main/frontend/src/pipeline/api.ts"
click node_logs_page "https://github.com/rcarubbi/pipelinebuilder/blob/main/frontend/src/pages/ExecutionLogsPage.tsx"
click node_schedules_page "https://github.com/rcarubbi/pipelinebuilder/blob/main/frontend/src/pages/SchedulesPage.tsx"
click node_pipeline_api "https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Presentation/Controllers/PipelinesController.cs"
click node_runs_api "https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Presentation/Controllers/RunsController.cs"
click node_schedules_api "https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Presentation/Controllers/SchedulesController.cs"
click node_schema_api "https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Presentation/Controllers/SchemasController.cs"
click node_pipeline_usecases "https://github.com/rcarubbi/pipelinebuilder/tree/main/backend/src/PipelineBuilder.Application/UseCases/Pipelines"
click node_validation "https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Domain/Pipelines/PipelineDefinition.cs"
click node_run_usecases "https://github.com/rcarubbi/pipelinebuilder/tree/main/backend/src/PipelineBuilder.Application/UseCases/Runs"
click node_worker "https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Infrastructure/JobHandlers/ExecutePipelineJob.cs"
click node_pipeline_files "https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Infrastructure/Files/PipelineFiles.cs"
click node_input_reader "https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Infrastructure/Files/PipelineInputReader.cs"
click node_api_reader "https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Infrastructure/Files/ApiInputReader.cs"
click node_postgres_reader "https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Infrastructure/Files/PostgresInputReader.cs"
click node_scheduling "https://github.com/rcarubbi/pipelinebuilder/tree/main/backend/src/PipelineBuilder.Application/UseCases/Schedules"
click node_trigger_job "https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Infrastructure/JobHandlers/TriggerScheduleJob.cs"
click node_persistence "https://github.com/rcarubbi/pipelinebuilder/tree/main/backend/src/PipelineBuilder.Infrastructure/Persistence"

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_router,node_pipeline_pages,node_designer,node_workspace,node_exchange,node_api_client,node_logs_page,node_schedules_page,node_user,node_browser toneBlue
class node_pipeline_api,node_runs_api,node_schedules_api,node_schema_api,node_pipeline_usecases,node_validation toneAmber
class node_run_usecases,node_worker,node_pipeline_files,node_input_reader,node_api_reader,node_postgres_reader toneMint
class node_scheduling,node_trigger_job,node_persistence toneRose
```

## Components

### Pipeline design

- [Page router](https://github.com/rcarubbi/pipelinebuilder/blob/main/frontend/src/Router.tsx): `frontend/src/Router.tsx`
- [Pipeline list](https://github.com/rcarubbi/pipelinebuilder/blob/main/frontend/src/pages/PipelinesPage.tsx): `frontend/src/pages/PipelinesPage.tsx`
- [Blockly designer](https://github.com/rcarubbi/pipelinebuilder/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Workspace compiler](https://github.com/rcarubbi/pipelinebuilder/blob/main/frontend/src/blockly/workspace.ts): `frontend/src/blockly/workspace.ts`
- [JSON exchange](https://github.com/rcarubbi/pipelinebuilder/blob/main/frontend/src/pipeline/exchange.ts): `frontend/src/pipeline/exchange.ts`
- [API client](https://github.com/rcarubbi/pipelinebuilder/blob/main/frontend/src/pipeline/api.ts): `frontend/src/pipeline/api.ts`
- [Execution logs](https://github.com/rcarubbi/pipelinebuilder/blob/main/frontend/src/pages/ExecutionLogsPage.tsx): `frontend/src/pages/ExecutionLogsPage.tsx`
- [Schedule editor](https://github.com/rcarubbi/pipelinebuilder/blob/main/frontend/src/pages/SchedulesPage.tsx): `frontend/src/pages/SchedulesPage.tsx`

### API and application

- [Pipeline endpoints](https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Presentation/Controllers/PipelinesController.cs): `backend/src/PipelineBuilder.Presentation/Controllers/PipelinesController.cs`
- [Run endpoints](https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Presentation/Controllers/RunsController.cs): `backend/src/PipelineBuilder.Presentation/Controllers/RunsController.cs`
- [Schedule endpoints](https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Presentation/Controllers/SchedulesController.cs): `backend/src/PipelineBuilder.Presentation/Controllers/SchedulesController.cs`
- [Schema discovery](https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Presentation/Controllers/SchemasController.cs): `backend/src/PipelineBuilder.Presentation/Controllers/SchemasController.cs`
- [Pipeline use cases](https://github.com/rcarubbi/pipelinebuilder/tree/main/backend/src/PipelineBuilder.Application/UseCases/Pipelines): `backend/src/PipelineBuilder.Application/UseCases/Pipelines`
- [Definition validation](https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Domain/Pipelines/PipelineDefinition.cs): `backend/src/PipelineBuilder.Domain/Pipelines/PipelineDefinition.cs`

### Execution and files

- [Run orchestration](https://github.com/rcarubbi/pipelinebuilder/tree/main/backend/src/PipelineBuilder.Application/UseCases/Runs): `backend/src/PipelineBuilder.Application/UseCases/Runs`
- [Execution worker](https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Infrastructure/JobHandlers/ExecutePipelineJob.cs): `backend/src/PipelineBuilder.Infrastructure/JobHandlers/ExecutePipelineJob.cs`
- [Pipeline processing](https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Infrastructure/Files/PipelineFiles.cs): `backend/src/PipelineBuilder.Infrastructure/Files/PipelineFiles.cs`
- [Input reader](https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Infrastructure/Files/PipelineInputReader.cs): `backend/src/PipelineBuilder.Infrastructure/Files/PipelineInputReader.cs`
- [API input](https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Infrastructure/Files/ApiInputReader.cs): `backend/src/PipelineBuilder.Infrastructure/Files/ApiInputReader.cs`
- [Postgres input](https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Infrastructure/Files/PostgresInputReader.cs): `backend/src/PipelineBuilder.Infrastructure/Files/PostgresInputReader.cs`

### Schedules and storage

- [Schedule orchestration](https://github.com/rcarubbi/pipelinebuilder/tree/main/backend/src/PipelineBuilder.Application/UseCases/Schedules): `backend/src/PipelineBuilder.Application/UseCases/Schedules`
- [Schedule trigger job](https://github.com/rcarubbi/pipelinebuilder/blob/main/backend/src/PipelineBuilder.Infrastructure/JobHandlers/TriggerScheduleJob.cs): `backend/src/PipelineBuilder.Infrastructure/JobHandlers/TriggerScheduleJob.cs`
- [Persistence](https://github.com/rcarubbi/pipelinebuilder/tree/main/backend/src/PipelineBuilder.Infrastructure/Persistence): `backend/src/PipelineBuilder.Infrastructure/Persistence`

### Other components

- **User**
- **Browser user**

## Connections

- User → Page router: uses (evidence: `README.md`)
- Page router → Pipeline list: routes to (evidence: `frontend/src/Router.tsx`)
- Page router → Blockly designer: opens (evidence: `frontend/src/Router.tsx`)
- Page router → Execution logs: routes to (evidence: `frontend/src/Router.tsx`)
- Page router → Schedule editor: routes to (evidence: `frontend/src/Router.tsx`)
- Pipeline list → API client: requests (evidence: `frontend/src/pages/PipelinesPage.tsx`)
- Blockly designer → Workspace compiler: compiles workspace (evidence: `frontend/src/App.tsx`)
- Blockly designer → API client: saves and runs (evidence: `frontend/src/App.tsx`)
- Blockly designer → JSON exchange: imports and exports (evidence: `frontend/src/App.tsx`)
- API client → Pipeline endpoints: calls API (evidence: `README.md`)
- API client → Run endpoints: calls API (evidence: `README.md`)
- API client → Schedule endpoints: calls API (evidence: `README.md`)
- API client → Schema discovery: calls API (evidence: `README.md`)
- Pipeline endpoints → Pipeline use cases: dispatches to (evidence: `backend/src/PipelineBuilder.Presentation/Controllers/PipelinesController.cs`)
- Pipeline endpoints → Definition validation: validates through
- Pipeline use cases → Persistence: stores definitions
- Run endpoints → Run orchestration: dispatches to
- Run orchestration → Execution worker: queues execution
- Execution worker → Pipeline processing: executes snapshot
- Pipeline processing → Input reader: reads input (evidence: `backend/src/PipelineBuilder.Infrastructure/Files/PipelineFiles.cs`)
- Input reader → API input: reads API data (evidence: `backend/src/PipelineBuilder.Infrastructure/Files/PipelineInputReader.cs`)
- Input reader → Postgres input: reads PostgreSQL (evidence: `backend/src/PipelineBuilder.Infrastructure/Files/PipelineInputReader.cs`)
- Pipeline processing → User: writes outputs (evidence: `README.md`)
- Schedule endpoints → Schedule orchestration: dispatches to
- Schedule orchestration → Schedule trigger job: registers triggers
- Schedule trigger job → Run orchestration: queues scheduled runs
- Schedule orchestration → Persistence: stores schedules
- Run orchestration → Persistence: records run history
