---
title: "Data flow"
manual: "AI Assistant"
version: "main"
source: "Developers/Architecture/DataFlow.rst"
rendered: "2026-10-03T14:54:45+00:00"
---

# Data flow {#data-flow}

## Request lifecycle {#request-lifecycle}

```mermaid
sequenceDiagram
    participant User
    participant Controller
    participant Orchestrator
    participant Pipeline
    participant AI
    participant VectorStore

    User->>Controller: message
    Controller->>Orchestrator: AssistantRequest
    Orchestrator->>Pipeline: Context
    Pipeline->>AI: query optimization / answer generation
    Pipeline->>VectorStore: retrieval
    VectorStore-->>Pipeline: documents
    Pipeline-->>Orchestrator: AssistantResponse
    Orchestrator-->>Controller: response
    Controller-->>User: answer
```

## Indexing lifecycle {#indexing-lifecycle}

```mermaid
sequenceDiagram
    participant Command
    participant Indexer
    participant Source
    participant Chunker
    participant AI
    participant VectorStore
    participant State

    Command->>Indexer: IndexingRequest
    Indexer->>Source: fetch/read source
    Source-->>Indexer: document data
    Indexer->>State: compare source/content hash
    Indexer->>Chunker: split text
    Chunker-->>Indexer: chunks
    Indexer->>AI: embeddings
    AI-->>Indexer: vectors
    Indexer->>VectorStore: write/delete vectors
    Indexer->>State: update state
```