smart_message 0.0.10 → 0.0.12

data/examples/redis/README.md

@@ -0,0 +1,230 @@
+# Redis Transport Examples
+
+This directory contains demonstration programs that use SmartMessage's **Redis Transport** for distributed messaging. These examples show how to build scalable, multi-process applications using Redis pub/sub messaging.
+
+## Transport Overview
+
+The Redis Transport is ideal for:
+- **Distributed applications** across multiple processes/servers
+- **Real-time messaging** with Redis pub/sub
+- **Scalable architectures** with horizontal scaling
+- **Cross-service communication** in microservices
+- **Event-driven systems** with reliable message delivery
+
+Redis Transport uses Redis's publish/subscribe mechanism, where each message class gets its own Redis channel for efficient routing.
+
+## Prerequisites
+
+Before running these examples:
+
+1. **Install Redis:**
+   ```bash
+   # macOS
+   brew install redis
+   
+   # Ubuntu/Debian  
+   sudo apt install redis-server
+   
+   # CentOS/RHEL
+   sudo yum install redis
+   ```
+
+2. **Start Redis server:**
+   ```bash
+   redis-server
+   # Runs on localhost:6379 by default
+   ```
+
+3. **Install Redis gem:**
+   ```bash
+   gem install redis
+   ```
+
+## Example Programs
+
+### 🏠 01_smart_home_iot_demo.rb
+**Demonstrates:** IoT device communication via Redis pub/sub
+**Use Case:** Smart home automation system
+**Key Features:**
+- **Multiple device types**: Sensors, controllers, and dashboards
+- **Real-time data streaming**: Temperature, security, and energy data
+- **Automatic fallback**: Uses memory transport if Redis unavailable
+- **Channel separation**: Each message type gets dedicated Redis channel
+- **Concurrent processing**: Multiple devices publishing simultaneously
+
+**Message Types:**
+- `SensorDataMessage` → `SensorDataMessage` channel
+- `DeviceCommandMessage` → `DeviceCommandMessage` channel  
+- `SecurityAlertMessage` → `SecurityAlertMessage` channel
+- `SystemStatusMessage` → `SystemStatusMessage` channel
+
+**Architecture:**
+```
+┌─────────────┐    Redis Pub/Sub    ┌─────────────┐
+│   Sensors   │ ──────────────────► │ Controllers │
+│ (Publishers)│                     │(Subscribers)│
+└─────────────┘                     └─────────────┘
+       │                                   │
+       ▼                                   ▼
+┌─────────────────────────────────────────────────┐
+│              Redis Server                       │
+│  Channels: SensorDataMessage,                   │
+│           DeviceCommandMessage, etc.            │
+└─────────────────────────────────────────────────┘
+       ▲                                   ▲
+       │                                   │
+┌─────────────┐                     ┌─────────────┐
+│  Dashboard  │                     │   Alerts    │
+│(Subscriber) │                     │(Subscriber) │
+└─────────────┘                     └─────────────┘
+```
+
+**Running the Demo:**
+```bash
+cd examples/redis
+ruby 01_smart_home_iot_demo.rb
+```
+
+**What You'll See:**
+1. Device initialization and Redis connection
+2. Real-time sensor data publishing
+3. Automated device commands and responses
+4. Security monitoring and alerts
+5. System health reporting
+
+**Redis Commands to Monitor:**
+```bash
+# Watch active channels
+redis-cli PUBSUB CHANNELS
+
+# Monitor all pub/sub activity
+redis-cli MONITOR
+
+# Subscribe to specific message type
+redis-cli SUBSCRIBE SensorDataMessage
+```
+
+## Key Concepts Demonstrated
+
+### 1. **Distributed Messaging**
+- Messages published in one process are received by subscribers in other processes
+- True distributed communication across multiple Ruby instances
+
+### 2. **Channel-Based Routing** 
+- Each SmartMessage class automatically gets its own Redis channel
+- Clean separation of message types for efficient filtering
+
+### 3. **Automatic Scaling**
+- Multiple subscribers can listen to the same channel
+- Publishers and subscribers can be added/removed dynamically
+
+### 4. **Real-Time Communication**
+- Near-instantaneous message delivery via Redis pub/sub
+- Perfect for time-sensitive applications like IoT monitoring
+
+### 5. **Connection Management**
+- Automatic Redis connection handling
+- Graceful fallback to memory transport when Redis unavailable
+
+## Redis Transport Configuration
+
+Basic Redis transport setup:
+```ruby
+SmartMessage.configure do |config|
+  config.transport = SmartMessage::Transport.create(:redis,
+    url: 'redis://localhost:6379',
+    db: 1  # Optional: use specific Redis database
+  )
+  config.serializer = SmartMessage::Serializer::Json.new
+end
+```
+
+Per-message class configuration:
+```ruby
+class MyMessage < SmartMessage::Base
+  config do
+    transport SmartMessage::Transport.create(:redis,
+      url: 'redis://localhost:6379',
+      db: 2
+    )
+    serializer SmartMessage::Serializer::Json.new
+  end
+end
+```
+
+## Architecture Benefits
+
+### **Scalability**
+- Horizontal scaling by adding more publishers/subscribers
+- Redis handles connection pooling and load distribution
+
+### **Reliability** 
+- Redis provides persistent connections and automatic reconnection
+- Message delivery confirmation through Redis pub/sub protocol
+
+### **Performance**
+- Redis is optimized for high-throughput messaging
+- In-memory storage for minimal latency
+
+### **Flexibility**
+- Easy to add new message types (new channels)
+- Subscribers can filter by message patterns
+
+## Production Considerations
+
+### **Redis Configuration**
+```bash
+# Recommended Redis settings for production
+maxmemory-policy allkeys-lru
+timeout 0
+tcp-keepalive 60
+maxclients 10000
+```
+
+### **Connection Pooling**
+```ruby
+# Use connection pooling for high-load applications
+SmartMessage::Transport.create(:redis,
+  url: 'redis://localhost:6379',
+  pool: { size: 20, timeout: 5 }
+)
+```
+
+### **Monitoring and Debugging**
+```bash
+# Monitor Redis performance
+redis-cli INFO stats
+redis-cli MONITOR | grep PUBLISH
+redis-cli CLIENT LIST
+```
+
+## Testing Distributed Scenarios
+
+Run multiple terminal sessions to test distributed messaging:
+
+**Terminal 1 (Publisher):**
+```ruby
+# Create a publisher-only script
+sensor = SmartHomeSensor.new('living-room')
+loop do
+  sensor.publish_temperature_reading
+  sleep(2)
+end
+```
+
+**Terminal 2 (Subscriber):**
+```ruby
+# Create a subscriber-only script
+SensorDataMessage.subscribe
+# Keep process alive to receive messages
+sleep
+```
+
+## Next Steps
+
+After mastering Redis Transport:
+- **[Redis Queue Examples](../redis_queue/)** - For guaranteed message delivery
+- **[Redis Enhanced Examples](../redis_enhanced/)** - For advanced Redis patterns
+- **[Memory Examples](../memory/)** - For development and testing
+
+The Redis transport provides the foundation for building production-ready, distributed SmartMessage applications.

