Skip to content

docs: update the architecture which is much beautiful #8

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
membphis merged 3 commits into from
Mar 30, 2026
Merged

docs: update the architecture which is much beautiful #8

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
631ecdd
docs: update the architecture which is much beautiful
membphis Mar 30, 2026
0254749
docs: add agent-readable architecture summary
membphis Mar 30, 2026
85ba005
docs: fix double slash in architecture image path
membphis Mar 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added docs/images/architecture_std.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
61 changes: 29 additions & 32 deletions docs/introduction/overview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,39 +31,36 @@ AISIX uses a decoupled architecture, separating the Control Plane (configuration

Here is a diagram illustrating the basic architecture:

```mermaid
graph TD
subgraph "Management & Configuration (Control Plane)"
Admin[Admin User] --> AdminUI[Admin UI / Dashboard]
AdminUI --> AdminAPI[Admin API]
AdminAPI --> Etcd[(etcd)]
end

subgraph "Request Path (Data Plane)"
Client[Client App] --> AISIX[AISIX AI Gateway]
AISIX --> Auth{Authentication}
Auth --> ModelV{Model Validation}
ModelV --> RateLimit{Rate Limiting}
RateLimit --> Proxy[Proxy to Upstream]
end

subgraph "Upstream LLM Providers"
OpenAI[OpenAI]
Gemini[Google Gemini]
DeepSeek[DeepSeek]
Anthropic[Anthropic]
end

Proxy --> OpenAI
Proxy --> Gemini
Proxy --> DeepSeek
Proxy --> Anthropic

Etcd -.->|Watch Config| AISIX

style AISIX fill:#009639,stroke:#fff,color:#fff
style Etcd fill:#f96,stroke:#333,stroke-width:2px
<img src="../images/architecture_std.png" alt="AISIX Architecture Diagram" style="width:100%; max-width:800px; margin: 20px auto; display: block;" />

**Components:**

| Component | Plane | Role |
| :--- | :--- | :--- |
| **Client App** | — | Sends requests to the AISIX Proxy API (port 3000) |
| **AISIX Gateway** | Data Plane | Stateless Rust proxy that processes requests through a hook pipeline |
| **etcd** | Control Plane | Stores API keys, models, and rate limit config; watched by the gateway for hot-reload |
| **Admin API** | Control Plane | REST API for managing configuration in etcd (port 3001) |
| **Admin UI** | Control Plane | Optional React dashboard and chat playground backed by the Admin API |
| **Upstream Providers** | — | OpenAI, Google Gemini, DeepSeek, and Anthropic |

**Request Flow (Data Plane):**

```text
Client -> AISIX Gateway -> [Auth] -> [Model Validation] -> [Rate Limit] -> Upstream Provider
```

**Config Flows (Control Plane):**

```text
# Manage configuration via Admin UI:
Admin User -> Admin UI -> Admin API -> etcd <-- AISIX Gateway(watch etcd for changes)

# Manage configuration via Admin API:
Admin User ------------------------> Admin API -> etcd <-- AISIX Gateway(watch etcd for changes)
```


<br/>

This decoupled design ensures that the Data Plane continues to operate with its last known configuration even if the Control Plane is temporarily unavailable, guaranteeing uninterrupted service.
Expand Down
Loading