diff --git a/README.md b/README.md
index b516394..bfefc5a 100644
--- a/README.md
+++ b/README.md
@@ -246,37 +246,47 @@ The platform combines security compliance scanning, AI-powered chat with **RAG (
 ## Architecture
 
 ```
-┌─────────────────────────────────────────────────────────────┐
-│                    Docker Compose                            │
-│                                                              │
-│  ┌──────────────┐       ┌──────────────────────────────┐    │
-│  │  Nginx        │       │  FastAPI Backend              │    │
-│  │  (Frontend)   │──────▶│  (Python 3.12)               │    │
-│  │  :8080        │       │  :8000                        │    │
-│  └──────────────┘       │                                │    │
-│                          │  ┌─────────────┐              │    │
-│                          │  │ OCI SDK      │──▶ OCI APIs │    │
-│                          │  ├─────────────┤              │    │
-│                          │  │ GenAI Client │──▶ LLM      │    │
-│                          │  ├─────────────┤   (tools)   │    │
-│                          │  │ MCP Client   │──▶ MCP Svrs │    │
-│                          │  ├─────────────┤   (discover │    │
-│                          │  │              │   +execute) │    │
-│                          │  ├─────────────┤              │    │
-│                          │  │ Terraform    │──▶ Plan /   │    │
-│                          │  │              │   Apply    │    │
-│                          │  ├─────────────┤              │    │
-│                          │  │ oracledb     │──▶ ADB      │    │
-│                          │  ├─────────────┤              │    │
-│                          │  │ RAG Pipeline │──▶ Embed +  │    │
-│                          │  │              │   Search    │    │
-│                          │  └─────────────┘              │    │
-│                          │                                │    │
-│                          │  SQLite (agent.db)             │    │
-│                          └──────────────────────────────┘    │
-│                                     │                        │
-│                              agent-data volume               │
-└─────────────────────────────────────────────────────────────┘
+                         ┌──────────────────────────┐
+                         │      User Browser        │
+                         └────────────┬─────────────┘
+                                      │ :8080
+                         ┌────────────▼─────────────┐
+                         │    Nginx (React SPA)      │
+                         │  Static files + API proxy │
+                         └────────────┬─────────────┘
+                                      │ :8000
+┌─────────────────────────────────────▼──────────────────────────────────┐
+│                     FastAPI Backend (Python 3.12)                       │
+│                     8 uvicorn workers × 10 threads                     │
+│                                                                        │
+│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌───────────────────────┐  │
+│  │ Chat     │  │ Terraform│  │ CIS      │  │ Embedding Pipeline    │  │
+│  │ Agent    │  │ Agent    │  │ Scanner  │  │ (chunk + embed +      │  │
+│  │ (RAG +   │  │ (IaC     │  │ (MCP     │  │  purge + progress)    │  │
+│  │  MCP     │  │  Plan/   │  │  12      │  │                       │  │
+│  │  Tools)  │  │  Apply)  │  │  tools)  │  │ Auto-map CSV→Table    │  │
+│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └───────────┬───────────┘  │
+│       │              │              │                     │              │
+│  ┌────▼──────────────▼──────────────▼─────────────────────▼───────────┐ │
+│  │                    Shared Services                                 │ │
+│  │  OCI SDK → OCI APIs    │  GenAI → LLM (16 models)                │ │
+│  │  oracledb → ADB Vector │  Chromium → PDF generation               │ │
+│  │  SQLite (agent.db)     │  Terraform CLI 1.14.7                    │ │
+│  └────────────────────────────────────────────────────────────────────┘ │
+└────────────────────────────────┬───────────────────────────────────────┘
+                                 │
+                    ┌────────────▼────────────┐
+                    │    agent-data volume     │
+                    │  /data (SQLite, reports, │
+                    │   terraform workspaces,  │
+                    │   OCI configs, wallets)  │
+                    └─────────────────────────┘
+
+                    ┌─────────────────────────┐
+                    │  Oracle ADB (external)   │
+                    │  11 vector tables        │
+                    │  (RAG + embeddings)      │
+                    └─────────────────────────┘
 ```
 
 ---