data/examples/redis/alert_system_flow.svg

@@ -0,0 +1,127 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="800" height="600" viewBox="0 0 800 600" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <style>
+      .bg { fill: transparent; }
+      .trigger-group { fill: #2a1a1a; stroke: #ff4a4a; stroke-width: 2; rx: 8; }
+      .device-group { fill: #1a2a1a; stroke: #4aff4a; stroke-width: 2; rx: 8; }
+      .alert-group { fill: #1a1a2a; stroke: #4a9eff; stroke-width: 2; rx: 8; }
+      .dashboard-final { fill: #2a2a1a; stroke: #aa4aff; stroke-width: 2; rx: 8; }
+      .trigger { fill: #4a2a1a; stroke: #ffaa4a; stroke-width: 1; rx: 4; }
+      .device { fill: #2a3a2a; stroke: #4aff4a; stroke-width: 1; rx: 4; }
+      .alert { fill: #2a2a3a; stroke: #4a9eff; stroke-width: 1; rx: 4; }
+      .flow { stroke: #ffaa4a; stroke-width: 2; fill: none; marker-end: url(#arrowhead); }
+      .alert-flow { stroke: #4a9eff; stroke-width: 2; fill: none; marker-end: url(#arrowhead-blue); }
+      .dashboard-flow { stroke: #aa4aff; stroke-width: 3; fill: none; marker-end: url(#arrowhead-purple); }
+      .text { fill: #ffffff; font-family: 'Arial', sans-serif; font-size: 11px; }
+      .title { fill: #4a9eff; font-family: 'Arial', sans-serif; font-size: 18px; font-weight: bold; }
+      .subtitle { fill: #ffaa4a; font-family: 'Arial', sans-serif; font-size: 12px; }
+      .group-title { fill: #ffffff; font-family: 'Arial', sans-serif; font-size: 13px; font-weight: bold; }
+    </style>
+    <marker id="arrowhead" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#ffaa4a" />
+    </marker>
+    <marker id="arrowhead-blue" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#4a9eff" />
+    </marker>
+    <marker id="arrowhead-purple" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#aa4aff" />
+    </marker>
+  </defs>
+  
+  <!-- Background -->
+  <rect class="bg" width="800" height="600"/>
+  
+  <!-- Title -->
+  <text x="400" y="25" text-anchor="middle" class="title">Alert System Flow</text>
+  <text x="400" y="45" text-anchor="middle" class="subtitle">IoT Device Alert Generation and Processing</text>
+  
+  <!-- Triggers Group -->
+  <rect x="50" y="80" width="200" height="180" class="trigger-group"/>
+  <text x="150" y="105" text-anchor="middle" class="group-title">Alert Triggers</text>
+  
+  <rect x="70" y="120" width="160" height="30" class="trigger"/>
+  <text x="150" y="140" text-anchor="middle" class="text">High Temperature &gt; 28°C</text>
+  
+  <rect x="70" y="160" width="160" height="30" class="trigger"/>
+  <text x="150" y="180" text-anchor="middle" class="text">Motion Detected</text>
+  
+  <rect x="70" y="200" width="160" height="30" class="trigger"/>
+  <text x="150" y="220" text-anchor="middle" class="text">Battery &lt; 20%</text>
+  
+  <rect x="70" y="240" width="160" height="30" class="trigger"/>
+  <text x="150" y="260" text-anchor="middle" class="text">Device Offline &gt; 30s</text>
+  
+  <!-- Devices Group -->
+  <rect x="300" y="80" width="200" height="180" class="device-group"/>
+  <text x="400" y="105" text-anchor="middle" class="group-title">IoT Devices</text>
+  
+  <rect x="320" y="120" width="160" height="30" class="device"/>
+  <text x="400" y="140" text-anchor="middle" class="text">🌡️ Thermostat</text>
+  
+  <rect x="320" y="160" width="160" height="30" class="device"/>
+  <text x="400" y="180" text-anchor="middle" class="text">📹 Camera</text>
+  
+  <rect x="320" y="200" width="160" height="30" class="device"/>
+  <text x="400" y="220" text-anchor="middle" class="text">🚪 Door Lock</text>
+  
+  <!-- Alert Channel Group -->
+  <rect x="550" y="80" width="200" height="180" class="alert-group"/>
+  <text x="650" y="105" text-anchor="middle" class="group-title">AlertMessage Channel</text>
+  
+  <rect x="570" y="120" width="160" height="30" class="alert"/>
+  <text x="650" y="140" text-anchor="middle" class="text">Motion Alert</text>
+  
+  <rect x="570" y="160" width="160" height="30" class="alert"/>
+  <text x="650" y="180" text-anchor="middle" class="text">High Temp Alert</text>
+  
+  <rect x="570" y="200" width="160" height="30" class="alert"/>
+  <text x="650" y="220" text-anchor="middle" class="text">Battery Low Alert</text>
+  
+  <rect x="570" y="240" width="160" height="30" class="alert"/>
+  <text x="650" y="260" text-anchor="middle" class="text">Device Offline Alert</text>
+  
+  <!-- Dashboard -->
+  <rect x="300" y="320" width="200" height="60" class="dashboard-final"/>
+  <text x="400" y="345" text-anchor="middle" class="group-title">📊 Dashboard</text>
+  <text x="400" y="365" text-anchor="middle" class="text">Alert Processing &amp; Display</text>
+  
+  <!-- Flow arrows -->
+  <!-- Triggers to Devices -->
+  <path d="M 230 135 L 320 135" class="flow"/>
+  <path d="M 230 175 L 320 175" class="flow"/>
+  <path d="M 230 215 L 320 215" class="flow"/>
+  <path d="M 230 255 L 320 255" class="flow"/>
+  
+  <!-- Devices to Alert Channel -->
+  <path d="M 480 135 L 570 175" class="alert-flow"/>
+  <path d="M 480 175 L 570 135" class="alert-flow"/>
+  <path d="M 480 215 L 570 215" class="alert-flow"/>
+  <path d="M 480 255 L 570 255" class="alert-flow"/>
+  
+  <!-- Alert Channel to Dashboard -->
+  <path d="M 650 280 L 450 320" class="dashboard-flow"/>
+  
+  <!-- Alert Processing Details -->
+  <rect x="50" y="420" width="700" height="160" fill="#1a1a1a" stroke="#4a9eff" rx="8"/>
+  <text x="70" y="445" class="title">Alert Processing Logic</text>
+  
+  <text x="70" y="470" class="text">🌡️ Temperature Alerts:</text>
+  <text x="90" y="485" class="subtitle">• Thermostat monitors temperature every 3 seconds</text>
+  <text x="90" y="500" class="subtitle">• Alert triggered when temperature > 28°C for HVAC efficiency</text>
+  
+  <text x="400" y="470" class="text">📹 Motion Alerts:</text>
+  <text x="420" y="485" class="subtitle">• Camera detects motion using built-in sensors</text>
+  <text x="420" y="500" class="subtitle">• Immediate alert published to AlertMessage channel</text>
+  
+  <text x="70" y="525" class="text">🔋 Battery Alerts:</text>
+  <text x="90" y="540" class="subtitle">• All devices report battery level with sensor data</text>
+  <text x="90" y="555" class="subtitle">• Critical alert when battery drops below 20%</text>
+  
+  <text x="400" y="525" class="text">⚠️ Offline Alerts:</text>
+  <text x="420" y="540" class="subtitle">• Dashboard tracks last seen timestamp for each device</text>
+  <text x="420" y="555" class="subtitle">• Alert generated if device silent for more than 30 seconds</text>
+</svg>

data/examples/redis/dashboard_status_flow.svg

@@ -0,0 +1,107 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="800" height="500" viewBox="0 0 800 500" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <style>
+      .bg { fill: transparent; }
+      .data-group { fill: #1a2a1a; stroke: #4aff4a; stroke-width: 2; rx: 8; }
+      .process-group { fill: #2a1a2a; stroke: #aa4aff; stroke-width: 2; rx: 8; }
+      .output-group { fill: #2a2a1a; stroke: #ffaa4a; stroke-width: 2; rx: 8; }
+      .component { fill: #3a3a3a; stroke: #ffffff; stroke-width: 1; rx: 4; }
+      .flow { stroke: #4aff4a; stroke-width: 2; fill: none; marker-end: url(#arrowhead-green); }
+      .process-flow { stroke: #aa4aff; stroke-width: 2; fill: none; marker-end: url(#arrowhead-purple); }
+      .output-flow { stroke: #ffaa4a; stroke-width: 3; fill: none; marker-end: url(#arrowhead-orange); }
+      .text { fill: #ffffff; font-family: 'Arial', sans-serif; font-size: 11px; }
+      .title { fill: #4a9eff; font-family: 'Arial', sans-serif; font-size: 18px; font-weight: bold; }
+      .subtitle { fill: #ffaa4a; font-family: 'Arial', sans-serif; font-size: 12px; }
+      .group-title { fill: #ffffff; font-family: 'Arial', sans-serif; font-size: 13px; font-weight: bold; }
+    </style>
+    <marker id="arrowhead-green" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#4aff4a" />
+    </marker>
+    <marker id="arrowhead-purple" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#aa4aff" />
+    </marker>
+    <marker id="arrowhead-orange" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#ffaa4a" />
+    </marker>
+  </defs>
+  
+  <!-- Background -->
+  <rect class="bg" width="800" height="500"/>
+  
+  <!-- Title -->
+  <text x="400" y="25" text-anchor="middle" class="title">Dashboard Status Flow</text>
+  <text x="400" y="45" text-anchor="middle" class="subtitle">System Status Aggregation and Periodic Reporting</text>
+  
+  <!-- Data Collection Group -->
+  <rect x="50" y="80" width="200" height="180" class="data-group"/>
+  <text x="150" y="105" text-anchor="middle" class="group-title">Data Collection</text>
+  
+  <rect x="70" y="120" width="160" height="30" class="component"/>
+  <text x="150" y="140" text-anchor="middle" class="text">Device Last Seen Times</text>
+  
+  <rect x="70" y="160" width="160" height="30" class="component"/>
+  <text x="150" y="180" text-anchor="middle" class="text">Alert Counts</text>
+  
+  <rect x="70" y="200" width="160" height="30" class="component"/>
+  <text x="150" y="220" text-anchor="middle" class="text">Battery Levels</text>
+  
+  <rect x="70" y="240" width="160" height="30" class="component"/>
+  <text x="150" y="260" text-anchor="middle" class="text">System Health</text>
+  
+  <!-- Status Processing Group -->
+  <rect x="300" y="80" width="200" height="180" class="process-group"/>
+  <text x="400" y="105" text-anchor="middle" class="group-title">Status Processing</text>
+  
+  <rect x="320" y="120" width="160" height="40" class="component"/>
+  <text x="400" y="140" text-anchor="middle" class="text">Count Active Devices</text>
+  <text x="400" y="155" text-anchor="middle" class="text">last_seen &lt; 30s</text>
+  
+  <rect x="320" y="170" width="160" height="40" class="component"/>
+  <text x="400" y="190" text-anchor="middle" class="text">Count Recent Alerts</text>
+  <text x="400" y="205" text-anchor="middle" class="text">last 5 minutes</text>
+  
+  <rect x="320" y="220" width="160" height="30" class="component"/>
+  <text x="400" y="240" text-anchor="middle" class="text">Calculate Averages</text>
+  
+  <!-- Status Output Group -->
+  <rect x="550" y="80" width="200" height="180" class="output-group"/>
+  <text x="650" y="105" text-anchor="middle" class="group-title">Status Output</text>
+  
+  <rect x="570" y="140" width="160" height="60" class="component"/>
+  <text x="650" y="165" text-anchor="middle" class="text">DashboardStatusMessage</text>
+  <text x="650" y="185" text-anchor="middle" class="text">Every 10 seconds</text>
+  
+  <!-- Flow arrows -->
+  <path d="M 250 150 L 300 140" class="flow"/>
+  <path d="M 250 180 L 300 190" class="flow"/>
+  <path d="M 250 210 L 300 235" class="flow"/>
+  <path d="M 250 240 L 300 235" class="flow"/>
+  
+  <path d="M 500 140 L 550 170" class="process-flow"/>
+  <path d="M 500 190 L 550 170" class="process-flow"/>
+  <path d="M 500 235 L 550 170" class="process-flow"/>
+  
+  <!-- Status Message Details -->
+  <rect x="50" y="300" width="700" height="180" fill="#1a1a1a" stroke="#4a9eff" rx="8"/>
+  <text x="70" y="325" class="title">Dashboard Status Message Content</text>
+  
+  <text x="70" y="350" class="text">📊 System Metrics (Updated every 10 seconds):</text>
+  <text x="90" y="365" class="subtitle">• Active device count: Devices that have reported within last 30 seconds</text>
+  <text x="90" y="380" class="subtitle">• Total alert count: Alerts generated in the last 5 minutes</text>
+  <text x="90" y="395" class="subtitle">• Average battery level: Calculated across all battery-powered devices</text>
+  <text x="90" y="410" class="subtitle">• System health score: Composite metric based on device availability</text>
+  
+  <text x="400" y="350" class="text">🔄 Processing Logic:</text>
+  <text x="420" y="365" class="subtitle">• Device activity tracking: Timestamp comparison for online status</text>
+  <text x="420" y="380" class="subtitle">• Alert aggregation: Count and categorize alerts by severity</text>
+  <text x="420" y="395" class="subtitle">• Performance calculation: Battery levels, response times, error rates</text>
+  <text x="420" y="410" class="subtitle">• Status publication: Broadcast to all subscribers for system visibility</text>
+  
+  <text x="70" y="440" class="text">📈 Status Message Format:</text>
+  <text x="90" y="455" class="subtitle">• device_count: 3, alert_count: 2, avg_battery: 78.5%, health_score: "good"</text>
+  <text x="90" y="470" class="subtitle">• Subscribers: Mobile apps, monitoring systems, other dashboards</text>
+</svg>

data/examples/redis/device_command_flow.svg

@@ -0,0 +1,113 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="800" height="500" viewBox="0 0 800 500" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <style>
+      .bg { fill: transparent; }
+      .app { fill: #2a1a3a; stroke: #aa4aff; stroke-width: 2; rx: 8; }
+      .redis { fill: #3a1a1a; stroke: #ff4a4a; stroke-width: 2; rx: 8; }
+      .thermostat { fill: #4a2a1a; stroke: #ff6b6b; stroke-width: 2; rx: 8; }
+      .camera { fill: #1a3a3a; stroke: #4ecdc4; stroke-width: 2; rx: 8; }
+      .lock { fill: #3a3a1a; stroke: #ffe66d; stroke-width: 2; rx: 8; }
+      .command { stroke: #aa4aff; stroke-width: 3; fill: none; marker-end: url(#arrowhead); }
+      .process { stroke: #4aff4a; stroke-width: 2; fill: none; marker-end: url(#arrowhead-green); }
+      .ignore { stroke: #ff4a4a; stroke-width: 2; fill: none; stroke-dasharray: 5,5; }
+      .text { fill: #ffffff; font-family: 'Arial', sans-serif; font-size: 12px; }
+      .title { fill: #4a9eff; font-family: 'Arial', sans-serif; font-size: 18px; font-weight: bold; }
+      .subtitle { fill: #ffaa4a; font-family: 'Arial', sans-serif; font-size: 11px; }
+      .note { fill: #aaaaaa; font-family: 'Arial', sans-serif; font-size: 10px; }
+    </style>
+    <marker id="arrowhead" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#aa4aff" />
+    </marker>
+    <marker id="arrowhead-green" markerWidth="8" markerHeight="6" 
+            refX="8" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#4aff4a" />
+    </marker>
+  </defs>
+  
+  <!-- Background -->
+  <rect class="bg" width="800" height="500"/>
+  
+  <!-- Title -->
+  <text x="400" y="25" text-anchor="middle" class="title">Device Command Flow</text>
+  <text x="400" y="45" text-anchor="middle" class="subtitle">Device-Specific Command Routing via Redis Channel</text>
+  
+  <!-- Participants -->
+  <rect x="50" y="80" width="120" height="60" class="app"/>
+  <text x="110" y="105" text-anchor="middle" class="text">📱 Mobile App</text>
+  <text x="110" y="125" text-anchor="middle" class="subtitle">User Interface</text>
+  
+  <rect x="320" y="80" width="120" height="60" class="redis"/>
+  <text x="380" y="105" text-anchor="middle" class="text">Redis Channel</text>
+  <text x="380" y="125" text-anchor="middle" class="subtitle">DeviceCommandMessage</text>
+  
+  <rect x="580" y="50" width="120" height="60" class="thermostat"/>
+  <text x="640" y="75" text-anchor="middle" class="text">🌡️ Thermostat</text>
+  <text x="640" y="95" text-anchor="middle" class="subtitle">THERM-001</text>
+  
+  <rect x="580" y="130" width="120" height="60" class="camera"/>
+  <text x="640" y="155" text-anchor="middle" class="text">📹 Camera</text>
+  <text x="640" y="175" text-anchor="middle" class="subtitle">CAM-001</text>
+  
+  <rect x="580" y="210" width="120" height="60" class="lock"/>
+  <text x="640" y="235" text-anchor="middle" class="text">🚪 Door Lock</text>
+  <text x="640" y="255" text-anchor="middle" class="subtitle">LOCK-001</text>
+  
+  <!-- Vertical lifelines -->
+  <line x1="110" y1="140" x2="110" y2="400" stroke="#666" stroke-width="2" stroke-dasharray="3,3"/>
+  <line x1="380" y1="140" x2="380" y2="400" stroke="#666" stroke-width="2" stroke-dasharray="3,3"/>
+  <line x1="640" y1="110" x2="640" y2="400" stroke="#666" stroke-width="2" stroke-dasharray="3,3"/>
+  <line x1="640" y1="190" x2="640" y2="400" stroke="#666" stroke-width="2" stroke-dasharray="3,3"/>
+  <line x1="640" y1="270" x2="640" y2="400" stroke="#666" stroke-width="2" stroke-dasharray="3,3"/>
+  
+  <!-- Command 1: Thermostat Command -->
+  <path d="M 110 170 L 380 170" class="command"/>
+  <text x="245" y="165" text-anchor="middle" class="text">DeviceCommandMessage</text>
+  <text x="245" y="185" text-anchor="middle" class="note">device_id: THERM-001, command: set_temperature</text>
+  
+  <!-- Routing to devices -->
+  <path d="M 380 190 L 580 80" class="process"/>
+  <text x="480" y="135" text-anchor="middle" class="text">✅ Processes THERM prefix match</text>
+  
+  <path d="M 380 190 L 580 160" class="ignore"/>
+  <text x="480" y="175" text-anchor="middle" class="text">❌ Ignores not CAM prefix</text>
+  
+  <path d="M 380 190 L 580 240" class="ignore"/>
+  <text x="480" y="215" text-anchor="middle" class="text">❌ Ignores not LOCK prefix</text>
+  
+  <!-- Command 2: Camera Command -->
+  <path d="M 110 280 L 380 280" class="command"/>
+  <text x="245" y="275" text-anchor="middle" class="text">DeviceCommandMessage</text>
+  <text x="245" y="295" text-anchor="middle" class="note">device_id: CAM-001, command: start_recording</text>
+  
+  <!-- Routing to devices for command 2 -->
+  <path d="M 380 300 L 580 80" class="ignore"/>
+  <text x="480" y="285" text-anchor="middle" class="text">❌ Ignores not THERM prefix</text>
+  
+  <path d="M 380 300 L 580 160" class="process"/>
+  <text x="480" y="305" text-anchor="middle" class="text">✅ Processes CAM prefix match</text>
+  
+  <path d="M 380 300 L 580 240" class="ignore"/>
+  <text x="480" y="325" text-anchor="middle" class="text">❌ Ignores not LOCK prefix</text>
+  
+  <!-- Device Command Filtering Rules -->
+  <rect x="50" y="320" width="700" height="160" fill="#1a1a1a" stroke="#4a9eff" rx="8"/>
+  <text x="70" y="345" class="title">Device Command Filtering Rules</text>
+  
+  <text x="70" y="370" class="text">🌡️ THERM-* devices:</text>
+  <text x="90" y="385" class="subtitle">• Accept: set_temperature, get_status</text>
+  <text x="90" y="400" class="subtitle">• Filter: Only process commands with device_id starting with "THERM-"</text>
+  
+  <text x="400" y="370" class="text">📹 CAM-* devices:</text>
+  <text x="420" y="385" class="subtitle">• Accept: start_recording, stop_recording, get_status</text>
+  <text x="420" y="400" class="subtitle">• Filter: Only process commands with device_id starting with "CAM-"</text>
+  
+  <text x="70" y="425" class="text">🚪 LOCK-* devices:</text>
+  <text x="90" y="440" class="subtitle">• Accept: lock, unlock, get_status</text>
+  <text x="90" y="455" class="subtitle">• Filter: Only process commands with device_id starting with "LOCK-"</text>
+  
+  <text x="400" y="425" class="text">📊 Architecture Benefits:</text>
+  <text x="420" y="440" class="subtitle">• Efficient: Devices ignore irrelevant commands automatically</text>
+  <text x="420" y="455" class="subtitle">• Scalable: Easy to add new device types with new prefixes</text>
+</svg>