bunny_farm 0.1.2

data/docs/assets/message_api_overview.svg

@@ -0,0 +1,126 @@
+<svg width="900" height="600" xmlns="http://www.w3.org/2000/svg">
+  <rect width="900" height="600" fill="transparent"/>
+  
+  <!-- Title -->
+  <text x="450" y="30" text-anchor="middle" font-family="Arial, sans-serif" font-size="18" font-weight="bold" fill="#e0e0e0">
+    Message API Overview
+  </text>
+  
+  <!-- Class Hierarchy -->
+  <g>
+    <text x="450" y="70" text-anchor="middle" font-family="Arial, sans-serif" font-size="16" font-weight="bold" fill="#4299e1">
+      Class Hierarchy and API Structure
+    </text>
+    
+    <!-- Base Message Class -->
+    <rect x="350" y="90" width="200" height="80" rx="8" fill="#2d3748" stroke="#4299e1" stroke-width="3"/>
+    <text x="450" y="115" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="#4299e1">BunnyFarm::Message</text>
+    <text x="450" y="135" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" fill="#e0e0e0">Base class for all messages</text>
+    <text x="450" y="150" text-anchor="middle" font-family="Arial, sans-serif" font-size="11" fill="#9ca3af">Core functionality</text>
+    <text x="450" y="165" text-anchor="middle" font-family="Arial, sans-serif" font-size="11" fill="#9ca3af">Field management, publishing</text>
+    
+    <!-- Derived Classes -->
+    <rect x="100" y="200" width="150" height="60" rx="6" fill="#2d3748" stroke="#68d391" stroke-width="2"/>
+    <text x="175" y="225" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#68d391">OrderMessage</text>
+    <text x="175" y="240" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">extends Message</text>
+    <text x="175" y="255" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#9ca3af">Business logic</text>
+    
+    <rect x="275" y="200" width="150" height="60" rx="6" fill="#2d3748" stroke="#9f7aea" stroke-width="2"/>
+    <text x="350" y="225" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#9f7aea">EmailMessage</text>
+    <text x="350" y="240" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">extends Message</text>
+    <text x="350" y="255" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#9ca3af">Email handling</text>
+    
+    <rect x="450" y="200" width="150" height="60" rx="6" fill="#2d3748" stroke="#f6e05e" stroke-width="2"/>
+    <text x="525" y="225" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#f6e05e">ReportMessage</text>
+    <text x="525" y="240" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">extends Message</text>
+    <text x="525" y="255" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#9ca3af">Report generation</text>
+    
+    <rect x="625" y="200" width="150" height="60" rx="6" fill="#2d3748" stroke="#e53e3e" stroke-width="2"/>
+    <text x="700" y="225" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#e53e3e">TaskMessage</text>
+    <text x="700" y="240" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">extends Message</text>
+    <text x="700" y="255" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#9ca3af">Task execution</text>
+  </g>
+  
+  <!-- Core API Methods -->
+  <g>
+    <text x="450" y="310" text-anchor="middle" font-family="Arial, sans-serif" font-size="16" font-weight="bold" fill="#e0e0e0">
+      Core API Methods by Category
+    </text>
+    
+    <!-- Initialization -->
+    <rect x="50" y="330" width="170" height="120" rx="6" fill="#2d3748" stroke="#68d391" stroke-width="1"/>
+    <text x="135" y="355" text-anchor="middle" font-family="Arial, sans-serif" font-size="13" font-weight="bold" fill="#68d391">Initialization</text>
+    <text x="60" y="375" font-family="monospace" font-size="10" fill="#e0e0e0">new(data = {})</text>
+    <text x="60" y="390" font-family="monospace" font-size="10" fill="#e0e0e0">initialize(data)</text>
+    <text x="60" y="405" font-family="monospace" font-size="10" fill="#e0e0e0">setup!</text>
+    <text x="60" y="420" font-family="monospace" font-size="10" fill="#e0e0e0">configure(options)</text>
+    <text x="60" y="435" font-family="monospace" font-size="10" fill="#e0e0e0">from_json(json_str)</text>
+    
+    <!-- Field Management -->
+    <rect x="240" y="330" width="170" height="120" rx="6" fill="#2d3748" stroke="#4299e1" stroke-width="1"/>
+    <text x="325" y="355" text-anchor="middle" font-family="Arial, sans-serif" font-size="13" font-weight="bold" fill="#4299e1">Field Management</text>
+    <text x="250" y="375" font-family="monospace" font-size="10" fill="#e0e0e0">[](field_name)</text>
+    <text x="250" y="390" font-family="monospace" font-size="10" fill="#e0e0e0">[]=(field, value)</text>
+    <text x="250" y="405" font-family="monospace" font-size="10" fill="#e0e0e0">field_names</text>
+    <text x="250" y="420" font-family="monospace" font-size="10" fill="#e0e0e0">has_field?(name)</text>
+    <text x="250" y="435" font-family="monospace" font-size="10" fill="#e0e0e0">clear_field(name)</text>
+    
+    <!-- Publishing -->
+    <rect x="430" y="330" width="170" height="120" rx="6" fill="#2d3748" stroke="#9f7aea" stroke-width="1"/>
+    <text x="515" y="355" text-anchor="middle" font-family="Arial, sans-serif" font-size="13" font-weight="bold" fill="#9f7aea">Publishing</text>
+    <text x="440" y="375" font-family="monospace" font-size="10" fill="#e0e0e0">publish(action)</text>
+    <text x="440" y="390" font-family="monospace" font-size="10" fill="#e0e0e0">publish_at(time)</text>
+    <text x="440" y="405" font-family="monospace" font-size="10" fill="#e0e0e0">publish_in(delay)</text>
+    <text x="440" y="420" font-family="monospace" font-size="10" fill="#e0e0e0">schedule(cron)</text>
+    <text x="440" y="435" font-family="monospace" font-size="10" fill="#e0e0e0">broadcast</text>
+    
+    <!-- Validation -->
+    <rect x="620" y="330" width="170" height="120" rx="6" fill="#2d3748" stroke="#f6e05e" stroke-width="1"/>
+    <text x="705" y="355" text-anchor="middle" font-family="Arial, sans-serif" font-size="13" font-weight="bold" fill="#f6e05e">Validation</text>
+    <text x="630" y="375" font-family="monospace" font-size="10" fill="#e0e0e0">valid?</text>
+    <text x="630" y="390" font-family="monospace" font-size="10" fill="#e0e0e0">validate!</text>
+    <text x="630" y="405" font-family="monospace" font-size="10" fill="#e0e0e0">errors</text>
+    <text x="630" y="420" font-family="monospace" font-size="10" fill="#e0e0e0">add_error(msg)</text>
+    <text x="630" y="435" font-family="monospace" font-size="10" fill="#e0e0e0">clear_errors</text>
+  </g>
+  
+  <!-- Method Usage Examples -->
+  <g>
+    <text x="450" y="490" text-anchor="middle" font-family="Arial, sans-serif" font-size="16" font-weight="bold" fill="#e0e0e0">
+      Common Usage Patterns
+    </text>
+    
+    <!-- Creation Pattern -->
+    <rect x="50" y="510" width="250" height="70" rx="6" fill="#1a202c" stroke="#68d391" stroke-width="1"/>
+    <text x="175" y="530" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#68d391">Message Creation</text>
+    <text x="60" y="545" font-family="monospace" font-size="10" fill="#e0e0e0">msg = OrderMessage.new</text>
+    <text x="60" y="560" font-family="monospace" font-size="10" fill="#e0e0e0">msg[:order_id] = 12345</text>
+    <text x="60" y="575" font-family="monospace" font-size="10" fill="#e0e0e0">msg.setup!</text>
+    
+    <!-- Publishing Pattern -->
+    <rect x="320" y="510" width="250" height="70" rx="6" fill="#1a202c" stroke="#9f7aea" stroke-width="1"/>
+    <text x="445" y="530" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#9f7aea">Publishing Pattern</text>
+    <text x="330" y="545" font-family="monospace" font-size="10" fill="#e0e0e0">msg.validate!</text>
+    <text x="330" y="560" font-family="monospace" font-size="10" fill="#e0e0e0">msg.publish('process')</text>
+    <text x="330" y="575" font-family="monospace" font-size="10" fill="#e0e0e0"># Routes to OrderMessage.process</text>
+    
+    <!-- Error Handling Pattern -->
+    <rect x="590" y="510" width="250" height="70" rx="6" fill="#1a202c" stroke="#e53e3e" stroke-width="1"/>
+    <text x="715" y="530" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#e53e3e">Error Handling</text>
+    <text x="600" y="545" font-family="monospace" font-size="10" fill="#e0e0e0">unless msg.valid?</text>
+    <text x="610" y="560" font-family="monospace" font-size="10" fill="#e0e0e0">puts msg.errors</text>
+    <text x="600" y="575" font-family="monospace" font-size="10" fill="#e0e0e0">end</text>
+  </g>
+  
+  <!-- Inheritance Arrows -->
+  <defs>
+    <marker id="arrow-inherit" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto">
+      <polygon points="0 0, 8 3, 0 6" fill="#4299e1"/>
+    </marker>
+  </defs>
+  
+  <line x1="400" y1="170" x2="200" y2="190" stroke="#4299e1" stroke-width="2" marker-end="url(#arrow-inherit)"/>
+  <line x1="430" y1="170" x2="350" y2="190" stroke="#4299e1" stroke-width="2" marker-end="url(#arrow-inherit)"/>
+  <line x1="470" y1="170" x2="525" y2="190" stroke="#4299e1" stroke-width="2" marker-end="url(#arrow-inherit)"/>
+  <line x1="500" y1="170" x2="675" y2="190" stroke="#4299e1" stroke-width="2" marker-end="url(#arrow-inherit)"/>
+</svg>

