Updated helm chart diagram

Signed-off-by: Mihai Criveti <[email protected]>

Author: crivetimihai

charts/README.md

@@ -23,6 +23,8 @@ Deploy the full **MCP Gateway Stack**-MCP Context Forge gateway, PostgreSQL, Red
 
 ## Architecture
 
+High-level architecture:
+
 ```
           ┌─────────────────────────────┐
           │      NGINX Ingress          │
@@ -41,6 +43,123 @@ Deploy the full **MCP Gateway Stack**-MCP Context Forge gateway, PostgreSQL, Red
       └──────────┘          └──────────┘
 ```
 
+Chart design:
+
+```mermaid
+graph TB
+    %% External Access
+    Ingress[🌐 NGINX Ingress<br/>gateway.local]
+
+    %% Pre-deployment Job
+    subgraph "Database Migration"
+        MigrationJob[🔄 Migration Job<br/>Alembic upgrade head<br/>Runs before Gateway<br/>CPU: 100m-200m<br/>Memory: 256Mi-512Mi<br/>Restart: Never, Max 3 retries]
+    end
+
+    %% Application Tier
+    subgraph "Application Layer"
+        MCPGateway[🚪 MCP Gateway<br/>Replicas: 2<br/>Port: 4444<br/>CPU: 100m-200m<br/>Memory: 512Mi-1024Mi]
+        FastTimeServer[⏰ Fast Time Server<br/>Replicas: 2<br/>Port: 8080<br/>CPU: 25m-50m<br/>Memory: 10Mi-64Mi]
+        HPA{📈 Auto Scaling<br/>Min: 2, Max: 10<br/>CPU/Memory: 90%}
+    end
+
+    %% Management UIs
+    subgraph "Management UIs - Optional"
+        PgAdmin[📊 PgAdmin<br/>Postgres Web UI<br/>Port: 80<br/>CPU: 100m-200m<br/>Memory: 128Mi-256Mi]
+        RedisCommander[🔧 Redis Commander<br/>Redis Web UI<br/>Port: 8081<br/>CPU: 50m-100m<br/>Memory: 128Mi-256Mi]
+    end
+
+    %% Configuration Management
+    subgraph "Configuration"
+        GatewayConfig[(📄 Gateway ConfigMap<br/>~40 app settings)]
+        GatewaySecret[(🔐 Gateway Secret<br/>Auth & JWT keys)]
+        PostgresConfig[(📄 Postgres ConfigMap<br/>Database name)]
+        PostgresSecret[(🔐 Postgres Secret<br/>DB credentials)]
+    end
+
+    %% Data & State Management
+    subgraph "Data & State"
+        PostgreSQL[(🗄️ PostgreSQL 17<br/>Port: 5432<br/>CPU: 500m-1000m<br/>Memory: 64Mi-1Gi<br/>MCP Server configs)]
+        Redis[(🔄 Redis<br/>Port: 6379<br/>CPU: 50m-100m<br/>Memory: 16Mi-256Mi<br/>Sessions & Cache)]
+        PVC[(💾 Persistent Volume<br/>5Gi RWX Storage<br/>PostgreSQL data)]
+    end
+
+    %% Services Layer
+    subgraph "Services (ClusterIP)"
+        GatewaySvc[🔗 Gateway Service<br/>Port: 80]
+        FastTimeSvc[🔗 Fast Time Service<br/>Port: 80]
+        PostgresSvc[🔗 Postgres Service<br/>Port: 5432]
+        RedisSvc[🔗 Redis Service<br/>Port: 6379]
+        PgAdminSvc[🔗 PgAdmin Service<br/>Port: 80]
+        RedisCommanderSvc[🔗 Redis Commander Service<br/>Port: 8081]
+    end
+
+    %% Network Connections
+    Ingress --> GatewaySvc
+    Ingress -.->|/fast-time| FastTimeSvc
+    GatewaySvc --> MCPGateway
+    FastTimeSvc --> FastTimeServer
+
+    %% Migration Flow (Sequential)
+    MigrationJob -->|Waits for DB ready| PostgresSvc
+    MigrationJob -->|Runs before| MCPGateway
+
+    %% Application to Services
+    MCPGateway --> PostgresSvc
+    MCPGateway --> RedisSvc
+    PostgresSvc --> PostgreSQL
+    RedisSvc --> Redis
+
+    %% UI Connections
+    PgAdminSvc --> PgAdmin
+    RedisCommanderSvc --> RedisCommander
+    PgAdmin --> PostgresSvc
+    RedisCommander --> RedisSvc
+
+    %% Configuration Injection
+    GatewayConfig --> MCPGateway
+    GatewaySecret --> MCPGateway
+    PostgresConfig --> PostgreSQL
+    PostgresSecret --> PostgreSQL
+    PostgresSecret --> PgAdmin
+    PostgresSecret --> MigrationJob
+
+    %% Storage
+    PostgreSQL --> PVC
+
+    %% Auto Scaling
+    HPA -.-> MCPGateway
+
+    %% Health Checks (dotted lines)
+    MCPGateway -.->|/health<br/>/ready| MCPGateway
+    FastTimeServer -.->|/health| FastTimeServer
+    PostgreSQL -.->|pg_isready| PostgreSQL
+    Redis -.->|PING| Redis
+    PgAdmin -.->|/misc/ping| PgAdmin
+    RedisCommander -.->|HTTP root| RedisCommander
+    MigrationJob -.->|db_isready.py| PostgreSQL
+
+    %% Deployment Order (optional visual cue)
+    PostgreSQL -.->|Must be ready first| MigrationJob
+    MigrationJob -.->|Must complete first| MCPGateway
+
+    %% Styling
+    classDef app fill:#e3f2fd,stroke:#1976d2,stroke-width:2px
+    classDef migration fill:#fff3e0,stroke:#ef6c00,stroke-width:3px
+    classDef ui fill:#e8eaf6,stroke:#3f51b5,stroke-width:2px
+    classDef config fill:#fff8e1,stroke:#f57c00,stroke-width:2px
+    classDef data fill:#f1f8e9,stroke:#388e3c,stroke-width:2px
+    classDef service fill:#e0f2f1,stroke:#00695c,stroke-width:2px
+    classDef network fill:#fce4ec,stroke:#c2185b,stroke-width:2px
+
+    class MCPGateway,FastTimeServer,HPA app
+    class MigrationJob migration
+    class PgAdmin,RedisCommander ui
+    class GatewayConfig,GatewaySecret,PostgresConfig,PostgresSecret config
+    class PostgreSQL,Redis,PVC data
+    class GatewaySvc,FastTimeSvc,PostgresSvc,RedisSvc,PgAdminSvc,RedisCommanderSvc service
+    class Ingress network
+```
+
 ---
 
 ## Prerequisites