feat(Production): Complete production deployment infrastructure

- Add comprehensive health check system with multiple endpoints
- Add Prometheus metrics endpoint
- Add production logging configurations (5 strategies)
- Add complete deployment documentation suite:
  * QUICKSTART.md - 30-minute deployment guide
  * DEPLOYMENT_CHECKLIST.md - Printable verification checklist
  * DEPLOYMENT_WORKFLOW.md - Complete deployment lifecycle
  * PRODUCTION_DEPLOYMENT.md - Comprehensive technical reference
  * production-logging.md - Logging configuration guide
  * ANSIBLE_DEPLOYMENT.md - Infrastructure as Code automation
  * README.md - Navigation hub
  * DEPLOYMENT_SUMMARY.md - Executive summary
- Add deployment scripts and automation
- Add DEPLOYMENT_PLAN.md - Concrete plan for immediate deployment
- Update README with production-ready features

All production infrastructure is now complete and ready for deployment.

tests/debug/test-email-queue.php

@@ -4,10 +4,10 @@ declare(strict_types=1);
 
 require_once __DIR__ . '/../bootstrap.php';
 
-use App\Framework\Queue\Wrappers\EmailQueue;
+use App\Framework\Core\ValueObjects\Duration;
 use App\Framework\Queue\InMemoryQueue;
 use App\Framework\Queue\ValueObjects\QueuePriority;
-use App\Framework\Core\ValueObjects\Duration;
+use App\Framework\Queue\Wrappers\EmailQueue;
 
 // Example Email Classes für Tests
 class WelcomeEmail
@@ -15,7 +15,8 @@ class WelcomeEmail
     public function __construct(
         public string $recipient,
         public string $userName
-    ) {}
+    ) {
+    }
 }
 
 class TransactionalOrderConfirmationEmail
@@ -24,7 +25,8 @@ class TransactionalOrderConfirmationEmail
         public string $recipient,
         public string $orderId,
         public float $total
-    ) {}
+    ) {
+    }
 }
 
 class MarketingNewsletterEmail
@@ -32,7 +34,8 @@ class MarketingNewsletterEmail
     public function __construct(
         public string $recipient,
         public string $campaignId
-    ) {}
+    ) {
+    }
 }
 
 class SystemAdminAlertEmail
@@ -41,7 +44,8 @@ class SystemAdminAlertEmail
         public string $recipient,
         public string $alertMessage,
         public string $severity
-    ) {}
+    ) {
+    }
 }
 
 class BulkPromotionEmail
@@ -50,7 +54,8 @@ class BulkPromotionEmail
         public string $recipient,
         public string $promoCode,
         public float $discount
-    ) {}
+    ) {
+    }
 }
 
 class CriticalSecurityNotificationEmail
@@ -58,7 +63,8 @@ class CriticalSecurityNotificationEmail
     public function __construct(
         public string $recipient,
         public string $securityIssue
-    ) {}
+    ) {
+    }
 }
 
 class ReminderFollowUpEmail
@@ -66,7 +72,8 @@ class ReminderFollowUpEmail
     public function __construct(
         public string $recipient,
         public string $taskId
-    ) {}
+    ) {
+    }
 }
 
 class InvoiceEmail
@@ -74,7 +81,8 @@ class InvoiceEmail
     public function __construct(
         public string $recipient,
         public string $invoiceNumber
-    ) {}
+    ) {
+    }
 }
 
 echo "📧 Testing EmailQueue Implementation\n";
@@ -93,7 +101,7 @@ $emailQueue->pushEmail($welcomeEmail);
 $emailQueue->pushEmail($orderEmail);
 
 assert($emailQueue->size() === 2, "❌ Queue size should be 2");
