feat(demo): add OpenShift deployment for flow visualization

Add deployment script and manifests to serve the interactive flow
visualization as a web service on OpenShift:

- deploy-flow-viz.sh: One-command deployment script
- flow-viz-deployment.yaml: Kubernetes manifests for nginx + route
- Creates ConfigMap from HTML file
- Exposes via OpenShift route for easy access during demos
- Updated DEMO-README.md with deployment instructions

Perfect for presentations - get a public URL in seconds.

Signed-off-by: Yossi Ovadia <yovadia@redhat.com>

Author: yossiovadia

deploy/openshift/demo/DEMO-README.md

@@ -230,17 +230,27 @@ Restarts semantic-router deployment to clear in-memory cache (~30 seconds).
 - `curl-examples.sh` - Quick classification examples (direct API)
 - `cache-management.sh` - Cache management helper
 - `flow-visualization.html` - **Interactive flow visualization** (open in browser)
+- `deploy-flow-viz.sh` - Deploy flow visualization to OpenShift
 - `CATEGORY-MODEL-MAPPING.md` - Category to model routing reference
 - `demo-classification-results.json` - Test results (auto-generated)
 
 ### Flow Visualization
 
-Open `flow-visualization.html` in your browser for an **interactive visual guide** showing:
+**Interactive visual guide** showing step-by-step request flow, security checks, classification, and routing decisions.
 
-- Step-by-step request flow from user to model
-- Security checks, classification, and routing decisions
-- Performance metrics and key features
-- Animated walkthrough of the entire pipeline
+#### Option 1: Deploy to OpenShift (Recommended for Demos)
+
+```bash
+# Deploy as a web service with public URL
+./deploy/openshift/demo/deploy-flow-viz.sh
+```
+
+This creates a lightweight nginx pod and gives you a URL like:
+`http://flow-visualization-vllm-semantic-router-system.apps.cluster-xxx.opentlc.com`
+
+Perfect for presentations - just open the URL and click "Start Animation"!
+
+#### Option 2: Open Locally
 
 ```bash
 # Open in browser (macOS)

deploy/openshift/demo/deploy-flow-viz.sh

@@ -0,0 +1,68 @@
+#!/bin/bash
+#
+# Deploy Flow Visualization to OpenShift
+#
+# This script deploys the interactive flow visualization HTML page
+# to OpenShift as a lightweight nginx service with a public route.
+#
+
+set -e
+
+# Colors
+GREEN='\033[0;32m'
+CYAN='\033[0;36m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+NAMESPACE="vllm-semantic-router-system"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HTML_FILE="${SCRIPT_DIR}/flow-visualization.html"
+
+echo -e "${CYAN}Deploying Flow Visualization to OpenShift...${NC}\n"
+
+# Check if logged into OpenShift
+if ! oc whoami &>/dev/null; then
+    echo -e "${RED}Error: Not logged into OpenShift${NC}"
+    echo -e "${YELLOW}Please run: oc login${NC}"
+    exit 1
+fi
+
+# Check if HTML file exists
+if [ ! -f "$HTML_FILE" ]; then
+    echo -e "${RED}Error: flow-visualization.html not found${NC}"
+    exit 1
+fi
+
+# Create or update ConfigMap with the HTML content
+echo -e "${CYAN}📄 Creating ConfigMap with HTML content...${NC}"
+oc create configmap flow-visualization-html \
+    --from-file=index.html="$HTML_FILE" \
+    -n "$NAMESPACE" \
+    --dry-run=client -o yaml | oc apply -f -
+
+# Deploy the nginx service
+echo -e "${CYAN}🚀 Deploying nginx service...${NC}"
+oc apply -f "${SCRIPT_DIR}/flow-viz-deployment.yaml" -n "$NAMESPACE"
+
+# Wait for deployment to be ready
+echo -e "${CYAN}⏳ Waiting for deployment to be ready...${NC}"
+oc rollout status deployment/flow-visualization -n "$NAMESPACE" --timeout=60s
+
+# Get the route URL
+echo -e "\n${GREEN}✅ Deployment successful!${NC}\n"
+
+ROUTE_URL=$(oc get route flow-visualization -n "$NAMESPACE" -o jsonpath='{.spec.host}' 2>/dev/null)
+
+if [ -n "$ROUTE_URL" ]; then
+    echo -e "${GREEN}🌐 Flow Visualization URL:${NC}"
+    echo -e "   ${CYAN}http://${ROUTE_URL}${NC}\n"
+
+    echo -e "${YELLOW}💡 For your demo:${NC}"
+    echo -e "   1. Open the URL in your browser"
+    echo -e "   2. Click 'Start Animation' to show the flow"
+    echo -e "   3. Click any step to see detailed information\n"
+else
+    echo -e "${RED}Warning: Could not retrieve route URL${NC}"
+    echo -e "${YELLOW}Check manually with: oc get route flow-visualization -n ${NAMESPACE}${NC}\n"
+fi

deploy/openshift/demo/flow-viz-deployment.yaml

@@ -0,0 +1,71 @@
+---
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: flow-visualization-html
+  namespace: vllm-semantic-router-system
+data:
+  index.html: |
+    <!-- Content will be added via: kubectl create configmap flow-visualization-html --from-file=index.html=flow-visualization.html -->
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: flow-visualization
+  namespace: vllm-semantic-router-system
+  labels:
+    app: flow-visualization
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: flow-visualization
+  template:
+    metadata:
+      labels:
+        app: flow-visualization
+    spec:
+      containers:
+      - name: nginx
+        image: nginx:alpine
+        ports:
+        - containerPort: 80
+        volumeMounts:
+        - name: html
+          mountPath: /usr/share/nginx/html
+          readOnly: true
+        resources:
+          requests:
+            memory: "32Mi"
+            cpu: "10m"
+          limits:
+            memory: "64Mi"
+            cpu: "50m"
+      volumes:
+      - name: html
+        configMap:
+          name: flow-visualization-html
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: flow-visualization
+  namespace: vllm-semantic-router-system
+spec:
+  selector:
+    app: flow-visualization
+  ports:
+  - port: 80
+    targetPort: 80
+---
+apiVersion: route.openshift.io/v1
+kind: Route
+metadata:
+  name: flow-visualization
+  namespace: vllm-semantic-router-system
+spec:
+  to:
+    kind: Service
+    name: flow-visualization
+  port:
+    targetPort: 80