feat: Implement Slack, Trello, and Courier (ShipLogic) integration

- Add 14 domain events for order lifecycle (OrderCreated, OrderPacked, ShipmentCreated, ParcelDelivered, etc.) - Create SlackNotifierService with channels for orders, design, production, shipping, ops-alerts - Create TrelloService to create cards, move cards between lists, attach files, check items - Create CourierService to integrate with ShipLogic API for shipment creation and document retrieval - Create PackingController to explicitly capture packing dimensions and weight - Create ShippingController with multi-layer guards: packing validation, payment/approval verification, idempotency - Create TrelloWebhookController to handle incoming Trello webhooks as intent signals - Create CourierWebhookController to handle Shiplogic status updates - Create event listeners for Slack notifications and Trello card updates - Create EventServiceProvider to register all events and listeners - Add database migration for packing, courier, and Trello data columns - Create config files for slack, trello, and courier integration - Update .env with integration secrets placeholders - Add routes for /orders/{id}/pack, /orders/{id}/ship, /api/webhooks/trello, /api/webhooks/courier Key architectural decisions: - Packing is explicit ops action (not automatic from status) - Shipment creation only after: Trello intent + packing confirmed + payment/approval rules met - Courier API failures keep order in Ready to Ship state (safe retry) - Trello and Slack are mirrors of backend state, not decision makers - All side effects flow through event listeners, maintaining separation of concerns
2026-01-02 13:47:31 +02:00
parent 4730f5770c
commit 12aadfd917
35 changed files with 1815 additions and 0 deletions
@@ -0,0 +1,142 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Events\ReadyToShipIntent;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Log;
+
+class TrelloWebhookController extends Controller
+{
+    /**
+     * Handle incoming Trello webhooks
+     * 
+     * POST /api/webhooks/trello
+     */
+    public function handle(Request $request)
+    {
+        // Verify webhook signature
+        $signature = $request->header('X-Trello-Webhook');
+        if (! $this->verifyWebhookSignature($request, $signature)) {
+            Log::warning('Invalid Trello webhook signature');
+
+            return response()->json(['error' => 'Invalid signature'], 401);
+        }
+
+        try {
+            $payload = $request->json()->all();
+
+            // Log webhook for debugging
+            Log::info('Trello webhook received', ['action' => $payload['action']['type'] ?? 'unknown']);
+
+            // Handle based on action type
+            match ($payload['action']['type'] ?? null) {
+                'updateCard' => $this->handleCardUpdate($payload),
+                'updateCheckItem' => $this->handleChecklistUpdate($payload),
+                default => Log::info('Unhandled Trello action', ['type' => $payload['action']['type'] ?? 'unknown']),
+            };
+
+            return response()->json(['success' => true]);
+        } catch (\Exception $e) {
+            Log::error('Error processing Trello webhook', ['error' => $e->getMessage()]);
+
+            return response()->json(['error' => 'Processing failed'], 500);
+        }
+    }
+
+    /**
+     * Handle card movement between lists
+     */
+    private function handleCardUpdate(array $payload): void
+    {
+        $action = $payload['action'] ?? [];
+        $cardId = $action['data']['card']['id'] ?? null;
+        $cardName = $action['data']['card']['name'] ?? null;
+        $listName = $action['data']['listAfter']['name'] ?? null;
+
+        if (! $cardId || ! $listName) {
+            return;
+        }
+
+        // Extract order ID from card name (e.g., "Order #1043")
+        if (! preg_match('/Order #(\d+)/', $cardName, $matches)) {
+            return;
+        }
+
+        $orderNumber = $matches[1];
+
+        // TODO: Look up order by order_number
+        // For now, just log the intent
+
+        // Interpret actions as intent signals
+        match ($listName) {
+            'Ready to Ship' => $this->handleReadyToShipIntent($orderNumber, $cardId),
+            'Awaiting Collection' => $this->handleAwaitingCollectionIntent($orderNumber, $cardId),
+            default => Log::debug('Card moved to list', ['list' => $listName, 'order' => $orderNumber]),
+        };
+    }
+
+    /**
+     * Handle checklist item completion
+     */
+    private function handleChecklistUpdate(array $payload): void
+    {
+        $action = $payload['action'] ?? [];
+        $checklistName = $action['data']['checklist']['name'] ?? null;
+        $itemName = $action['data']['checkItem']['name'] ?? null;
+        $itemState = $action['data']['checkItem']['state'] ?? null;
+
+        if ($itemState !== 'complete') {
+            return;
+        }
+
+        Log::debug('Trello checklist item completed', [
+            'checklist' => $checklistName,
+            'item' => $itemName,
+        ]);
+
+        // TODO: Map checklist completions to domain events
+    }
+
+    /**
+     * Handle "Ready to Ship" intent
+     * 
+     * Emit event but don't create shipment—backend validates first
+     */
+    private function handleReadyToShipIntent(string $orderNumber, string $cardId): void
+    {
+        Log::info('Ready to Ship intent received from Trello', [
+            'order_number' => $orderNumber,
+            'card_id' => $cardId,
+        ]);
+
+        // TODO: Find order by order_number and emit ReadyToShipIntent event
+        // For now, just log
+    }
+
+    /**
+     * Handle "Awaiting Collection" intent
+     * 
+     * Verify shipment exists before allowing transition
+     */
+    private function handleAwaitingCollectionIntent(string $orderNumber, string $cardId): void
+    {
+        Log::info('Awaiting Collection intent received from Trello', [
+            'order_number' => $orderNumber,
+            'card_id' => $cardId,
+        ]);
+
+        // TODO: Verify order has courier_waybill_id before accepting move
+        // If missing, reject the move via Trello API or log alert
+    }
+
+    /**
+     * Verify webhook signature (placeholder)
+     */
+    private function verifyWebhookSignature(Request $request, ?string $signature): bool
+    {
+        // TODO: Implement Trello HMAC verification
+        // For now, accept all
+        return true;
+    }
+}