# august0362/it-studio architecture

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

- Interactive diagram: https://gitdiagram.com/august0362/it-studio
- Repository: https://github.com/august0362/it-studio

## Overview

This is a desktop AI development studio: users manage projects, chat with models, run a staged code-generation/review pipeline, ingest project knowledge, and inspect costs and settings. The main interaction path is the React desktop UI through typed RPC and the Tauri sidecar to backend services. The tree documents additional product areas, but excerpts do not expose all their runtime wiring; those connections are omitted or marked unverified rather than inferred.

Main entry points: [`apps/sidecar/src/services/rag/rag-service.ts`](https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/services/rag/rag-service.ts) (Knowledge ingestion), [`apps/sidecar/src/services/pipeline-orchestrator.ts`](https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/services/pipeline-orchestrator.ts) (Code pipeline), [`apps/sidecar/src/rpc/rpc-server.ts`](https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/rpc/rpc-server.ts) (RPC server), [`apps/desktop/src/App.tsx`](https://github.com/august0362/it-studio/blob/main/apps/desktop/src/App.tsx) (Application shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop app"]
  node_app["Application shell<br/>[App.tsx]"]
  node_product_views["Product views"]
  node_settings_views["Settings views"]
  node_ui_rpc["RPC query hooks<br/>[use-rpc-query.ts]"]
end

subgraph group_bridge["RPC runtime"]
  node_rpc_client["RPC client<br/>[rpc-client.ts]"]
  node_transport["Tauri transport<br/>[transport.ts]"]
  node_tauri["Tauri host<br/>[commands.rs]"]
  node_sidecar["Sidecar process<br/>[main.ts]"]
  node_rpc_server["RPC server<br/>[rpc-server.ts]"]
  node_container["Service container<br/>[container.ts]"]
end

subgraph group_ai["AI services"]
  node_chat["Chat and web chat<br/>[chat-service.ts]"]
  node_llm_router["Model routing<br/>[llm-router.ts]"]
  node_providers["Model providers"]
end

subgraph group_projects["Project workflows"]
  node_pipeline["Code pipeline"]
  node_pipeline_states["Pipeline state machine"]
  node_rag["Knowledge ingestion<br/>[rag-service.ts]"]
  node_workflow["Workflow editor<br/>[WorkflowPage.tsx]"]
  node_cost_services["Cost and budgets<br/>[ledger-service.ts]"]
end

subgraph group_data["Persistence and providers"]
  node_sqlite[("SQLite repositories")]
  node_event_bus["Event bus<br/>[event-bus.ts]"]
  node_file_system["Workspace access<br/>[file-system.ts]"]
  node_vector_store[("Vector store<br/>[vector-store.ts]")]
  node_embeddings["Embedding providers"]
end

node_user(("Studio user"))
node_external_models{{"Model APIs"}}

node_user -->|"uses"| node_app
node_app -.->|"presents"| node_product_views
node_app -.->|"presents"| node_settings_views
node_app -->|"loads settings"| node_ui_rpc
node_ui_rpc -->|"calls"| node_rpc_client
node_rpc_client -->|"sends requests"| node_transport
node_transport -.->|"crosses IPC"| node_tauri
node_tauri -.->|"launches"| node_sidecar
node_sidecar -->|"creates"| node_container
node_container -.->|"configures"| node_rpc_server
node_rpc_server -.->|"dispatches"| node_chat
node_rpc_server -.->|"dispatches"| node_pipeline
node_rpc_server -.->|"dispatches"| node_rag
node_rpc_server -.->|"dispatches"| node_cost_services
node_llm_router -->|"selects provider"| node_providers
node_llm_router -->|"publishes events"| node_event_bus
node_external_models -.->|"serves completions"| node_providers
node_pipeline -->|"transitions stages"| node_pipeline_states
node_pipeline -->|"persists runs"| node_sqlite
node_pipeline -->|"accesses workspace"| node_file_system
node_pipeline -->|"publishes events"| node_event_bus
node_rag -->|"discovers files"| node_file_system
node_rag -->|"stores vectors"| node_vector_store
node_rag -->|"creates embeddings"| node_embeddings
node_rag -->|"stores documents"| node_sqlite
node_rag -->|"publishes progress"| node_event_bus
node_chat -.->|"requests completions"| node_llm_router
node_cost_services -.->|"stores ledger"| node_sqlite
node_workflow -.->|"starts runs"| node_pipeline
node_product_views -.->|"uses chat services"| node_chat
node_product_views -.->|"uses knowledge services"| node_rag
node_settings_views -->|"loads and saves"| node_rpc_client

click node_app "https://github.com/august0362/it-studio/blob/main/apps/desktop/src/App.tsx"
click node_product_views "https://github.com/august0362/it-studio/tree/main/apps/desktop/src/features"
click node_settings_views "https://github.com/august0362/it-studio/tree/main/apps/desktop/src/features/settings"
click node_ui_rpc "https://github.com/august0362/it-studio/blob/main/apps/desktop/src/hooks/use-rpc-query.ts"
click node_rpc_client "https://github.com/august0362/it-studio/blob/main/apps/desktop/src/rpc/rpc-client.ts"
click node_transport "https://github.com/august0362/it-studio/blob/main/apps/desktop/src/rpc/transport.ts"
click node_tauri "https://github.com/august0362/it-studio/blob/main/apps/desktop/src-tauri/src/commands.rs"
click node_sidecar "https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/main.ts"
click node_rpc_server "https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/rpc/rpc-server.ts"
click node_container "https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/container.ts"
click node_chat "https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/services/chat-service.ts"
click node_llm_router "https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/services/llm-router.ts"
click node_providers "https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/providers/provider-registry.ts"
click node_pipeline "https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/services/pipeline-orchestrator.ts"
click node_pipeline_states "https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/domain/pipeline-machine.ts"
click node_rag "https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/services/rag/rag-service.ts"
click node_workflow "https://github.com/august0362/it-studio/blob/main/apps/desktop/src/features/workflow/WorkflowPage.tsx"
click node_cost_services "https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/services/ledger-service.ts"
click node_sqlite "https://github.com/august0362/it-studio/tree/main/apps/sidecar/src/infra/sqlite"
click node_event_bus "https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/rpc/event-bus.ts"
click node_file_system "https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/ports/file-system.ts"
click node_vector_store "https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/ports/vector-store.ts"
click node_embeddings "https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/services/embedding-dispatcher.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_app,node_product_views,node_settings_views,node_ui_rpc,node_user toneBlue
class node_rpc_client,node_transport,node_tauri,node_sidecar,node_rpc_server,node_container toneAmber
class node_chat,node_llm_router,node_providers,node_external_models toneMint
class node_pipeline,node_pipeline_states,node_rag,node_workflow,node_cost_services toneRose
class node_sqlite,node_event_bus,node_file_system,node_vector_store,node_embeddings toneIndigo
```

## Components

### Desktop app

- [Application shell](https://github.com/august0362/it-studio/blob/main/apps/desktop/src/App.tsx): `apps/desktop/src/App.tsx`
- [Product views](https://github.com/august0362/it-studio/tree/main/apps/desktop/src/features): `apps/desktop/src/features`
- [Settings views](https://github.com/august0362/it-studio/tree/main/apps/desktop/src/features/settings): `apps/desktop/src/features/settings`
- [RPC query hooks](https://github.com/august0362/it-studio/blob/main/apps/desktop/src/hooks/use-rpc-query.ts): `apps/desktop/src/hooks/use-rpc-query.ts`

### RPC runtime

- [RPC client](https://github.com/august0362/it-studio/blob/main/apps/desktop/src/rpc/rpc-client.ts): `apps/desktop/src/rpc/rpc-client.ts`
- [Tauri transport](https://github.com/august0362/it-studio/blob/main/apps/desktop/src/rpc/transport.ts): `apps/desktop/src/rpc/transport.ts`
- [Tauri host](https://github.com/august0362/it-studio/blob/main/apps/desktop/src-tauri/src/commands.rs): `apps/desktop/src-tauri/src/commands.rs`
- [Sidecar process](https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/main.ts): `apps/sidecar/src/main.ts`
- [RPC server](https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/rpc/rpc-server.ts): `apps/sidecar/src/rpc/rpc-server.ts`
- [Service container](https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/container.ts): `apps/sidecar/src/container.ts`

### AI services

- [Chat and web chat](https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/services/chat-service.ts): `apps/sidecar/src/services/chat-service.ts`
- [Model routing](https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/services/llm-router.ts): `apps/sidecar/src/services/llm-router.ts`
- [Model providers](https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/providers/provider-registry.ts): `apps/sidecar/src/providers/provider-registry.ts`

### Project workflows

- [Code pipeline](https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/services/pipeline-orchestrator.ts): `apps/sidecar/src/services/pipeline-orchestrator.ts`
- [Pipeline state machine](https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/domain/pipeline-machine.ts): `apps/sidecar/src/domain/pipeline-machine.ts`
- [Knowledge ingestion](https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/services/rag/rag-service.ts): `apps/sidecar/src/services/rag/rag-service.ts`
- [Workflow editor](https://github.com/august0362/it-studio/blob/main/apps/desktop/src/features/workflow/WorkflowPage.tsx): `apps/desktop/src/features/workflow/WorkflowPage.tsx`
- [Cost and budgets](https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/services/ledger-service.ts): `apps/sidecar/src/services/ledger-service.ts`

### Persistence and providers

- [SQLite repositories](https://github.com/august0362/it-studio/tree/main/apps/sidecar/src/infra/sqlite): `apps/sidecar/src/infra/sqlite`
- [Event bus](https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/rpc/event-bus.ts): `apps/sidecar/src/rpc/event-bus.ts`
- [Workspace access](https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/ports/file-system.ts): `apps/sidecar/src/ports/file-system.ts`
- [Vector store](https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/ports/vector-store.ts): `apps/sidecar/src/ports/vector-store.ts`
- [Embedding providers](https://github.com/august0362/it-studio/blob/main/apps/sidecar/src/services/embedding-dispatcher.ts): `apps/sidecar/src/services/embedding-dispatcher.ts`

### Other components

- **Studio user**
- **Model APIs**

## Connections

- Studio user → Application shell: uses
- Application shell → Product views: presents
- Application shell → Settings views: presents
- Application shell → RPC query hooks: loads settings (evidence: `apps/desktop/src/App.tsx`)
- RPC query hooks → RPC client: calls (evidence: `apps/desktop/src/hooks/use-rpc-query.ts`)
- RPC client → Tauri transport: sends requests (evidence: `apps/desktop/src/rpc/rpc-client.ts`)
- Tauri transport → Tauri host: crosses IPC
- Tauri host → Sidecar process: launches
- Sidecar process → Service container: creates (evidence: `apps/sidecar/src/main.ts`)
- Service container → RPC server: configures
- RPC server → Chat and web chat: dispatches
- RPC server → Code pipeline: dispatches
- RPC server → Knowledge ingestion: dispatches
- RPC server → Cost and budgets: dispatches
- Model routing → Model providers: selects provider (evidence: `apps/sidecar/src/services/llm-router.ts`)
- Model routing → Event bus: publishes events (evidence: `apps/sidecar/src/services/llm-router.ts`)
- Model APIs → Model providers: serves completions
- Code pipeline → Pipeline state machine: transitions stages (evidence: `apps/sidecar/src/services/pipeline-orchestrator.ts`)
- Code pipeline → SQLite repositories: persists runs (evidence: `apps/sidecar/src/services/pipeline-orchestrator.ts`)
- Code pipeline → Workspace access: accesses workspace (evidence: `apps/sidecar/src/services/pipeline-orchestrator.ts`)
- Code pipeline → Event bus: publishes events (evidence: `apps/sidecar/src/services/pipeline-orchestrator.ts`)
- Knowledge ingestion → Workspace access: discovers files (evidence: `apps/sidecar/src/services/rag/rag-service.ts`)
- Knowledge ingestion → Vector store: stores vectors (evidence: `apps/sidecar/src/services/rag/rag-service.ts`)
- Knowledge ingestion → Embedding providers: creates embeddings (evidence: `apps/sidecar/src/services/rag/rag-service.ts`)
- Knowledge ingestion → SQLite repositories: stores documents (evidence: `apps/sidecar/src/services/rag/rag-service.ts`)
- Knowledge ingestion → Event bus: publishes progress (evidence: `apps/sidecar/src/services/rag/rag-service.ts`)
- Chat and web chat → Model routing: requests completions
- Cost and budgets → SQLite repositories: stores ledger
- Workflow editor → Code pipeline: starts runs
- Product views → Chat and web chat: uses chat services
- Product views → Knowledge ingestion: uses knowledge services
- Settings views → RPC client: loads and saves (evidence: `apps/desktop/src/features/settings/pipeline/PipelineSettingsPage.tsx`)
