smart_message 0.0.10 → 0.0.12

data/docs/assets/images/enhanced-microservices-routing.svg

@@ -0,0 +1,115 @@
+<svg width="900" height="700" xmlns="http://www.w3.org/2000/svg" style="background: transparent;">
+  <defs>
+    <style>
+      .title { font: bold 18px sans-serif; fill: #e1e5e9; text-anchor: middle; }
+      .label { font: 14px sans-serif; fill: #c9d1d9; text-anchor: middle; }
+      .small-label { font: 11px sans-serif; fill: #8b949e; text-anchor: middle; }
+      .code-label { font: 10px monospace; fill: #f0f6fc; }
+      .service-name { font: 12px sans-serif; fill: #f0f6fc; text-anchor: middle; font-weight: bold; }
+      .api-gateway-box { fill: #0d1117; stroke: #f85149; stroke-width: 2; rx: 8; }
+      .web-service-box { fill: #0d1117; stroke: #56d364; stroke-width: 2; rx: 8; }
+      .db-service-box { fill: #0d1117; stroke: #a5a5ff; stroke-width: 2; rx: 8; }
+      .payment-service-box { fill: #0d1117; stroke: #ffa657; stroke-width: 2; rx: 8; }
+      .monitoring-box { fill: #161b22; stroke: #8b949e; stroke-width: 2; rx: 8; }
+      .message-flow { stroke: #58a6ff; stroke-width: 2; fill: none; marker-end: url(#arrowhead); }
+      .pattern-flow { stroke: #a5a5ff; stroke-width: 2; fill: none; marker-end: url(#arrowhead-purple); stroke-dasharray: 3,3; }
+      .alert-flow { stroke: #f85149; stroke-width: 2; fill: none; marker-end: url(#arrowhead-red); }
+    </style>
+    <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#58a6ff" />
+    </marker>
+    <marker id="arrowhead-purple" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#a5a5ff" />
+    </marker>
+    <marker id="arrowhead-red" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#f85149" />
+    </marker>
+  </defs>
+  
+  <!-- Title -->
+  <text x="450" y="30" class="title">Redis Enhanced Transport: Microservices Routing</text>
+  
+  <!-- API Gateway (Central Hub) -->
+  <rect x="350" y="80" width="200" height="80" class="api-gateway-box"/>
+  <text x="450" y="110" class="service-name">API Gateway</text>
+  <text x="450" y="130" class="small-label">Routes all incoming requests</text>
+  <text x="450" y="145" class="code-label">Publishes: *.api_gateway.*</text>
+  
+  <!-- Web Service -->
+  <rect x="100" y="200" width="150" height="60" class="web-service-box"/>
+  <text x="175" y="225" class="service-name">Web Service</text>
+  <text x="175" y="245" class="code-label">Pattern: *.*.web_service</text>
+  
+  <!-- User Service -->
+  <rect x="300" y="200" width="150" height="60" class="web-service-box"/>
+  <text x="375" y="225" class="service-name">User Service</text>
+  <text x="375" y="245" class="code-label">Pattern: *.*.user_service</text>
+  
+  <!-- Order Service -->
+  <rect x="500" y="200" width="150" height="60" class="web-service-box"/>
+  <text x="575" y="225" class="service-name">Order Service</text>
+  <text x="575" y="245" class="code-label">Pattern: *.*.order_service</text>
+  
+  <!-- Database Layer -->
+  <rect x="650" y="320" width="150" height="60" class="db-service-box"/>
+  <text x="725" y="345" class="service-name">Database Layer</text>
+  <text x="725" y="365" class="code-label">Pattern: *.*.database</text>
+  
+  <!-- Payment Gateway -->
+  <rect x="100" y="320" width="150" height="60" class="payment-service-box"/>
+  <text x="175" y="345" class="service-name">Payment Service</text>
+  <text x="175" y="365" class="code-label">Pattern: *.payment.*</text>
+  
+  <!-- Monitoring & Logging -->
+  <rect x="350" y="440" width="200" height="60" class="monitoring-box"/>
+  <text x="450" y="465" class="service-name">Monitoring Service</text>
+  <text x="450" y="485" class="code-label">Pattern: alertmessage.*.*</text>
+  
+  <!-- Message Flows from API Gateway -->
+  <line x1="400" y1="160" x2="175" y2="200" class="message-flow"/>
+  <text x="280" y="175" class="code-label">usermessage.api_gateway.web_service</text>
+  
+  <line x1="430" y1="160" x2="375" y2="200" class="message-flow"/>
+  <text x="410" y="175" class="code-label">authmessage.api_gateway.user_service</text>
+  
+  <line x1="480" y1="160" x2="575" y2="200" class="message-flow"/>
+  <text x="540" y="175" class="code-label">ordermessage.api_gateway.order_service</text>
+  
+  <!-- Internal Service Communications -->
+  <line x1="450" y1="260" x2="725" y2="320" class="pattern-flow"/>
+  <text x="590" y="290" class="code-label">querymessage.user_service.database</text>
+  
+  <line x1="575" y1="260" x2="725" y2="320" class="pattern-flow"/>
+  <text x="650" y="305" class="code-label">ordersavemessage.order_service.database</text>
+  
+  <line x1="375" y1="260" x2="175" y2="320" class="pattern-flow"/>
+  <text x="260" y="285" class="code-label">paymentmessage.user_service.payment</text>
+  
+  <!-- Alert/Monitoring Flows -->
+  <line x1="175" y1="380" x2="400" y2="440" class="alert-flow"/>
+  <text x="240" y="415" class="code-label">alertmessage.payment.monitoring</text>
+  
+  <line x1="725" y1="380" x2="500" y2="440" class="alert-flow"/>
+  <text x="620" y="415" class="code-label">alertmessage.database.monitoring</text>
+  
+  <!-- Routing Patterns Legend -->
+  <rect x="50" y="520" width="800" height="160" class="api-gateway-box"/>
+  <text x="450" y="545" class="label">Common Routing Patterns</text>
+  
+  <!-- Pattern Examples -->
+  <text x="100" y="570" class="service-name">Service-to-Service Communication:</text>
+  <text x="100" y="590" class="code-label">transport.where.from('api_gateway').to('user_service').subscribe</text>
+  <text x="100" y="605" class="small-label"># Receives: *.api_gateway.user_service</text>
+  
+  <text x="100" y="630" class="service-name">Cross-Service Message Types:</text>
+  <text x="100" y="650" class="code-label">transport.where.type('PaymentMessage').subscribe</text>
+  <text x="100" y="665" class="small-label"># Receives: paymentmessage.*.*</text>
+  
+  <text x="500" y="570" class="service-name">Alert Aggregation:</text>
+  <text x="500" y="590" class="code-label">transport.where.type('AlertMessage').to('monitoring').subscribe</text>
+  <text x="500" y="605" class="small-label"># Receives: alertmessage.*.monitoring</text>
+  
+  <text x="500" y="630" class="service-name">Service Health Monitoring:</text>
+  <text x="500" y="650" class="code-label">transport.where.from('database').type('HealthMessage').subscribe</text>
+  <text x="500" y="665" class="small-label"># Receives: healthmessage.database.*</text>
+</svg>

data/docs/assets/images/enhanced-pattern-matching.svg

@@ -0,0 +1,107 @@
+<svg width="900" height="500" xmlns="http://www.w3.org/2000/svg" style="background: transparent;">
+  <defs>
+    <style>
+      .title { font: bold 18px sans-serif; fill: #e1e5e9; text-anchor: middle; }
+      .label { font: 14px sans-serif; fill: #c9d1d9; text-anchor: middle; }
+      .small-label { font: 12px sans-serif; fill: #8b949e; text-anchor: middle; }
+      .code-label { font: 12px monospace; fill: #f0f6fc; }
+      .box { fill: #21262d; stroke: #30363d; stroke-width: 2; rx: 8; }
+      .pattern-box { fill: #0d1117; stroke: #a5a5ff; stroke-width: 2; rx: 6; }
+      .message-box { fill: #161b22; stroke: #56d364; stroke-width: 2; rx: 6; }
+      .match-box { fill: #0d1117; stroke: #ffa657; stroke-width: 2; rx: 6; }
+      .arrow { stroke: #58a6ff; stroke-width: 2; fill: none; marker-end: url(#arrowhead); }
+      .match-flow { stroke: #56d364; stroke-width: 3; fill: none; marker-end: url(#arrowhead-green); }
+      .no-match-flow { stroke: #f85149; stroke-width: 2; fill: none; marker-end: url(#arrowhead-red); stroke-dasharray: 5,5; }
+    </style>
+    <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#58a6ff" />
+    </marker>
+    <marker id="arrowhead-green" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#56d364" />
+    </marker>
+    <marker id="arrowhead-red" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#f85149" />
+    </marker>
+  </defs>
+  
+  <!-- Title -->
+  <text x="450" y="30" class="title">Redis Enhanced Transport: Pattern Matching</text>
+  
+  <!-- Pattern Subscriptions Section -->
+  <text x="150" y="65" class="label">Pattern Subscriptions</text>
+  
+  <!-- Pattern Examples -->
+  <rect x="50" y="80" width="200" height="30" class="pattern-box"/>
+  <text x="60" y="100" class="code-label">ordermessage.*.*</text>
+  
+  <rect x="50" y="120" width="200" height="30" class="pattern-box"/>
+  <text x="60" y="140" class="code-label">*.payment_gateway.*</text>
+  
+  <rect x="50" y="160" width="200" height="30" class="pattern-box"/>
+  <text x="60" y="180" class="code-label">alertmessage.*.*</text>
+  
+  <!-- Messages Section -->
+  <text x="500" y="65" class="label">Incoming Messages</text>
+  
+  <!-- Message Examples -->
+  <rect x="350" y="80" width="300" height="30" class="message-box"/>
+  <text x="360" y="100" class="code-label">ordermessage.api_gateway.order_service</text>
+  
+  <rect x="350" y="120" width="300" height="30" class="message-box"/>
+  <text x="360" y="140" class="code-label">paymessage.payment_gateway.bank_api</text>
+  
+  <rect x="350" y="160" width="300" height="30" class="message-box"/>
+  <text x="360" y="180" class="code-label">alertmessage.monitoring.admin_panel</text>
+  
+  <rect x="350" y="200" width="300" height="30" class="message-box"/>
+  <text x="360" y="220" class="code-label">logmessage.web_server.log_aggregator</text>
+  
+  <!-- Matching Results -->
+  <text x="750" y="65" class="label">Match Results</text>
+  
+  <rect x="680" y="80" width="60" height="30" class="match-box"/>
+  <text x="710" y="100" class="small-label">✓ MATCH</text>
+  
+  <rect x="680" y="120" width="60" height="30" class="match-box"/>
+  <text x="710" y="140" class="small-label">✓ MATCH</text>
+  
+  <rect x="680" y="160" width="60" height="30" class="match-box"/>
+  <text x="710" y="180" class="small-label">✓ MATCH</text>
+  
+  <rect x="680" y="200" width="60" height="30" class="box"/>
+  <text x="710" y="220" class="small-label">✗ NO MATCH</text>
+  
+  <!-- Arrows showing matching -->
+  <line x1="250" y1="95" x2="350" y2="95" class="arrow"/>
+  <line x1="650" y1="95" x2="680" y2="95" class="match-flow"/>
+  
+  <line x1="250" y1="135" x2="350" y2="135" class="arrow"/>
+  <line x1="650" y1="135" x2="680" y2="135" class="match-flow"/>
+  
+  <line x1="250" y1="175" x2="350" y2="175" class="arrow"/>
+  <line x1="650" y1="175" x2="680" y2="175" class="match-flow"/>
+  
+  <line x1="650" y1="215" x2="680" y2="215" class="no-match-flow"/>
+  
+  <!-- Wildcard Legend -->
+  <rect x="50" y="260" width="800" height="180" class="box"/>
+  <text x="450" y="285" class="label">Pattern Wildcard Guide</text>
+  
+  <!-- Single Wildcard Examples -->
+  <text x="200" y="310" class="label">Single Wildcard (*)</text>
+  <text x="80" y="335" class="code-label">Pattern: *.payment_gateway.*</text>
+  <text x="80" y="355" class="small-label">✓ Matches: ordermessage.payment_gateway.bank_api</text>
+  <text x="80" y="375" class="small-label">✓ Matches: alertmessage.payment_gateway.admin_panel</text>
+  <text x="80" y="395" class="small-label">✗ No Match: payment_gateway.bank_api (missing first segment)</text>
+  
+  <!-- Multiple Wildcard Examples -->
+  <text x="650" y="310" class="label">Multiple Wildcards</text>
+  <text x="500" y="335" class="code-label">Pattern: ordermessage.*.*</text>
+  <text x="500" y="355" class="small-label">✓ Matches: ordermessage.api.service</text>
+  <text x="500" y="375" class="small-label">✓ Matches: ordermessage.web.database</text>
+  <text x="500" y="395" class="small-label">✗ No Match: ordermessage.api (too few segments)</text>
+  
+  <!-- Key Benefits -->
+  <text x="450" y="450" class="label">Key Benefits: Flexible routing + RabbitMQ-style patterns + Redis performance</text>
+  <text x="450" y="470" class="small-label">Perfect for microservices requiring intelligent message routing without complex infrastructure</text>
+</svg>

data/docs/assets/images/fluent-api-demo.svg

@@ -0,0 +1,59 @@
+<svg width="900" height="500" xmlns="http://www.w3.org/2000/svg" style="background: transparent;">
+  <defs>
+    <style>
+      .title { font: bold 18px sans-serif; fill: #e1e5e9; text-anchor: middle; }
+      .subtitle { font: 16px sans-serif; fill: #c9d1d9; text-anchor: middle; }
+      .code { font: 14px 'Courier New', monospace; fill: #79c0ff; }
+      .comment { font: 12px 'Courier New', monospace; fill: #8b949e; }
+      .string { font: 14px 'Courier New', monospace; fill: #a5c261; }
+      .keyword { font: 14px 'Courier New', monospace; fill: #ff7b72; }
+      .method { font: 14px 'Courier New', monospace; fill: #ffa657; }
+      .pattern-result { font: 12px 'Courier New', monospace; fill: #56d364; }
+      .box { fill: #21262d; stroke: #30363d; stroke-width: 2; rx: 8; }
+      .highlight-box { fill: #0d1117; stroke: #a5a5ff; stroke-width: 2; rx: 8; }
+      .result-box { fill: #161b22; stroke: #56d364; stroke-width: 2; rx: 6; }
+    </style>
+  </defs>
+  
+  <!-- Title -->
+  <text x="450" y="30" class="title">Redis Enhanced Transport - Fluent API Examples</text>
+  
+  <!-- Basic Examples -->
+  <rect x="50" y="60" width="800" height="140" class="box"/>
+  <text x="450" y="85" class="subtitle">Basic Fluent API Patterns</text>
+  
+  <!-- From subscription -->
+  <text x="70" y="110" class="comment">// Subscribe to all messages FROM a specific service</text>
+  <text x="70" y="130" class="code">transport.</text><text x="170" y="130" class="method">where</text><text x="220" y="130" class="code">().</text><text x="260" y="130" class="method">from</text><text x="300" y="130" class="code">(</text><text x="310" y="130" class="string">'api-gateway'</text><text x="420" y="130" class="code">).</text><text x="460" y="130" class="method">subscribe</text>
+  <text x="70" y="150" class="pattern-result">→ Pattern: *.api-gateway.*</text>
+  
+  <!-- To subscription -->
+  <text x="70" y="175" class="comment">// Subscribe to all messages TO a specific service</text>
+  <text x="70" y="195" class="code">transport.</text><text x="170" y="195" class="method">where</text><text x="220" y="195" class="code">().</text><text x="260" y="195" class="method">to</text><text x="290" y="195" class="code">(</text><text x="300" y="195" class="string">'user-service'</text><text x="420" y="195" class="code">).</text><text x="460" y="195" class="method">subscribe</text>
+  <text x="70" y="215" class="pattern-result">→ Pattern: *.*.user-service</text>
+  
+  <!-- Combined Examples -->
+  <rect x="50" y="220" width="800" height="160" class="highlight-box"/>
+  <text x="450" y="245" class="subtitle">Combined Conditions</text>
+  
+  <!-- Two conditions -->
+  <text x="70" y="270" class="comment">// FROM web-app TO user-service</text>
+  <text x="70" y="290" class="code">transport.</text><text x="170" y="290" class="method">where</text><text x="220" y="290" class="code">().</text><text x="260" y="290" class="method">from</text><text x="300" y="290" class="code">(</text><text x="310" y="290" class="string">'web-app'</text><text x="390" y="290" class="code">).</text><text x="430" y="290" class="method">to</text><text x="460" y="290" class="code">(</text><text x="470" y="290" class="string">'user-service'</text><text x="580" y="290" class="code">).</text><text x="620" y="290" class="method">subscribe</text>
+  <text x="70" y="310" class="pattern-result">→ Pattern: *.web-app.user-service</text>
+  
+  <!-- Three conditions -->
+  <text x="70" y="335" class="comment">// Specific message TYPE from monitoring TO admin</text>
+  <text x="70" y="355" class="code">transport.</text><text x="170" y="355" class="method">where</text><text x="220" y="355" class="code">().</text><text x="260" y="355" class="method">type</text><text x="300" y="355" class="code">(</text><text x="310" y="355" class="string">'AlertMessage'</text><text x="430" y="355" class="code">).</text><text x="470" y="355" class="method">from</text><text x="510" y="355" class="code">(</text><text x="520" y="355" class="string">'monitoring'</text><text x="620" y="355" class="code">).</text><text x="660" y="355" class="method">to</text><text x="690" y="355" class="code">(</text><text x="700" y="355" class="string">'admin'</text><text x="750" y="355" class="code">)</text>
+  <text x="70" y="375" class="pattern-result">→ Pattern: alertmessage.monitoring.admin</text>
+  
+  <!-- Convenience vs Fluent -->
+  <rect x="50" y="400" width="400" height="80" class="result-box"/>
+  <text x="250" y="425" class="subtitle">Convenience Methods</text>
+  <text x="70" y="450" class="code">transport.</text><text x="170" y="450" class="method">subscribe_to_alerts</text><text x="320" y="450" class="code">()</text>
+  <text x="70" y="470" class="comment">// Multiple alert patterns automatically</text>
+  
+  <rect x="470" y="400" width="380" height="80" class="result-box"/>
+  <text x="660" y="425" class="subtitle">Equivalent Fluent</text>
+  <text x="490" y="445" class="code">transport.</text><text x="590" y="445" class="method">where</text><text x="640" y="445" class="code">().</text><text x="680" y="445" class="method">type</text><text x="720" y="445" class="code">(</text><text x="730" y="445" class="string">'AlertMessage'</text><text x="840" y="445" class="code">)</text>
+  <text x="490" y="465" class="code">  .</text><text x="530" y="465" class="method">subscribe</text>
+</svg>

data/docs/assets/images/performance-comparison.svg

@@ -0,0 +1,161 @@
+<svg width="900" height="600" xmlns="http://www.w3.org/2000/svg" style="background: transparent;">
+  <defs>
+    <style>
+      .title { font: bold 20px sans-serif; fill: #e1e5e9; text-anchor: middle; }
+      .subtitle { font: 16px sans-serif; fill: #c9d1d9; text-anchor: middle; }
+      .label { font: 14px sans-serif; fill: #c9d1d9; }
+      .small-label { font: 12px sans-serif; fill: #8b949e; }
+      .value-label { font: 12px sans-serif; fill: #f0f6fc; text-anchor: middle; }
+      .chart-bg { fill: #161b22; stroke: #30363d; stroke-width: 1; }
+      .axis { stroke: #30363d; stroke-width: 2; }
+      .bar-basic { fill: #58a6ff; }
+      .bar-enhanced { fill: #a5a5ff; }
+      .bar-queue { fill: #56d364; }
+      .grid { stroke: #21262d; stroke-width: 1; opacity: 0.5; }
+    </style>
+  </defs>
+  
+  <!-- Title -->
+  <text x="450" y="30" class="title">Redis Transport Performance Comparison</text>
+  
+  <!-- Latency Chart -->
+  <rect x="50" y="60" width="380" height="200" class="chart-bg"/>
+  <text x="240" y="85" class="subtitle">Latency (Lower is Better)</text>
+  
+  <!-- Y-axis labels for latency -->
+  <text x="45" y="110" class="small-label">2ms</text>
+  <text x="45" y="140" class="small-label">1.5ms</text>
+  <text x="45" y="170" class="small-label">1ms</text>
+  <text x="45" y="200" class="small-label">0.5ms</text>
+  <text x="45" y="230" class="small-label">0ms</text>
+  
+  <!-- Grid lines -->
+  <line x1="60" y1="110" x2="420" y2="110" class="grid"/>
+  <line x1="60" y1="140" x2="420" y2="140" class="grid"/>
+  <line x1="60" y1="170" x2="420" y2="170" class="grid"/>
+  <line x1="60" y1="200" x2="420" y2="200" class="grid"/>
+  
+  <!-- Axes -->
+  <line x1="60" y1="100" x2="60" y2="240" class="axis"/>
+  <line x1="60" y1="240" x2="420" y2="240" class="axis"/>
+  
+  <!-- Latency Bars -->
+  <rect x="80" y="200" width="60" height="40" class="bar-basic"/>
+  <text x="110" y="255" class="value-label">Basic</text>
+  <text x="110" y="270" class="small-label">1.0ms</text>
+  
+  <rect x="180" y="188" width="60" height="52" class="bar-enhanced"/>
+  <text x="210" y="255" class="value-label">Enhanced</text>
+  <text x="210" y="270" class="small-label">1.2ms</text>
+  
+  <rect x="280" y="220" width="60" height="20" class="bar-queue"/>
+  <text x="310" y="255" class="value-label">Queue</text>
+  <text x="310" y="270" class="small-label">0.5ms</text>
+  
+  <!-- Throughput Chart -->
+  <rect x="470" y="60" width="380" height="200" class="chart-bg"/>
+  <text x="660" y="85" class="subtitle">Throughput (Higher is Better)</text>
+  
+  <!-- Y-axis labels for throughput -->
+  <text x="465" y="110" class="small-label">120K</text>
+  <text x="465" y="140" class="small-label">100K</text>
+  <text x="465" y="170" class="small-label">80K</text>
+  <text x="465" y="200" class="small-label">60K</text>
+  <text x="465" y="230" class="small-label">40K</text>
+  
+  <!-- Grid lines -->
+  <line x1="480" y1="110" x2="840" y2="110" class="grid"/>
+  <line x1="480" y1="140" x2="840" y2="140" class="grid"/>
+  <line x1="480" y1="170" x2="840" y2="170" class="grid"/>
+  <line x1="480" y1="200" x2="840" y2="200" class="grid"/>
+  
+  <!-- Axes -->
+  <line x1="480" y1="100" x2="480" y2="240" class="axis"/>
+  <line x1="480" y1="240" x2="840" y2="240" class="axis"/>
+  
+  <!-- Throughput Bars -->
+  <rect x="500" y="160" width="60" height="80" class="bar-basic"/>
+  <text x="530" y="255" class="value-label">Basic</text>
+  <text x="530" y="270" class="small-label">80K msg/s</text>
+  
+  <rect x="600" y="165" width="60" height="75" class="bar-enhanced"/>
+  <text x="630" y="255" class="value-label">Enhanced</text>
+  <text x="630" y="270" class="small-label">75K msg/s</text>
+  
+  <rect x="700" y="120" width="60" height="120" class="bar-queue"/>
+  <text x="730" y="255" class="value-label">Queue</text>
+  <text x="730" y="270" class="small-label">100K+ msg/s</text>
+  
+  <!-- Memory Usage Chart -->
+  <rect x="50" y="300" width="380" height="200" class="chart-bg"/>
+  <text x="240" y="325" class="subtitle">Memory per Consumer (Lower is Better)</text>
+  
+  <!-- Y-axis labels for memory -->
+  <text x="45" y="350" class="small-label">10MB</text>
+  <text x="45" y="380" class="small-label">8MB</text>
+  <text x="45" y="410" class="small-label">6MB</text>
+  <text x="45" y="440" class="small-label">4MB</text>
+  <text x="45" y="470" class="small-label">2MB</text>
+  
+  <!-- Grid lines -->
+  <line x1="60" y1="350" x2="420" y2="350" class="grid"/>
+  <line x1="60" y1="380" x2="420" y2="380" class="grid"/>
+  <line x1="60" y1="410" x2="420" y2="410" class="grid"/>
+  <line x1="60" y1="440" x2="420" y2="440" class="grid"/>
+  
+  <!-- Axes -->
+  <line x1="60" y1="340" x2="60" y2="480" class="axis"/>
+  <line x1="60" y1="480" x2="420" y2="480" class="axis"/>
+  
+  <!-- Memory Bars -->
+  <rect x="80" y="460" width="60" height="20" class="bar-basic"/>
+  <text x="110" y="495" class="value-label">Basic</text>
+  <text x="110" y="510" class="small-label">~1MB</text>
+  
+  <rect x="180" y="440" width="60" height="40" class="bar-enhanced"/>
+  <text x="210" y="495" class="value-label">Enhanced</text>
+  <text x="210" y="510" class="small-label">~2MB</text>
+  
+  <rect x="280" y="455" width="60" height="25" class="bar-queue"/>
+  <text x="310" y="495" class="value-label">Queue</text>
+  <text x="310" y="510" class="small-label">~1.5MB</text>
+  
+  <!-- Concurrent Consumers Chart -->
+  <rect x="470" y="300" width="380" height="200" class="chart-bg"/>
+  <text x="660" y="325" class="subtitle">Max Concurrent Consumers</text>
+  
+  <!-- Y-axis labels for consumers -->
+  <text x="465" y="350" class="small-label">1200</text>
+  <text x="465" y="380" class="small-label">1000</text>
+  <text x="465" y="410" class="small-label">800</text>
+  <text x="465" y="440" class="small-label">600</text>
+  <text x="465" y="470" class="small-label">400</text>
+  
+  <!-- Grid lines -->
+  <line x1="480" y1="350" x2="840" y2="350" class="grid"/>
+  <line x1="480" y1="380" x2="840" y2="380" class="grid"/>
+  <line x1="480" y1="410" x2="840" y2="410" class="grid"/>
+  <line x1="480" y1="440" x2="840" y2="440" class="grid"/>
+  
+  <!-- Axes -->
+  <line x1="480" y1="340" x2="480" y2="480" class="axis"/>
+  <line x1="480" y1="480" x2="840" y2="480" class="axis"/>
+  
+  <!-- Consumer Bars -->
+  <rect x="500" y="440" width="60" height="40" class="bar-basic"/>
+  <text x="530" y="495" class="value-label">Basic</text>
+  <text x="530" y="510" class="small-label">~200</text>
+  
+  <rect x="600" y="435" width="60" height="45" class="bar-enhanced"/>
+  <text x="630" y="495" class="value-label">Enhanced</text>
+  <text x="630" y="510" class="small-label">~250</text>
+  
+  <rect x="700" y="360" width="60" height="120" class="bar-queue"/>
+  <text x="730" y="495" class="value-label">Queue</text>
+  <text x="730" y="510" class="small-label">~1000+</text>
+  
+  <!-- Summary -->
+  <text x="450" y="550" class="subtitle">Performance Summary</text>
+  <text x="220" y="575" class="small-label">🏆 Queue Transport leads in throughput and concurrency</text>
+  <text x="680" y="575" class="small-label">🏆 Basic Transport has lowest latency for simple cases</text>
+</svg>

data/docs/assets/images/redis-basic-architecture.svg

@@ -0,0 +1,53 @@
+<svg width="800" height="300" xmlns="http://www.w3.org/2000/svg" style="background: transparent;">
+  <defs>
+    <style>
+      .title { font: bold 18px sans-serif; fill: #e1e5e9; text-anchor: middle; }
+      .label { font: 14px sans-serif; fill: #c9d1d9; text-anchor: middle; }
+      .small-label { font: 12px sans-serif; fill: #8b949e; text-anchor: middle; }
+      .box { fill: #21262d; stroke: #30363d; stroke-width: 2; rx: 8; }
+      .highlight-box { fill: #0d1117; stroke: #f85149; stroke-width: 2; rx: 8; }
+      .arrow { stroke: #58a6ff; stroke-width: 2; fill: none; marker-end: url(#arrowhead); }
+      .data-flow { stroke: #56d364; stroke-width: 2; fill: none; marker-end: url(#arrowhead-green); }
+    </style>
+    <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#58a6ff" />
+    </marker>
+    <marker id="arrowhead-green" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#56d364" />
+    </marker>
+  </defs>
+  
+  <!-- Title -->
+  <text x="400" y="30" class="title">Redis Basic Transport Architecture</text>
+  
+  <!-- Publisher -->
+  <rect x="50" y="80" width="120" height="60" class="box"/>
+  <text x="110" y="105" class="label">Publisher</text>
+  <text x="110" y="125" class="small-label">OrderMessage</text>
+  
+  <!-- Redis Server -->
+  <rect x="340" y="80" width="120" height="60" class="highlight-box"/>
+  <text x="400" y="100" class="label">Redis Server</text>
+  <text x="400" y="115" class="small-label">Channel:</text>
+  <text x="400" y="130" class="small-label">"OrderMessage"</text>
+  
+  <!-- Subscriber -->
+  <rect x="630" y="80" width="120" height="60" class="box"/>
+  <text x="690" y="105" class="label">Subscriber</text>
+  <text x="690" y="125" class="small-label">Thread-based</text>
+  
+  <!-- Arrows -->
+  <line x1="170" y1="110" x2="340" y2="110" class="arrow"/>
+  <text x="255" y="105" class="small-label">PUBLISH</text>
+  
+  <line x1="460" y1="110" x2="630" y2="110" class="data-flow"/>
+  <text x="545" y="105" class="small-label">SUBSCRIBE</text>
+  
+  <!-- Key Features -->
+  <text x="400" y="180" class="label">Key Characteristics:</text>
+  <text x="400" y="200" class="small-label">• Direct Redis pub/sub channels</text>
+  <text x="400" y="215" class="small-label">• Channel name = Message class name</text>
+  <text x="400" y="230" class="small-label">• No pattern matching or persistence</text>
+  <text x="400" y="245" class="small-label">• Simplest implementation, lowest overhead</text>
+  <text x="400" y="260" class="small-label">• Fire-and-forget messaging</text>
+</svg>

data/docs/assets/images/redis-enhanced-architecture.svg

@@ -0,0 +1,88 @@
+<svg width="900" height="400" xmlns="http://www.w3.org/2000/svg" style="background: transparent;">
+  <defs>
+    <style>
+      .title { font: bold 18px sans-serif; fill: #e1e5e9; text-anchor: middle; }
+      .label { font: 14px sans-serif; fill: #c9d1d9; text-anchor: middle; }
+      .small-label { font: 12px sans-serif; fill: #8b949e; text-anchor: middle; }
+      .box { fill: #21262d; stroke: #30363d; stroke-width: 2; rx: 8; }
+      .highlight-box { fill: #0d1117; stroke: #f85149; stroke-width: 2; rx: 8; }
+      .enhanced-box { fill: #0d1117; stroke: #a5a5ff; stroke-width: 2; rx: 8; }
+      .pattern-box { fill: #161b22; stroke: #ffa657; stroke-width: 2; rx: 6; }
+      .arrow { stroke: #58a6ff; stroke-width: 2; fill: none; marker-end: url(#arrowhead); }
+      .data-flow { stroke: #56d364; stroke-width: 2; fill: none; marker-end: url(#arrowhead-green); }
+      .dual-flow { stroke: #ffa657; stroke-width: 2; fill: none; marker-end: url(#arrowhead-orange); }
+    </style>
+    <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#58a6ff" />
+    </marker>
+    <marker id="arrowhead-green" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#56d364" />
+    </marker>
+    <marker id="arrowhead-orange" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#ffa657" />
+    </marker>
+  </defs>
+  
+  <!-- Title -->
+  <text x="450" y="30" class="title">Redis Enhanced Transport Architecture</text>
+  
+  <!-- Publisher -->
+  <rect x="50" y="80" width="120" height="80" class="box"/>
+  <text x="110" y="105" class="label">Publisher</text>
+  <text x="110" y="125" class="small-label">OrderMessage</text>
+  <text x="110" y="140" class="small-label">from: 'api'</text>
+  <text x="110" y="155" class="small-label">to: 'order-svc'</text>
+  
+  <!-- Enhanced Router -->
+  <rect x="250" y="80" width="140" height="80" class="enhanced-box"/>
+  <text x="320" y="105" class="label">Enhanced Router</text>
+  <text x="320" y="125" class="small-label">3-part naming:</text>
+  <text x="320" y="140" class="small-label">message_type</text>
+  <text x="320" y="155" class="small-label">.from.to</text>
+  
+  <!-- Dual Channels -->
+  <rect x="470" y="50" width="150" height="50" class="highlight-box"/>
+  <text x="545" y="70" class="small-label">Original Channel:</text>
+  <text x="545" y="85" class="small-label">"OrderMessage"</text>
+  
+  <rect x="470" y="120" width="150" height="50" class="enhanced-box"/>
+  <text x="545" y="140" class="small-label">Enhanced Channel:</text>
+  <text x="545" y="155" class="small-label">"ordermessage.api.order_svc"</text>
+  
+  <!-- Pattern Matcher -->
+  <rect x="700" y="80" width="150" height="80" class="pattern-box"/>
+  <text x="775" y="105" class="label">Pattern Matcher</text>
+  <text x="775" y="125" class="small-label">Wildcards:</text>
+  <text x="775" y="140" class="small-label">• ordermessage.*.*</text>
+  <text x="775" y="155" class="small-label">• *.api.*</text>
+  
+  <!-- Arrows -->
+  <line x1="170" y1="120" x2="250" y2="120" class="arrow"/>
+  
+  <!-- Dual publishing arrows -->
+  <line x1="390" y1="100" x2="470" y2="75" class="dual-flow"/>
+  <line x1="390" y1="140" x2="470" y2="145" class="dual-flow"/>
+  
+  <!-- To pattern matcher -->
+  <line x1="620" y1="145" x2="700" y2="130" class="data-flow"/>
+  
+  <!-- Fluent API Example -->
+  <rect x="50" y="200" width="800" height="120" class="pattern-box"/>
+  <text x="450" y="225" class="label">Enhanced Features</text>
+  
+  <text x="150" y="250" class="small-label">Pattern Subscriptions:</text>
+  <text x="150" y="265" class="small-label">transport.subscribe_pattern("*.api.*")</text>
+  <text x="150" y="280" class="small-label">transport.subscribe_to_alerts()</text>
+  
+  <text x="450" y="250" class="small-label">Fluent API:</text>
+  <text x="450" y="265" class="small-label">transport.where.from('api')</text>
+  <text x="450" y="280" class="small-label">  .to('order-svc').subscribe</text>
+  
+  <text x="700" y="250" class="small-label">Backwards Compatible:</text>
+  <text x="700" y="265" class="small-label">• Publishes to both channels</text>
+  <text x="700" y="280" class="small-label">• Basic Redis can still subscribe</text>
+  
+  <!-- Key Benefits -->
+  <text x="450" y="350" class="label">Key Benefits: RabbitMQ-style routing + Redis performance + Backwards compatibility</text>
+  <text x="450" y="370" class="small-label">Perfect for microservices requiring intelligent routing without message persistence</text>
+</svg>