-assert(!$emailQueue->isEmpty(), "❌ Queue should not be empty");
+assert(! $emailQueue->isEmpty(), "❌ Queue should not be empty");
 
 $poppedEmail = $emailQueue->popEmail();
 assert($poppedEmail instanceof WelcomeEmail || $poppedEmail instanceof TransactionalOrderConfirmationEmail, "❌ Should pop valid email");
@@ -169,7 +177,7 @@ $emails = [
     new WelcomeEmail('batch1@example.com', 'User 1'),
     new WelcomeEmail('batch2@example.com', 'User 2'),
     new TransactionalOrderConfirmationEmail('batch3@example.com', 'order-batch', 75.00),
-    new MarketingNewsletterEmail('batch4@example.com', 'batch-campaign')
+    new MarketingNewsletterEmail('batch4@example.com', 'batch-campaign'),
 ];
 
 // Test batch push
@@ -194,7 +202,7 @@ $smartEmails = [
     new SystemAdminAlertEmail('auto-admin@example.com', 'Auto alert', 'info'),
     new BulkPromotionEmail('auto-bulk@example.com', 'AUTO10', 10.0),
     new CriticalSecurityNotificationEmail('auto-critical@example.com', 'Auto security issue'),
-    new InvoiceEmail('auto-invoice@example.com', 'INV-001')
+    new InvoiceEmail('auto-invoice@example.com', 'INV-001'),
 ];
 
 $emailQueue->pushSmartBatch($smartEmails);
@@ -216,7 +224,7 @@ $emailQueue->pushMarketingEmail(new MarketingNewsletterEmail('stats-marketing@ex
 $stats = $emailQueue->getStats();
 assert($stats['type'] === 'email', "❌ Stats should indicate email type");
 assert($stats['size'] === 2, "❌ Stats should show correct size");
-assert(!$stats['is_empty'], "❌ Stats should show queue is not empty");
+assert(! $stats['is_empty'], "❌ Stats should show queue is not empty");
 
 echo "✅ Email statistics work correctly\n\n";
 
@@ -250,7 +258,7 @@ $emailQueue->clear();
 $bulkEmails = [
     new BulkPromotionEmail('bulk1@example.com', 'BULK1', 5.0),
     new BulkPromotionEmail('bulk2@example.com', 'BULK2', 10.0),
-    new BulkPromotionEmail('bulk3@example.com', 'BULK3', 15.0)
+    new BulkPromotionEmail('bulk3@example.com', 'BULK3', 15.0),
 ];
 
 $interval = Duration::fromMinutes(5);
@@ -260,7 +268,7 @@ assert($emailQueue->size() === 3, "❌ Should have 3 bulk emails");
 
 // Check that delays are applied correctly by collecting all payloads
 $payloads = [];
-while (!$emailQueue->isEmpty()) {
+while (! $emailQueue->isEmpty()) {
     $payload = $emailQueue->popEmailWithMetadata();
     if ($payload !== null) {
         $payloads[] = $payload;
@@ -270,7 +278,7 @@ while (!$emailQueue->isEmpty()) {
 assert(count($payloads) === 3, "❌ Should have 3 payloads");
 
 // Sort payloads by delay to verify rate limiting
-usort($payloads, fn($a, $b) => $a->delay->toSeconds() <=> $b->delay->toSeconds());
+usort($payloads, fn ($a, $b) => $a->delay->toSeconds() <=> $b->delay->toSeconds());
 
 assert($payloads[0]->delay->toSeconds() === 0.0, "❌ First email should have no delay");
 assert($payloads[1]->delay->toSeconds() === 300.0, "❌ Second email should have 5-minute delay");
@@ -332,4 +340,4 @@ assert($payload->metadata->hasTag('email'), "❌ Metadata should have 'email' ta
 echo "✅ Email metadata integration works correctly\n\n";
 
 echo "🎉 ALL EMAIL QUEUE TESTS PASSED!\n";
-echo "✨ EmailQueue wrapper is ready for production use!\n";
+echo "✨ EmailQueue wrapper is ready for production use!\n";