> ## Documentation Index
> Fetch the complete documentation index at: https://fastql.vachagan.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Architecture overview

> See how FastQL turns Python definitions into GraphQL responses.

FastQL is organized as a staged pipeline with a shared internal schema model.

```mermaid theme={null}
flowchart LR
  A[Python definitions] --> B[Decorator metadata]
  B --> C[Type registry]
  C --> D[Schema builder]
  D --> E[Schema and type map]
  Q[GraphQL source] --> P[Lexer and parser]
  P --> V[Validation]
  E --> V
  V --> X[Async executor]
  E --> S[SDL and introspection]
  X --> R[ExecutionResult]
```

Decorators collect user intent without constructing a parallel execution schema.
The schema builder resolves Python annotations, names, fields, and abstract types
into `fastql.types`. Validation, execution, SDL, and introspection all consume that
compiled representation.

This separation keeps the public declaration API ergonomic while preserving clear
GraphQL language and runtime boundaries.