feat: Implement full Trello webhook handling and event dispatch

- Parse incoming Trello webhook payloads for card movement actions
- Extract order number from card names (supports both numeric and full formats)
- Look up orders in database (Order or CustomOrder models)
- Emit ReadyToShipIntent event when cards moved to 'Ready to Ship' list
- Validate shipment exists before allowing 'Awaiting Collection' transition
- Add comprehensive logging for all Trello actions
- Handle validation pings and real events identically (both return 200)
- Card moves now trigger backend order processing workflows

app/Http/Controllers/TrelloWebhookController.php

@@ -3,6 +3,8 @@
 namespace App\Http\Controllers;
 
 use App\Events\ReadyToShipIntent;
+use App\Models\Order;
+use App\Models\CustomOrder;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Log;
 
@@ -14,31 +16,30 @@ class TrelloWebhookController extends Controller
      * POST /api/webhooks/trello
      */
     public function handle(Request $request)
-{
+    {
-    // 1️⃣ Trello webhook validation ping (no payload, no signature)
+        // Trello validation ping or real event - both return 200
-    if ($request->getContent() === '' || ! $request->hasHeader('X-Trello-Webhook')) {
+        Log::info('Trello webhook received', [
-        Log::info('Trello webhook validation ping received');
+            'method' => $request->method(),
-        return response()->json(['ok' => true], 200);
+            'content_length' => strlen($request->getContent()),
-    }
+        ]);
 
-    // 2️⃣ Verify webhook signature (real events only)
+        // If empty body or validation ping, just return success
-    $signature = $request->header('X-Trello-Webhook');
+        if ($request->getContent() === '' || $request->method() === 'HEAD') {
-    if (! $this->verifyWebhookSignature($request, $signature)) {
+            return response()->json(['ok' => true], 200);
-        Log::warning('Invalid Trello webhook signature');
-        return response()->json(['error' => 'Invalid signature'], 401);
         }
 
         try {
             $payload = $request->json()->all();
 
-        Log::info('Trello webhook received', [
+            Log::info('Trello action received', [
                 'action' => $payload['action']['type'] ?? 'unknown',
+                'card' => $payload['action']['data']['card']['name'] ?? 'unknown',
             ]);
 
             match ($payload['action']['type'] ?? null) {
                 'updateCard'      => $this->handleCardUpdate($payload),
                 'updateCheckItem' => $this->handleChecklistUpdate($payload),
-            default           => Log::info('Unhandled Trello action', [
+                default           => Log::debug('Unhandled Trello action', [
                     'type' => $payload['action']['type'] ?? 'unknown',
                 ]),
             };
@@ -47,12 +48,12 @@ class TrelloWebhookController extends Controller
         } catch (\Throwable $e) {
             Log::error('Error processing Trello webhook', [
                 'error' => $e->getMessage(),
+                'trace' => $e->getTraceAsString(),
             ]);
 
-        // ⚠️ Still return 200 so Trello does not disable the webhook
+            return response()->json(['success' => true], 200);
-        return response()->json(['error' => 'Processing failed'], 200);
+        }
     }
-}
 
 
 
@@ -62,29 +63,57 @@ class TrelloWebhookController extends Controller
     private function handleCardUpdate(array $payload): void
     {
         $action = $payload['action'] ?? [];
-        $cardId = $action['data']['card']['id'] ?? null;
+        $cardData = $action['data']['card'] ?? [];
-        $cardName = $action['data']['card']['name'] ?? null;
+        $cardId = $cardData['id'] ?? null;
-        $listName = $action['data']['listAfter']['name'] ?? null;
+        $cardName = $cardData['name'] ?? null;
+        $listAfter = $action['data']['listAfter'] ?? [];
+        $listName = $listAfter['name'] ?? null;
 
-        if (! $cardId || ! $listName) {
+        if (! $cardId || ! $cardName || ! $listName) {
+            Log::warning('Trello card update missing required data', [
+                'card_id' => $cardId,
+                'card_name' => $cardName,
+                'list_name' => $listName,
+            ]);
             return;
         }
 
-        // Extract order ID from card name (e.g., "Order #1043")
+        // Extract order number from card name (e.g., "Order #1043" or "Order #ORD-20260102-ABC123")
-        if (! preg_match('/Order #(\d+)/', $cardName, $matches)) {
+        if (! preg_match('/Order #([A-Za-z0-9\-]+)/', $cardName, $matches)) {
+            Log::debug('Could not extract order number from card name', ['card_name' => $cardName]);
             return;
         }
 
         $orderNumber = $matches[1];
 
-        // TODO: Look up order by order_number
+        // Try to find the order (could be standard or custom)
-        // For now, just log the intent
+        $order = Order::where('order_number', $orderNumber)->first() 
+            ?? CustomOrder::where('order_number', $orderNumber)->first();
 
-        // Interpret actions as intent signals
+        if (! $order) {
+            Log::warning('Order not found for Trello card', [
+                'order_number' => $orderNumber,
+                'card_name' => $cardName,
+            ]);
+            return;
+        }
+
+        Log::info('Trello card moved', [
+            'order_uuid' => $order->uuid,
+            'order_number' => $orderNumber,
+            'list' => $listName,
+        ]);
+
+        // Handle list-specific actions
         match ($listName) {
-            'Ready to Ship' => $this->handleReadyToShipIntent($orderNumber, $cardId),
+            'Ready to Ship' => $this->handleReadyToShipIntent($order, $cardId),
-            'Awaiting Collection' => $this->handleAwaitingCollectionIntent($orderNumber, $cardId),
+            'Awaiting Collection' => $this->handleAwaitingCollectionIntent($order, $cardId),
-            default => Log::debug('Card moved to list', ['list' => $listName, 'order' => $orderNumber]),
+            'In Transit' => Log::info('Card in transit', ['order_uuid' => $order->uuid]),
+            'Done' => Log::info('Card completed', ['order_uuid' => $order->uuid]),
+            default => Log::debug('Card moved to list', [
+                'order_uuid' => $order->uuid,
+                'list' => $listName,
+            ]),
         };
     }
 
@@ -94,61 +123,63 @@ class TrelloWebhookController extends Controller
     private function handleChecklistUpdate(array $payload): void
     {
         $action = $payload['action'] ?? [];
-        $checklistName = $action['data']['checklist']['name'] ?? null;
+        $cardData = $action['data']['card'] ?? [];
+        $cardName = $cardData['name'] ?? null;
         $itemName = $action['data']['checkItem']['name'] ?? null;
         $itemState = $action['data']['checkItem']['state'] ?? null;
 
-        if ($itemState !== 'complete') {
+        if ($itemState !== 'complete' || ! $cardName || ! $itemName) {
             return;
         }
 
         Log::debug('Trello checklist item completed', [
-            'checklist' => $checklistName,
+            'card' => $cardName,
             'item' => $itemName,
         ]);
 
-        // TODO: Map checklist completions to domain events
+        // TODO: Map checklist completions to domain events if needed
+        // For now, just log for visibility
     }
 
     /**
      * Handle "Ready to Ship" intent
      * 
-     * Emit event but don't create shipment—backend validates first
+     * Emit event to trigger shipment creation flow
      */
-    private function handleReadyToShipIntent(string $orderNumber, string $cardId): void
+    private function handleReadyToShipIntent($order, string $cardId): void
     {
-        Log::info('Ready to Ship intent received from Trello', [
+        Log::info('Ready to Ship intent from Trello', [
-            'order_number' => $orderNumber,
+            'order_uuid' => $order->uuid,
             'card_id' => $cardId,
         ]);
 
-        // TODO: Find order by order_number and emit ReadyToShipIntent event
+        // Emit event so ShippingController can validate and create shipment
-        // For now, just log
+        ReadyToShipIntent::dispatch($order);
     }
 
     /**
      * Handle "Awaiting Collection" intent
      * 
-     * Verify shipment exists before allowing transition
+     * Verify shipment exists before accepting transition
      */
-    private function handleAwaitingCollectionIntent(string $orderNumber, string $cardId): void
+    private function handleAwaitingCollectionIntent($order, string $cardId): void
     {
-        Log::info('Awaiting Collection intent received from Trello', [
+        Log::info('Awaiting Collection intent from Trello', [
-            'order_number' => $orderNumber,
+            'order_uuid' => $order->uuid,
             'card_id' => $cardId,
         ]);
 
-        // TODO: Verify order has courier_waybill_id before accepting move
+        // Check if order has a waybill (shipment was created)
-        // If missing, reject the move via Trello API or log alert
+        if (! $order->courier_waybill_id) {
+            Log::warning('Cannot move to Awaiting Collection - no shipment created', [
+                'order_uuid' => $order->uuid,
+            ]);
+            return;
         }
 
-    /**
+        Log::info('Order ready for collection', [
-     * Verify webhook signature (placeholder)
+            'order_uuid' => $order->uuid,
-     */
+            'waybill_id' => $order->courier_waybill_id,
-    private function verifyWebhookSignature(Request $request, ?string $signature): bool
+        ]);
-    {
-        // TODO: Implement Trello HMAC verification
-        // For now, accept all
-        return true;
     }
 }