data/docs/assets/message_encapsulation.svg

@@ -0,0 +1,113 @@
+<svg width="800" height="600" xmlns="http://www.w3.org/2000/svg">
+  <rect width="800" height="600" fill="transparent"/>
+  
+  <!-- Title -->
+  <text x="400" y="30" text-anchor="middle" font-family="Arial, sans-serif" font-size="18" font-weight="bold" fill="#e0e0e0">
+    Message Encapsulation: Data + Behavior
+  </text>
+  
+  <!-- Traditional Job Queue (Left Side) -->
+  <g>
+    <text x="200" y="70" text-anchor="middle" font-family="Arial, sans-serif" font-size="16" font-weight="bold" fill="#e53e3e">
+      Traditional Job Queue
+    </text>
+    
+    <!-- Data structure -->
+    <rect x="50" y="90" width="300" height="80" rx="8" fill="#2d3748" stroke="#e53e3e" stroke-width="2"/>
+    <text x="200" y="115" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="#e53e3e">Simple Data Structure</text>
+    <text x="60" y="135" font-family="monospace" font-size="11" fill="#e0e0e0">job_data = {</text>
+    <text x="70" y="150" font-family="monospace" font-size="11" fill="#e0e0e0">action: "process_order",</text>
+    <text x="70" y="165" font-family="monospace" font-size="11" fill="#e0e0e0">order_id: 12345</text>
+    <text x="60" y="180" font-family="monospace" font-size="11" fill="#e0e0e0">}</text>
+    
+    <!-- Generic Worker -->
+    <rect x="50" y="190" width="300" height="100" rx="8" fill="#2d3748" stroke="#e53e3e" stroke-width="2"/>
+    <text x="200" y="215" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="#e53e3e">Generic Worker Process</text>
+    <text x="60" y="235" font-family="monospace" font-size="11" fill="#e0e0e0">def handle_job(job_data)</text>
+    <text x="70" y="250" font-family="monospace" font-size="11" fill="#e0e0e0">case job_data[:action]</text>
+    <text x="70" y="265" font-family="monospace" font-size="11" fill="#e0e0e0">when "process_order"</text>
+    <text x="80" y="280" font-family="monospace" font-size="11" fill="#e0e0e0">process_order_logic</text>
+    <text x="60" y="295" font-family="monospace" font-size="11" fill="#e0e0e0">end</text>
+    
+    <text x="200" y="320" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" fill="#e53e3e">❌ Data and behavior are separated</text>
+    <text x="200" y="335" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" fill="#e53e3e">❌ Hard to test individual job types</text>
+    <text x="200" y="350" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" fill="#e53e3e">❌ Worker becomes complex with many job types</text>
+  </g>
+  
+  <!-- VS Arrow -->
+  <text x="400" y="210" text-anchor="middle" font-family="Arial, sans-serif" font-size="20" font-weight="bold" fill="#ff9800">VS</text>
+  
+  <!-- BunnyFarm Message (Right Side) -->
+  <g>
+    <text x="600" y="70" text-anchor="middle" font-family="Arial, sans-serif" font-size="16" font-weight="bold" fill="#68d391">
+      BunnyFarm Message
+    </text>
+    
+    <!-- Message Class -->
+    <rect x="450" y="90" width="300" height="180" rx="8" fill="#2d3748" stroke="#68d391" stroke-width="2"/>
+    <text x="600" y="115" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="#68d391">Message Class (Data + Behavior)</text>
+    
+    <!-- Data definition -->
+    <text x="460" y="135" font-family="monospace" font-size="11" fill="#4299e1">class OrderMessage &lt; BunnyFarm::Message</text>
+    <text x="470" y="150" font-family="monospace" font-size="11" fill="#9ca3af"># Data structure</text>
+    <text x="470" y="165" font-family="monospace" font-size="11" fill="#68d391">fields</text>
+    <text x="510" y="165" font-family="monospace" font-size="11" fill="#e0e0e0">:order_id, :customer, :items</text>
+    
+    <!-- Actions definition -->
+    <text x="470" y="185" font-family="monospace" font-size="11" fill="#9ca3af"># Behavior definition</text>
+    <text x="470" y="200" font-family="monospace" font-size="11" fill="#f6e05e">actions</text>
+    <text x="520" y="200" font-family="monospace" font-size="11" fill="#e0e0e0">:validate, :process, :ship</text>
+    
+    <!-- Method implementation -->
+    <text x="470" y="220" font-family="monospace" font-size="11" fill="#9ca3af"># Business logic</text>
+    <text x="470" y="235" font-family="monospace" font-size="11" fill="#f6e05e">def process</text>
+    <text x="480" y="250" font-family="monospace" font-size="11" fill="#e0e0e0">validate_order</text>
+    <text x="480" y="265" font-family="monospace" font-size="11" fill="#e0e0e0">charge_payment</text>
+    <text x="470" y="280" font-family="monospace" font-size="11" fill="#f6e05e">end</text>
+    <text x="460" y="295" font-family="monospace" font-size="11" fill="#4299e1">end</text>
+    
+    <text x="600" y="320" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" fill="#68d391">✅ Data and behavior encapsulated together</text>
+    <text x="600" y="335" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" fill="#68d391">✅ Easy to unit test each message type</text>
+    <text x="600" y="350" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" fill="#68d391">✅ Self-contained and discoverable</text>
+  </g>
+  
+  <!-- Benefits Section -->
+  <g>
+    <text x="400" y="390" text-anchor="middle" font-family="Arial, sans-serif" font-size="16" font-weight="bold" fill="#e0e0e0">
+      Benefits of Message-Centric Design
+    </text>
+    
+    <!-- Benefit boxes -->
+    <rect x="50" y="410" width="160" height="120" rx="8" fill="#2d3748" stroke="#68d391" stroke-width="1"/>
+    <text x="130" y="435" text-anchor="middle" font-family="Arial, sans-serif" font-size="13" font-weight="bold" fill="#68d391">Encapsulation</text>
+    <text x="60" y="455" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">• Related data and behavior</text>
+    <text x="70" y="470" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">stay together</text>
+    <text x="60" y="485" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">• Single responsibility</text>
+    <text x="60" y="500" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">• Clear boundaries</text>
+    <text x="60" y="515" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">• Reduced coupling</text>
+    
+    <rect x="230" y="410" width="160" height="120" rx="8" fill="#2d3748" stroke="#4299e1" stroke-width="1"/>
+    <text x="310" y="435" text-anchor="middle" font-family="Arial, sans-serif" font-size="13" font-weight="bold" fill="#4299e1">Discoverability</text>
+    <text x="240" y="455" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">• Easy to understand what</text>
+    <text x="250" y="470" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">a message can do</text>
+    <text x="240" y="485" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">• Self-documenting API</text>
+    <text x="240" y="500" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">• Clear interface</text>
+    <text x="240" y="515" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">• Introspectable</text>
+    
+    <rect x="410" y="410" width="160" height="120" rx="8" fill="#2d3748" stroke="#9f7aea" stroke-width="1"/>
+    <text x="490" y="435" text-anchor="middle" font-family="Arial, sans-serif" font-size="13" font-weight="bold" fill="#9f7aea">Testability</text>
+    <text x="420" y="455" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">• Individual message types</text>
+    <text x="430" y="470" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">can be unit tested</text>
+    <text x="420" y="485" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">• Mock dependencies easily</text>
+    <text x="420" y="500" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">• Test business logic</text>
+    <text x="430" y="515" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">in isolation</text>
+    
+    <rect x="590" y="410" width="160" height="120" rx="8" fill="#2d3748" stroke="#f6e05e" stroke-width="1"/>
+    <text x="670" y="435" text-anchor="middle" font-family="Arial, sans-serif" font-size="13" font-weight="bold" fill="#f6e05e">Type Safety</text>
+    <text x="600" y="455" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">• Ruby class system</text>
+    <text x="610" y="470" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">provides structure</text>
+    <text x="600" y="485" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">• Field validation</text>
+    <text x="600" y="500" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">• Method signatures</text>
+    <text x="600" y="515" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">• IDE support</text>
+  </g>
+</svg>

