bunny_farm 0.1.2

data/examples/README.md

@@ -0,0 +1,212 @@
+# BunnyFarm Examples
+
+This directory contains practical examples demonstrating how to use the BunnyFarm library for background job processing with RabbitMQ.
+
+![BunnyFarm Message Flow](images/message_flow.svg)
+
+## Prerequisites
+
+1. **Install RabbitMQ**: Make sure RabbitMQ server is running on your system
+   ```bash
+   # macOS with Homebrew
+   brew install rabbitmq
+   brew services start rabbitmq
+   
+   # Ubuntu/Debian
+   sudo apt-get install rabbitmq-server
+   sudo systemctl start rabbitmq-server
+   
+   # Or use Docker
+   docker run -d --name rabbitmq -p 5672:5672 -p 15672:15672 rabbitmq:3-management
+   ```
+
+2. **Install dependencies**: From the gem root directory:
+   ```bash
+   bundle install
+   ```
+
+## Examples Overview
+
+### 1. Simple Producer/Consumer Pattern
+
+![Producer Consumer Pattern](images/producer_consumer.svg)
+
+**Files**: `simple_message.rb`, `producer.rb`, `consumer.rb`
+
+The simplest example showing basic message production and consumption.
+
+**Run the example**:
+```bash
+# Terminal 1 - Start the consumer
+cd examples
+ruby consumer.rb
+
+# Terminal 2 - Run the producer
+ruby producer.rb
+```
+
+**What it demonstrates**:
+- Basic message class definition with `fields` and `actions`
+- Simple message publishing
+- Consumer setup and message processing
+- Success/failure handling
+
+### 2. Order Processing Workflow
+
+![Order Workflow](images/order_workflow.svg)
+
+**File**: `order_processor.rb`
+
+A more complex example showing a multi-step order processing workflow with error handling.
+
+**Run the example**:
+```bash
+# Terminal 1 - Start the consumer
+ruby order_processor.rb --consumer
+
+# Terminal 2 - Send orders for processing
+ruby order_processor.rb --producer
+```
+
+**What it demonstrates**:
+- Complex message fields with nested data structures
+- Multi-action workflows (validate → process_payment → ship)
+- Error handling and workflow branching
+- Message chaining (publishing follow-up messages)
+- Random failure simulation for testing
+
+### 3. Task Scheduler with Retries
+
+![Task Scheduler](images/task_scheduler.svg)
+
+**File**: `task_scheduler.rb`
+
+Demonstrates scheduled task execution with retry logic and failure handling.
+
+**Run the example**:
+```bash
+# Terminal 1 - Start the worker
+ruby task_scheduler.rb --worker
+
+# Terminal 2 - Schedule tasks
+ruby task_scheduler.rb --scheduler
+```
+
+**What it demonstrates**:
+- Time-based task scheduling
+- Retry mechanisms with exponential backoff
+- Multiple task types in one message class
+- Error recovery and failure reporting
+- Different execution paths based on task type
+
+## Understanding the Code Structure
+
+### Message Class Pattern
+
+All examples follow the same basic pattern for message classes:
+
+```ruby
+class MyMessage < BunnyFarm::Message
+  # Define expected fields (can include nested structures)
+  fields :field1, :field2, { nested: [:sub1, :sub2] }
+  
+  # Define available actions
+  actions :action1, :action2
+  
+  # Implement action methods
+  def action1(*args)
+    # Process the message
+    # Use @items[:field_name] to access data
+    
+    # Mark as successful
+    success!
+    
+    # Or mark as failed
+    # failure("Error message")
+  end
+end
+```
+
+### Configuration
+
+All examples use the default configuration from `config/bunny.yml.erb`. You can customize by:
+
+1. **Environment variables**:
+   ```bash
+   export AMQP_HOST=localhost
+   export AMQP_VHOST=/
+   export AMQP_QUEUE=my_queue
+   # ... etc
+   ```
+
+2. **Programmatic configuration**:
+   ```ruby
+   BunnyFarm.config do
+     env 'production'
+     app_id 'my_worker'
+     # Custom routing key for consumers
+     bunny CONFIG.bunny.merge('routing_key' => 'MyMessage.*')
+   end
+   ```
+
+## Running with Custom RabbitMQ Settings
+
+If your RabbitMQ is running on a different host or with different credentials:
+
+```bash
+export AMQP_HOST=192.168.1.100
+export AMQP_USER=myuser
+export AMQP_PASS=mypassword
+export AMQP_VHOST=myvhost
+
+ruby consumer.rb
+```
+
+## Message Flow
+
+Here's how messages flow through the system:
+
+1. **Producer** creates a message instance
+2. **Producer** populates message fields with `msg[:field] = value`
+3. **Producer** calls `msg.publish('action_name')`
+4. **RabbitMQ** receives the message with routing key `MessageClassName.action_name`
+5. **Consumer** receives the message based on its routing key configuration
+6. **Consumer** instantiates the message class with the JSON payload
+7. **Consumer** automatically calls the appropriate action method
+8. **Action method** processes the message and marks success/failure
+9. **RabbitMQ** acknowledges or rejects the message based on the result
+
+## Troubleshooting
+
+### Connection Issues
+- Make sure RabbitMQ is running: `sudo systemctl status rabbitmq-server`
+- Check if the management interface is accessible: http://localhost:15672 (guest/guest)
+- Verify network connectivity if using a remote RabbitMQ server
+
+### No Messages Being Processed
+- Check that producer and consumer are using compatible routing keys
+- Verify queue and exchange names match between producer and consumer
+- Look for error messages in the console output
+
+### Messages Not Being Acknowledged
+- Ensure action methods call `success!` on successful completion
+- Check for exceptions that might prevent success marking
+- Look for `failure(message)` calls that reject messages
+
+## Next Steps
+
+After running these examples:
+
+1. **Modify the examples** to understand how changes affect behavior
+2. **Create your own message classes** for your specific use cases
+3. **Experiment with different routing patterns** and queue configurations
+4. **Add monitoring and logging** for production use
+5. **Consider scaling patterns** like multiple consumers or load balancing
+
+## Additional Resources
+
+- [RabbitMQ Documentation](https://www.rabbitmq.com/documentation.html)
+- [AMQP Concepts](https://www.rabbitmq.com/tutorials/amqp-concepts.html)
+- [Bunny Gem Documentation](https://github.com/ruby-amqp/bunny)
+
+Happy message processing! 🐰

data/examples/consumer.rb

@@ -0,0 +1,41 @@
+#!/usr/bin/env ruby
+# Consumer example - processes messages from RabbitMQ
+
+require 'bundler/setup'
+require 'bunny_farm'
+require_relative 'simple_message'
+
+# Configure BunnyFarm
+BunnyFarm.config do
+  env 'development'
+  app_id 'greeting_consumer'
+  # Set routing key to match all GreetingMessage actions
+  bunny Hashie::Mash.new(
+    YAML.load(
+      ERB.new(
+        File.read(
+          File.join(BunnyFarm::CONFIG.config_dir, BunnyFarm::CONFIG.bunny_file)
+        )
+      ).result, aliases: true
+    )[BunnyFarm::CONFIG.env].merge(
+      'routing_key' => 'GreetingMessage.*'
+    )
+  )
+end
+
+puts "BunnyFarm Consumer Example"
+puts "=" * 40
+puts "Waiting for messages from RabbitMQ..."
+puts "Queue: #{BunnyFarm::CONFIG.bunny.queue_name}"
+puts "Exchange: #{BunnyFarm::CONFIG.bunny.exchange_name}"
+puts "Routing Key: #{BunnyFarm::CONFIG.bunny.routing_key}"
+puts "=" * 40
+puts "Press Ctrl+C to exit"
+puts
+
+# Start consuming messages (this will block)
+begin
+  BunnyFarm.manage(false)  # false = run in foreground (blocking)
+rescue Interrupt
+  puts "\n\nShutting down consumer..."
+end

data/examples/images/message_flow.svg

@@ -0,0 +1,87 @@
+<svg width="800" height="400" xmlns="http://www.w3.org/2000/svg">
+  <!-- Background transparent -->
+  <rect width="800" height="400" fill="transparent"/>
+  
+  <!-- Title -->
+  <text x="400" y="30" text-anchor="middle" font-family="Arial, sans-serif" font-size="20" font-weight="bold" fill="#e0e0e0">
+    BunnyFarm Message Flow
+  </text>
+  
+  <!-- Producer -->
+  <g>
+    <rect x="50" y="80" width="120" height="80" rx="10" fill="#2d3748" stroke="#4a5568" stroke-width="2"/>
+    <text x="110" y="110" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="#e0e0e0">Producer</text>
+    <text x="110" y="130" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" fill="#cbd5e0">Ruby App</text>
+  </g>
+  
+  <!-- RabbitMQ -->
+  <g>
+    <rect x="340" y="60" width="120" height="120" rx="10" fill="#1a365d" stroke="#2b6cb0" stroke-width="2"/>
+    <text x="400" y="90" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="#90cdf4">RabbitMQ</text>
+    <text x="400" y="110" text-anchor="middle" font-family="Arial, sans-serif" font-size="11" fill="#bee3f8">Exchange</text>
+    <text x="400" y="125" text-anchor="middle" font-family="Arial, sans-serif" font-size="11" fill="#bee3f8">Queue</text>
+    <!-- Rabbit icon -->
+    <ellipse cx="400" cy="145" rx="15" ry="10" fill="#90cdf4"/>
+    <ellipse cx="395" cy="140" rx="3" ry="4" fill="#90cdf4"/>
+    <ellipse cx="405" cy="140" rx="3" ry="4" fill="#90cdf4"/>
+  </g>
+  
+  <!-- Consumer -->
+  <g>
+    <rect x="630" y="80" width="120" height="80" rx="10" fill="#2d3748" stroke="#4a5568" stroke-width="2"/>
+    <text x="690" y="110" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="#e0e0e0">Consumer</text>
+    <text x="690" y="130" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" fill="#cbd5e0">Worker</text>
+  </g>
+  
+  <!-- Arrows -->
+  <!-- Producer to RabbitMQ -->
+  <defs>
+    <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#68d391"/>
+    </marker>
+  </defs>
+  
+  <line x1="170" y1="120" x2="340" y2="120" stroke="#68d391" stroke-width="2" marker-end="url(#arrowhead)"/>
+  <text x="255" y="115" text-anchor="middle" font-family="Arial, sans-serif" font-size="11" fill="#68d391">publish</text>
+  
+  <!-- RabbitMQ to Consumer -->
+  <line x1="460" y1="120" x2="630" y2="120" stroke="#68d391" stroke-width="2" marker-end="url(#arrowhead)"/>
+  <text x="545" y="115" text-anchor="middle" font-family="Arial, sans-serif" font-size="11" fill="#68d391">deliver</text>
+  
+  <!-- Message flow steps -->
+  <g>
+    <text x="50" y="220" font-family="Arial, sans-serif" font-size="16" font-weight="bold" fill="#e0e0e0">Message Flow Steps:</text>
+    
+    <g>
+      <circle cx="70" cy="250" r="8" fill="#68d391"/>
+      <text x="82" y="255" font-family="Arial, sans-serif" font-size="12" fill="#e0e0e0">1. Create message instance with data</text>
+    </g>
+    
+    <g>
+      <circle cx="70" cy="275" r="8" fill="#68d391"/>
+      <text x="82" y="280" font-family="Arial, sans-serif" font-size="12" fill="#e0e0e0">2. Call msg.publish('action_name')</text>
+    </g>
+    
+    <g>
+      <circle cx="70" cy="300" r="8" fill="#68d391"/>
+      <text x="82" y="305" font-family="Arial, sans-serif" font-size="12" fill="#e0e0e0">3. Message sent with routing key: ClassName.action</text>
+    </g>
+    
+    <g>
+      <circle cx="70" cy="325" r="8" fill="#68d391"/>
+      <text x="82" y="330" font-family="Arial, sans-serif" font-size="12" fill="#e0e0e0">4. Consumer receives and instantiates message class</text>
+    </g>
+    
+    <g>
+      <circle cx="70" cy="350" r="8" fill="#68d391"/>
+      <text x="82" y="355" font-family="Arial, sans-serif" font-size="12" fill="#e0e0e0">5. Action method called automatically, message ACK/NACK sent</text>
+    </g>
+  </g>
+  
+  <!-- Routing key example -->
+  <g>
+    <rect x="200" y="200" width="400" height="40" rx="5" fill="#2d3748" stroke="#4a5568" stroke-width="1"/>
+    <text x="400" y="215" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" fill="#9ca3af">Routing Key Format:</text>
+    <text x="400" y="230" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="#f59e0b">MessageClassName.action_name</text>
+  </g>
+</svg>

data/examples/images/order_workflow.svg

@@ -0,0 +1,122 @@
+<svg width="800" height="500" xmlns="http://www.w3.org/2000/svg">
+  <!-- Background transparent -->
+  <rect width="800" height="500" fill="transparent"/>
+  
+  <!-- Title -->
+  <text x="400" y="30" text-anchor="middle" font-family="Arial, sans-serif" font-size="18" font-weight="bold" fill="#e0e0e0">
+    Order Processing Workflow
+  </text>
+  
+  <!-- Workflow Steps -->
+  
+  <!-- Step 1: Validate -->
+  <g>
+    <rect x="50" y="70" width="120" height="80" rx="10" fill="#2d3748" stroke="#68d391" stroke-width="2"/>
+    <text x="110" y="95" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="#68d391">VALIDATE</text>
+    <text x="110" y="115" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">• Check email</text>
+    <text x="110" y="130" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">• Check amount</text>
+    <text x="110" y="145" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">• Update status</text>
+  </g>
+  
+  <!-- Step 2: Process Payment -->
+  <g>
+    <rect x="250" y="70" width="120" height="80" rx="10" fill="#2d3748" stroke="#4299e1" stroke-width="2"/>
+    <text x="310" y="95" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="#4299e1">PAYMENT</text>
+    <text x="310" y="115" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">💳 Process</text>
+    <text x="310" y="130" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">payment</text>
+    <text x="310" y="145" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">80% success</text>
+  </g>
+  
+  <!-- Step 3: Ship -->
+  <g>
+    <rect x="450" y="70" width="120" height="80" rx="10" fill="#2d3748" stroke="#ed8936" stroke-width="2"/>
+    <text x="510" y="95" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="#ed8936">SHIP</text>
+    <text x="510" y="115" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">📦 Generate</text>
+    <text x="510" y="130" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">tracking #</text>
+    <text x="510" y="145" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">Send email</text>
+  </g>
+  
+  <!-- Step 4: Cancel (failure path) -->
+  <g>
+    <rect x="250" y="200" width="120" height="80" rx="10" fill="#2d3748" stroke="#e53e3e" stroke-width="2"/>
+    <text x="310" y="225" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="#e53e3e">CANCEL</text>
+    <text x="310" y="245" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">❌ Handle</text>
+    <text x="310" y="260" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">failure</text>
+    <text x="310" y="275" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">Notify customer</text>
+  </g>
+  
+  <!-- Success Flow Arrows -->
+  <defs>
+    <marker id="arrow-success" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#68d391"/>
+    </marker>
+    <marker id="arrow-failure" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#e53e3e"/>
+    </marker>
+  </defs>
+  
+  <!-- Validate to Payment -->
+  <line x1="170" y1="110" x2="250" y2="110" stroke="#68d391" stroke-width="2" marker-end="url(#arrow-success)"/>
+  <text x="210" y="105" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#68d391">success</text>
+  
+  <!-- Payment to Ship -->
+  <line x1="370" y1="110" x2="450" y2="110" stroke="#68d391" stroke-width="2" marker-end="url(#arrow-success)"/>
+  <text x="410" y="105" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#68d391">paid</text>
+  
+  <!-- Payment to Cancel (failure path) -->
+  <line x1="310" y1="150" x2="310" y2="200" stroke="#e53e3e" stroke-width="2" marker-end="url(#arrow-failure)"/>
+  <text x="325" y="175" font-family="Arial, sans-serif" font-size="10" fill="#e53e3e">failed</text>
+  
+  <!-- Message Chaining -->
+  <g>
+    <rect x="50" y="320" width="700" height="100" rx="10" fill="#2d3748" stroke="#9f7aea" stroke-width="2"/>
+    <text x="400" y="345" text-anchor="middle" font-family="Arial, sans-serif" font-size="16" font-weight="bold" fill="#9f7aea">Message Chaining</text>
+    <text x="400" y="365" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" fill="#e0e0e0">Each step publishes the next action automatically</text>
+    
+    <g>
+      <text x="70" y="385" font-family="monospace" font-size="11" fill="#68d391">validate()</text>
+      <text x="130" y="385" font-family="monospace" font-size="11" fill="#e0e0e0">→ publish('process_payment')</text>
+      
+      <text x="300" y="385" font-family="monospace" font-size="11" fill="#4299e1">process_payment()</text>
+      <text x="410" y="385" font-family="monospace" font-size="11" fill="#e0e0e0">→ publish('ship')</text>
+      
+      <text x="70" y="405" font-family="monospace" font-size="11" fill="#e53e3e">process_payment()</text>
+      <text x="180" y="405" font-family="monospace" font-size="11" fill="#e0e0e0">(on failure) → publish('cancel')</text>
+    </g>
+  </g>
+  
+  <!-- Order Data Structure -->
+  <g>
+    <rect x="600" y="70" width="150" height="200" rx="10" fill="#1a202c" stroke="#4a5568" stroke-width="1"/>
+    <text x="675" y="90" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#f6e05e">Order Data</text>
+    
+    <text x="610" y="110" font-family="monospace" font-size="9" fill="#e0e0e0">{</text>
+    <text x="615" y="125" font-family="monospace" font-size="9" fill="#68d391">order_id:</text>
+    <text x="665" y="125" font-family="monospace" font-size="9" fill="#e0e0e0">"ORD-1234",</text>
+    <text x="615" y="140" font-family="monospace" font-size="9" fill="#68d391">total_amount:</text>
+    <text x="685" y="140" font-family="monospace" font-size="9" fill="#f6e05e">99.99,</text>
+    <text x="615" y="155" font-family="monospace" font-size="9" fill="#68d391">status:</text>
+    <text x="650" y="155" font-family="monospace" font-size="9" fill="#e0e0e0">"new",</text>
+    <text x="615" y="170" font-family="monospace" font-size="9" fill="#68d391">customer:</text>
+    <text x="665" y="170" font-family="monospace" font-size="9" fill="#e0e0e0">{</text>
+    <text x="625" y="185" font-family="monospace" font-size="9" fill="#4299e1">name:</text>
+    <text x="655" y="185" font-family="monospace" font-size="9" fill="#e0e0e0">"John",</text>
+    <text x="625" y="200" font-family="monospace" font-size="9" fill="#4299e1">email:</text>
+    <text x="655" y="200" font-family="monospace" font-size="9" fill="#e0e0e0">"john@...",</text>
+    <text x="625" y="215" font-family="monospace" font-size="9" fill="#4299e1">phone:</text>
+    <text x="655" y="215" font-family="monospace" font-size="9" fill="#e0e0e0">"555-..."</text>
+    <text x="615" y="230" font-family="monospace" font-size="9" fill="#e0e0e0">},</text>
+    <text x="615" y="245" font-family="monospace" font-size="9" fill="#68d391">items:</text>
+    <text x="645" y="245" font-family="monospace" font-size="9" fill="#e0e0e0">[...]</text>
+    <text x="610" y="260" font-family="monospace" font-size="9" fill="#e0e0e0">}</text>
+  </g>
+  
+  <!-- Status indicators -->
+  <g>
+    <circle cx="625" cy="450" r="8" fill="#68d391"/>
+    <text x="640" y="455" font-family="Arial, sans-serif" font-size="12" fill="#e0e0e0">Success Path</text>
+    
+    <circle cx="625" cy="470" r="8" fill="#e53e3e"/>
+    <text x="640" y="475" font-family="Arial, sans-serif" font-size="12" fill="#e0e0e0">Failure Path</text>
+  </g>
+</svg>

data/examples/images/producer_consumer.svg

@@ -0,0 +1,96 @@
+<svg width="700" height="450" xmlns="http://www.w3.org/2000/svg">
+  <!-- Background transparent -->
+  <rect width="700" height="450" fill="transparent"/>
+  
+  <!-- Title -->
+  <text x="350" y="30" text-anchor="middle" font-family="Arial, sans-serif" font-size="18" font-weight="bold" fill="#e0e0e0">
+    Simple Producer-Consumer Pattern
+  </text>
+  
+  <!-- Producer Section -->
+  <g>
+    <rect x="50" y="70" width="200" height="150" rx="10" fill="#2d3748" stroke="#68d391" stroke-width="2"/>
+    <text x="150" y="95" text-anchor="middle" font-family="Arial, sans-serif" font-size="16" font-weight="bold" fill="#68d391">PRODUCER</text>
+    <text x="150" y="115" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" fill="#e0e0e0">producer.rb</text>
+    
+    <!-- Code snippet -->
+    <rect x="60" y="130" width="180" height="80" fill="#1a202c" stroke="#4a5568" stroke-width="1"/>
+    <text x="65" y="145" font-family="monospace" font-size="10" fill="#68d391">msg = GreetingMessage.new</text>
+    <text x="65" y="160" font-family="monospace" font-size="10" fill="#e0e0e0">msg[:name] = "User 1"</text>
+    <text x="65" y="175" font-family="monospace" font-size="10" fill="#e0e0e0">msg[:timestamp] = Time.now</text>
+    <text x="65" y="190" font-family="monospace" font-size="10" fill="#f6e05e">msg.publish('say_hello')</text>
+    <text x="65" y="205" font-family="monospace" font-size="10" fill="#9ca3af"># Routing: GreetingMessage.say_hello</text>
+  </g>
+  
+  <!-- RabbitMQ Queue -->
+  <g>
+    <rect x="300" y="100" width="100" height="90" rx="10" fill="#1a365d" stroke="#2b6cb0" stroke-width="2"/>
+    <text x="350" y="125" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="#90cdf4">Queue</text>
+    
+    <!-- Message icons in queue -->
+    <rect x="315" y="135" width="70" height="12" rx="2" fill="#4299e1"/>
+    <rect x="315" y="150" width="70" height="12" rx="2" fill="#4299e1"/>
+    <rect x="315" y="165" width="70" height="12" rx="2" fill="#4299e1"/>
+    
+    <text x="350" y="180" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#bee3f8">Messages</text>
+  </g>
+  
+  <!-- Consumer Section -->
+  <g>
+    <rect x="450" y="70" width="200" height="150" rx="10" fill="#2d3748" stroke="#ed8936" stroke-width="2"/>
+    <text x="550" y="95" text-anchor="middle" font-family="Arial, sans-serif" font-size="16" font-weight="bold" fill="#ed8936">CONSUMER</text>
+    <text x="550" y="115" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" fill="#e0e0e0">consumer.rb</text>
+    
+    <!-- Code snippet -->
+    <rect x="460" y="130" width="180" height="80" fill="#1a202c" stroke="#4a5568" stroke-width="1"/>
+    <text x="465" y="145" font-family="monospace" font-size="10" fill="#ed8936">def say_hello(*args)</text>
+    <text x="465" y="160" font-family="monospace" font-size="10" fill="#e0e0e0">  puts "Hello #{@items[:name]}"</text>
+    <text x="465" y="175" font-family="monospace" font-size="10" fill="#e0e0e0">  sleep 0.5</text>
+    <text x="465" y="190" font-family="monospace" font-size="10" fill="#68d391">  success!</text>
+    <text x="465" y="205" font-family="monospace" font-size="10" fill="#ed8936">end</text>
+  </g>
+  
+  <!-- Arrows -->
+  <defs>
+    <marker id="arrow-green" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#68d391"/>
+    </marker>
+    <marker id="arrow-orange" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#ed8936"/>
+    </marker>
+  </defs>
+  
+  <!-- Producer to Queue -->
+  <line x1="250" y1="145" x2="300" y2="145" stroke="#68d391" stroke-width="2" marker-end="url(#arrow-green)"/>
+  <text x="275" y="140" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#68d391">publish</text>
+  
+  <!-- Queue to Consumer -->
+  <line x1="400" y1="145" x2="450" y2="145" stroke="#ed8936" stroke-width="2" marker-end="url(#arrow-orange)"/>
+  <text x="425" y="140" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#ed8936">consume</text>
+  
+  <!-- Message Class Definition -->
+  <g>
+    <rect x="50" y="260" width="600" height="160" rx="10" fill="#2d3748" stroke="#9f7aea" stroke-width="2"/>
+    <text x="350" y="285" text-anchor="middle" font-family="Arial, sans-serif" font-size="16" font-weight="bold" fill="#9f7aea">GreetingMessage Class</text>
+    <text x="350" y="305" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" fill="#e0e0e0">simple_message.rb</text>
+    
+    <!-- Code -->
+    <rect x="70" y="320" width="560" height="90" fill="#1a202c" stroke="#4a5568" stroke-width="1"/>
+    <text x="80" y="340" font-family="monospace" font-size="11" fill="#9f7aea">class GreetingMessage &lt; BunnyFarm::Message</text>
+    <text x="90" y="355" font-family="monospace" font-size="11" fill="#68d391">fields</text>
+    <text x="130" y="355" font-family="monospace" font-size="11" fill="#e0e0e0">:name, :greeting_type, :timestamp</text>
+    <text x="90" y="370" font-family="monospace" font-size="11" fill="#f6e05e">actions</text>
+    <text x="130" y="370" font-family="monospace" font-size="11" fill="#e0e0e0">:say_hello, :say_goodbye</text>
+    <text x="90" y="385" font-family="monospace" font-size="11" fill="#9ca3af"># Action methods defined here...</text>
+    <text x="80" y="400" font-family="monospace" font-size="11" fill="#9f7aea">end</text>
+  </g>
+  
+  <!-- Terminal outputs -->
+  <g>
+    <text x="50" y="445" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#68d391">Producer Output:</text>
+    <text x="180" y="445" font-family="monospace" font-size="10" fill="#9ca3af">✅ Sent hello message for User 1</text>
+    
+    <text x="350" y="445" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#ed8936">Consumer Output:</text>
+    <text x="480" y="445" font-family="monospace" font-size="10" fill="#9ca3af">👋 Hello, User 1!</text>
+  </g>
+</svg>