data/docs/assets/message_lifecycle.svg

@@ -0,0 +1,110 @@
+<svg width="900" height="400" xmlns="http://www.w3.org/2000/svg">
+  <rect width="900" height="400" fill="transparent"/>
+  
+  <!-- Title -->
+  <text x="450" y="30" text-anchor="middle" font-family="Arial, sans-serif" font-size="18" font-weight="bold" fill="#e0e0e0">
+    Message Lifecycle in BunnyFarm
+  </text>
+  
+  <!-- Stage boxes -->
+  <defs>
+    <marker id="arrow-lifecycle" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#ff9800"/>
+    </marker>
+  </defs>
+  
+  <!-- Stage 1: Creation -->
+  <g>
+    <rect x="50" y="80" width="140" height="80" rx="10" fill="#2d3748" stroke="#68d391" stroke-width="2"/>
+    <text x="120" y="105" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="#68d391">1. Creation</text>
+    <text x="120" y="125" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">message = OrderMessage.new</text>
+    <text x="120" y="140" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">message[:order_id] = 12345</text>
+    <text x="120" y="155" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">Set data fields</text>
+  </g>
+  
+  <!-- Stage 2: Publishing -->
+  <g>
+    <rect x="220" y="80" width="140" height="80" rx="10" fill="#2d3748" stroke="#4299e1" stroke-width="2"/>
+    <text x="290" y="105" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="#4299e1">2. Publishing</text>
+    <text x="290" y="125" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">message.publish('process')</text>
+    <text x="290" y="140" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">Serialize to JSON</text>
+    <text x="290" y="155" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">Send to RabbitMQ</text>
+  </g>
+  
+  <!-- Stage 3: Routing -->
+  <g>
+    <rect x="390" y="80" width="140" height="80" rx="10" fill="#2d3748" stroke="#9f7aea" stroke-width="2"/>
+    <text x="460" y="105" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="#9f7aea">3. Routing</text>
+    <text x="460" y="125" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">Key: OrderMessage.process</text>
+    <text x="460" y="140" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">Exchange → Queue</text>
+    <text x="460" y="155" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">Route to consumer</text>
+  </g>
+  
+  <!-- Stage 4: Consumption -->
+  <g>
+    <rect x="560" y="80" width="140" height="80" rx="10" fill="#2d3748" stroke="#f6e05e" stroke-width="2"/>
+    <text x="630" y="105" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="#f6e05e">4. Consumption</text>
+    <text x="630" y="125" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">Deserialize JSON</text>
+    <text x="630" y="140" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">Create instance</text>
+    <text x="630" y="155" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">Call process() method</text>
+  </g>
+  
+  <!-- Stage 5: Acknowledgment -->
+  <g>
+    <rect x="730" y="80" width="140" height="80" rx="10" fill="#2d3748" stroke="#e53e3e" stroke-width="2"/>
+    <text x="800" y="105" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="#e53e3e">5. Acknowledgment</text>
+    <text x="800" y="125" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">successful? → ACK</text>
+    <text x="800" y="140" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">failed? → NACK</text>
+    <text x="800" y="155" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#e0e0e0">Remove from queue</text>
+  </g>
+  
+  <!-- Flow arrows -->
+  <line x1="190" y1="120" x2="220" y2="120" stroke="#ff9800" stroke-width="3" marker-end="url(#arrow-lifecycle)"/>
+  <line x1="360" y1="120" x2="390" y2="120" stroke="#ff9800" stroke-width="3" marker-end="url(#arrow-lifecycle)"/>
+  <line x1="530" y1="120" x2="560" y2="120" stroke="#ff9800" stroke-width="3" marker-end="url(#arrow-lifecycle)"/>
+  <line x1="700" y1="120" x2="730" y2="120" stroke="#ff9800" stroke-width="3" marker-end="url(#arrow-lifecycle)"/>
+  
+  <!-- Data representation -->
+  <g>
+    <text x="450" y="210" text-anchor="middle" font-family="Arial, sans-serif" font-size="16" font-weight="bold" fill="#e0e0e0">Data Transformation</text>
+    
+    <!-- Ruby Object -->
+    <rect x="50" y="230" width="180" height="120" rx="8" fill="#1a202c" stroke="#68d391" stroke-width="1"/>
+    <text x="140" y="250" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#68d391">Ruby Object</text>
+    <text x="60" y="270" font-family="monospace" font-size="10" fill="#e0e0e0">message = OrderMessage.new</text>
+    <text x="60" y="285" font-family="monospace" font-size="10" fill="#e0e0e0">message[:order_id] = 12345</text>
+    <text x="60" y="300" font-family="monospace" font-size="10" fill="#e0e0e0">message[:customer] = {</text>
+    <text x="70" y="315" font-family="monospace" font-size="10" fill="#e0e0e0">name: "John Doe",</text>
+    <text x="70" y="330" font-family="monospace" font-size="10" fill="#e0e0e0">email: "john@example.com"</text>
+    <text x="60" y="345" font-family="monospace" font-size="10" fill="#e0e0e0">}</text>
+    
+    <!-- Arrow -->
+    <line x1="240" y1="290" x2="280" y2="290" stroke="#ff9800" stroke-width="2" marker-end="url(#arrow-lifecycle)"/>
+    <text x="260" y="285" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#ff9800">serialize</text>
+    
+    <!-- JSON -->
+    <rect x="290" y="230" width="200" height="120" rx="8" fill="#1a202c" stroke="#4299e1" stroke-width="1"/>
+    <text x="390" y="250" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#4299e1">JSON Message</text>
+    <text x="300" y="270" font-family="monospace" font-size="10" fill="#e0e0e0">{</text>
+    <text x="310" y="285" font-family="monospace" font-size="10" fill="#e0e0e0">"order_id": 12345,</text>
+    <text x="310" y="300" font-family="monospace" font-size="10" fill="#e0e0e0">"customer": {</text>
+    <text x="320" y="315" font-family="monospace" font-size="10" fill="#e0e0e0">"name": "John Doe",</text>
+    <text x="320" y="330" font-family="monospace" font-size="10" fill="#e0e0e0">"email": "john@example.com"</text>
+    <text x="310" y="345" font-family="monospace" font-size="10" fill="#e0e0e0">}</text>
+    <text x="300" y="360" font-family="monospace" font-size="10" fill="#e0e0e0">}</text>
+    
+    <!-- Arrow -->
+    <line x1="500" y1="290" x2="540" y2="290" stroke="#ff9800" stroke-width="2" marker-end="url(#arrow-lifecycle)"/>
+    <text x="520" y="285" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" fill="#ff9800">deserialize</text>
+    
+    <!-- Processed Object -->
+    <rect x="550" y="230" width="180" height="120" rx="8" fill="#1a202c" stroke="#68d391" stroke-width="1"/>
+    <text x="640" y="250" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#68d391">Processed Object</text>
+    <text x="560" y="270" font-family="monospace" font-size="10" fill="#e0e0e0">def process</text>
+    <text x="570" y="285" font-family="monospace" font-size="10" fill="#e0e0e0">validate_order</text>
+    <text x="570" y="300" font-family="monospace" font-size="10" fill="#e0e0e0">charge_payment</text>
+    <text x="570" y="315" font-family="monospace" font-size="10" fill="#e0e0e0">update_inventory</text>
+    <text x="570" y="330" font-family="monospace" font-size="10" fill="#e0e0e0">success!</text>
+    <text x="560" y="345" font-family="monospace" font-size="10" fill="#e0e0e0">end</text>
+  </g>
+</svg>

data/docs/assets/message_structure.svg

@@ -0,0 +1,138 @@
+<svg width="800" height="650" xmlns="http://www.w3.org/2000/svg">
+  <!-- Background transparent -->
+  <rect width="800" height="650" 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 Class Structure
+  </text>
+  
+  <!-- Class Definition -->
+  <g>
+    <rect x="50" y="60" width="700" height="120" rx="10" fill="#2d3748" stroke="#9f7aea" stroke-width="2"/>
+    <text x="400" y="85" text-anchor="middle" font-family="Arial, sans-serif" font-size="16" font-weight="bold" fill="#9f7aea">Message Class Definition</text>
+    
+    <rect x="70" y="100" width="660" height="70" fill="#1a202c" stroke="#4a5568" stroke-width="1"/>
+    <text x="80" y="115" font-family="monospace" font-size="11" fill="#9f7aea">class OrderMessage &lt; BunnyFarm::Message</text>
+    <text x="90" y="130" font-family="monospace" font-size="11" fill="#68d391">fields</text>
+    <text x="130" y="130" font-family="monospace" font-size="11" fill="#e0e0e0">:order_id, :total, { customer: [:name, :email] }, { items: [:id, :qty] }</text>
+    <text x="90" y="145" font-family="monospace" font-size="11" fill="#f6e05e">actions</text>
+    <text x="130" y="145" font-family="monospace" font-size="11" fill="#e0e0e0">:validate, :process_payment, :ship, :cancel</text>
+    <text x="80" y="160" font-family="monospace" font-size="11" fill="#9f7aea">end</text>
+  </g>
+  
+  <!-- DSL Components -->
+  <g>
+    <rect x="50" y="200" width="340" height="160" rx="10" fill="#2d3748" stroke="#68d391" stroke-width="2"/>
+    <text x="220" y="225" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="#68d391">Fields DSL</text>
+    <text x="220" y="245" text-anchor="middle" font-family="Arial, sans-serif" font-size="11" fill="#e0e0e0">Define expected data structure</text>
+    
+    <rect x="70" y="255" width="300" height="95" fill="#1a202c" stroke="#4a5568" stroke-width="1"/>
+    <text x="80" y="270" font-family="monospace" font-size="10" fill="#68d391">Simple fields:</text>
+    <text x="80" y="285" font-family="monospace" font-size="10" fill="#e0e0e0">:name, :email, :amount</text>
+    
+    <text x="80" y="305" font-family="monospace" font-size="10" fill="#68d391">Nested objects:</text>
+    <text x="80" y="320" font-family="monospace" font-size="10" fill="#e0e0e0">{ customer: [:name, :email] }</text>
+    
+    <text x="80" y="340" font-family="monospace" font-size="10" fill="#68d391">Arrays of objects:</text>
+    <text x="80" y="355" font-family="monospace" font-size="10" fill="#e0e0e0">{ items: [:product_id, :quantity] }</text>
+    
+    <rect x="410" y="200" width="340" height="160" rx="10" fill="#2d3748" stroke="#f6e05e" stroke-width="2"/>
+    <text x="580" y="225" text-anchor="middle" font-family="Arial, sans-serif" font-size="14" font-weight="bold" fill="#f6e05e">Actions DSL</text>
+    <text x="580" y="245" text-anchor="middle" font-family="Arial, sans-serif" font-size="11" fill="#e0e0e0">Define available operations</text>
+    
+    <rect x="430" y="255" width="300" height="95" fill="#1a202c" stroke="#4a5568" stroke-width="1"/>
+    <text x="440" y="270" font-family="monospace" font-size="10" fill="#f6e05e">actions :create, :update, :delete</text>
+    <text x="440" y="290" font-family="monospace" font-size="10" fill="#9ca3af"># Each action becomes a method</text>
+    <text x="440" y="310" font-family="monospace" font-size="10" fill="#f6e05e">def create(*args)</text>
+    <text x="450" y="325" font-family="monospace" font-size="10" fill="#e0e0e0"># Process creation logic</text>
+    <text x="450" y="340" font-family="monospace" font-size="10" fill="#68d391">success!</text>
+    <text x="440" y="355" font-family="monospace" font-size="10" fill="#f6e05e">end</text>
+  </g>
+  
+  <!-- Message Instance Structure -->
+  <g>
+    <rect x="50" y="380" width="700" height="140" rx="10" fill="#2d3748" stroke="#4299e1" stroke-width="2"/>
+    <text x="400" y="405" text-anchor="middle" font-family="Arial, sans-serif" font-size="16" font-weight="bold" fill="#4299e1">Message Instance Structure</text>
+    
+    <!-- Instance Variables -->
+    <rect x="80" y="420" width="200" height="90" rx="5" fill="#1a202c" stroke="#4a5568" stroke-width="1"/>
+    <text x="180" y="440" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#4299e1">Instance Variables</text>
+    <text x="90" y="455" font-family="monospace" font-size="10" fill="#68d391">@items</text>
+    <text x="125" y="455" font-family="monospace" font-size="10" fill="#e0e0e0">- Validated data</text>
+    <text x="90" y="470" font-family="monospace" font-size="10" fill="#68d391">@elements</text>
+    <text x="140" y="470" font-family="monospace" font-size="10" fill="#e0e0e0">- Raw JSON data</text>
+    <text x="90" y="485" font-family="monospace" font-size="10" fill="#68d391">@payload</text>
+    <text x="135" y="485" font-family="monospace" font-size="10" fill="#e0e0e0">- JSON string</text>
+    <text x="90" y="500" font-family="monospace" font-size="10" fill="#68d391">@errors</text>
+    <text x="130" y="500" font-family="monospace" font-size="10" fill="#e0e0e0">- Error messages</text>
+    
+    <!-- Access Methods -->
+    <rect x="300" y="420" width="180" height="90" rx="5" fill="#1a202c" stroke="#4a5568" stroke-width="1"/>
+    <text x="390" y="440" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#4299e1">Access Methods</text>
+    <text x="310" y="455" font-family="monospace" font-size="10" fill="#68d391">msg[:field]</text>
+    <text x="370" y="455" font-family="monospace" font-size="10" fill="#e0e0e0">- Get value</text>
+    <text x="310" y="470" font-family="monospace" font-size="10" fill="#68d391">msg[:field] = val</text>
+    <text x="395" y="470" font-family="monospace" font-size="10" fill="#e0e0e0">- Set</text>
+    <text x="310" y="485" font-family="monospace" font-size="10" fill="#68d391">msg.to_json</text>
+    <text x="370" y="485" font-family="monospace" font-size="10" fill="#e0e0e0">- Serialize</text>
+    <text x="310" y="500" font-family="monospace" font-size="10" fill="#68d391">msg.keys</text>
+    <text x="350" y="500" font-family="monospace" font-size="10" fill="#e0e0e0">- Get fields</text>
+    
+    <!-- State Methods -->
+    <rect x="500" y="420" width="220" height="90" rx="5" fill="#1a202c" stroke="#4a5568" stroke-width="1"/>
+    <text x="610" y="440" text-anchor="middle" font-family="Arial, sans-serif" font-size="12" font-weight="bold" fill="#4299e1">State Management</text>
+    <text x="510" y="455" font-family="monospace" font-size="10" fill="#68d391">success!</text>
+    <text x="550" y="455" font-family="monospace" font-size="10" fill="#e0e0e0">- Mark successful</text>
+    <text x="510" y="470" font-family="monospace" font-size="10" fill="#e53e3e">failure(msg)</text>
+    <text x="570" y="470" font-family="monospace" font-size="10" fill="#e0e0e0">- Mark failed</text>
+    <text x="510" y="485" font-family="monospace" font-size="10" fill="#68d391">successful?</text>
+    <text x="570" y="485" font-family="monospace" font-size="10" fill="#e0e0e0">- Check status</text>
+    <text x="510" y="500" font-family="monospace" font-size="10" fill="#68d391">publish(action)</text>
+    <text x="585" y="500" font-family="monospace" font-size="10" fill="#e0e0e0">- Send msg</text>
+  </g>
+  
+  <!-- Data Flow Example -->
+  <g>
+    <rect x="50" y="540" width="700" height="100" rx="10" fill="#2d3748" stroke="#ed8936" stroke-width="2"/>
+    <text x="400" y="565" text-anchor="middle" font-family="Arial, sans-serif" font-size="16" font-weight="bold" fill="#ed8936">Data Flow Example</text>
+    
+    <!-- Step boxes -->
+    <rect x="70" y="580" width="120" height="50" rx="5" fill="#68d391"/>
+    <text x="130" y="595" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" font-weight="bold" fill="#1a202c">1. JSON Input</text>
+    <text x="130" y="610" text-anchor="middle" font-family="Arial, sans-serif" font-size="9" fill="#1a202c">Raw message data</text>
+    <text x="130" y="620" text-anchor="middle" font-family="Arial, sans-serif" font-size="9" fill="#1a202c">from RabbitMQ</text>
+    
+    <rect x="210" y="580" width="120" height="50" rx="5" fill="#4299e1"/>
+    <text x="270" y="595" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" font-weight="bold" fill="#1a202c">2. Parse &amp; Validate</text>
+    <text x="270" y="610" text-anchor="middle" font-family="Arial, sans-serif" font-size="9" fill="#1a202c">Extract fields</text>
+    <text x="270" y="620" text-anchor="middle" font-family="Arial, sans-serif" font-size="9" fill="#1a202c">using DSL definition</text>
+    
+    <rect x="350" y="580" width="120" height="50" rx="5" fill="#9f7aea"/>
+    <text x="410" y="595" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" font-weight="bold" fill="#1a202c">3. Route Action</text>
+    <text x="410" y="610" text-anchor="middle" font-family="Arial, sans-serif" font-size="9" fill="#1a202c">Call method based</text>
+    <text x="410" y="620" text-anchor="middle" font-family="Arial, sans-serif" font-size="9" fill="#1a202c">on routing key</text>
+    
+    <rect x="490" y="580" width="120" height="50" rx="5" fill="#f6e05e"/>
+    <text x="550" y="595" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" font-weight="bold" fill="#1a202c">4. Execute Logic</text>
+    <text x="550" y="610" text-anchor="middle" font-family="Arial, sans-serif" font-size="9" fill="#1a202c">Run business</text>
+    <text x="550" y="620" text-anchor="middle" font-family="Arial, sans-serif" font-size="9" fill="#1a202c">logic in action</text>
+    
+    <rect x="630" y="580" width="120" height="50" rx="5" fill="#e53e3e"/>
+    <text x="690" y="595" text-anchor="middle" font-family="Arial, sans-serif" font-size="10" font-weight="bold" fill="#1a202c">5. ACK/NACK</text>
+    <text x="690" y="610" text-anchor="middle" font-family="Arial, sans-serif" font-size="9" fill="#1a202c">Acknowledge</text>
+    <text x="690" y="620" text-anchor="middle" font-family="Arial, sans-serif" font-size="9" fill="#1a202c">to RabbitMQ</text>
+    
+    <!-- Arrows -->
+    <defs>
+      <marker id="arrow-flow" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+        <polygon points="0 0, 10 3.5, 0 7" fill="#ed8936"/>
+      </marker>
+    </defs>
+    
+    <line x1="190" y1="605" x2="210" y2="605" stroke="#ed8936" stroke-width="2" marker-end="url(#arrow-flow)"/>
+    <line x1="330" y1="605" x2="350" y2="605" stroke="#ed8936" stroke-width="2" marker-end="url(#arrow-flow)"/>
+    <line x1="470" y1="605" x2="490" y2="605" stroke="#ed8936" stroke-width="2" marker-end="url(#arrow-flow)"/>
+    <line x1="610" y1="605" x2="630" y2="605" stroke="#ed8936" stroke-width="2" marker-end="url(#arrow-flow)"/>
+  </g>
+</svg>