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.

src/Framework/Design/Analyzer/DesignSystemAnalysis.php

@@ -5,7 +5,7 @@ declare(strict_types=1);
 namespace App\Framework\Design\Analyzer;
 
 use App\Framework\Design\ValueObjects\CssParseResult;
-use App\Framework\Filesystem\FilePath;
+use App\Framework\Filesystem\ValueObjects\FilePath;
 
 /**
  * Vollständige Design System Analyse - Haupt-Ergebnis-Klasse

src/Framework/Design/Analyzer/DesignSystemAnalyzer.php

@@ -6,7 +6,7 @@ namespace App\Framework\Design\Analyzer;
 
 use App\Framework\Design\Parser\CssParser;
 use App\Framework\Design\ValueObjects\CssParseResult;
-use App\Framework\Filesystem\FilePath;
+use App\Framework\Filesystem\ValueObjects\FilePath;
 
 /**
  * Haupt-Analyzer für das Design System

src/Framework/Design/ComponentScanner.php

@@ -9,7 +9,7 @@ use App\Framework\Design\Component\ComponentCategory;
 use App\Framework\Design\Component\ComponentPattern;
 use App\Framework\Design\Component\ComponentRegistry;
 use App\Framework\Design\Component\ComponentState;
-use App\Framework\Filesystem\FilePath;
+use App\Framework\Filesystem\ValueObjects\FilePath;
 
 /**
  * Scans CSS files to detect and catalog UI components

src/Framework/Design/Parser/CssParseResult.php

@@ -4,7 +4,7 @@ declare(strict_types=1);
 
 namespace App\Framework\Design\Parser;
 
-use App\Framework\Filesystem\FilePath;
+use App\Framework\Filesystem\ValueObjects\FilePath;
 
 /**
  * Ergebnis eines CSS-Parsing-Vorgangs

src/Framework/Design/Parser/CssParser.php

@@ -7,7 +7,7 @@ namespace App\Framework\Design\Parser;
 use App\Framework\Design\ValueObjects\CssProperty;
 use App\Framework\Design\ValueObjects\CssRule;
 use App\Framework\Design\ValueObjects\CssSelector;
-use App\Framework\Filesystem\FilePath;
+use App\Framework\Filesystem\ValueObjects\FilePath;
 
 /**
  * Parst CSS-Dateien und extrahiert Regeln, Selektoren und Properties

src/Framework/Design/Service/DesignSystemAnalyzer.php

@@ -7,7 +7,7 @@ namespace App\Framework\Design\Service;
 use App\Framework\Design\Parser\CssParser;
 use App\Framework\Design\Parser\CssParseResult;
 use App\Framework\Design\ValueObjects\DesignSystemAnalysis;
-use App\Framework\Filesystem\FilePath;
+use App\Framework\Filesystem\ValueObjects\FilePath;
 
 /**
  * Design System Analyzer Service

src/Framework/Design/Theme.php

@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design;
+
+use App\Framework\Design\ValueObjects\ThemeMode;
+
+/**
+ * Theme Interface
+ *
+ * Generic interface for theme implementations across the framework.
+ * Allows different parts of the application (Admin, Frontend, Emails, etc.)
+ * to implement consistent theme switching and management.
+ */
+interface Theme
+{
+    /**
+     * Get the current theme mode
+     */
+    public function getMode(): ThemeMode;
+
+    /**
+     * Get data-theme attribute value for HTML
+     */
+    public function toDataAttribute(): string;
+
+    /**
+     * Get CSS class for theme
+     */
+    public function toCssClass(): string;
+
+    /**
+     * Check if theme requires JavaScript preference detection
+     */
+    public function requiresPreferenceDetection(): bool;
+
+    /**
+     * Get storage key for persisting theme preference
+     */
+    public function getStorageKey(): string;
+
+    /**
+     * Serialize theme for JSON storage
+     */
+    public function toJson(): string;
+
+    /**
+     * Check equality with another theme
+     */
+    public function equals(self $other): bool;
+
+    /**
+     * Get string representation
+     */
+    public function toString(): string;
+}

src/Framework/Design/ValueObjects/CssParseResult.php

@@ -4,7 +4,7 @@ declare(strict_types=1);
 
 namespace App\Framework\Design\ValueObjects;
 
-use App\Framework\Filesystem\FilePath;
+use App\Framework\Filesystem\ValueObjects\FilePath;
 
 /**
  * Ergebnis des CSS-Parsing-Prozesses

src/Framework/Design/ValueObjects/ThemeMode.php

@@ -0,0 +1,53 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Design\ValueObjects;
+
+/**
+ * Theme Mode Enum
+ *
+ * Generic theme mode for any themeable component in the framework.
+ * Supports light, dark, and automatic (system preference) modes.
+ */
+enum ThemeMode: string
+{
+    case LIGHT = 'light';
+    case DARK = 'dark';
+    case AUTO = 'auto';
+
+    public function isLight(): bool
+    {
+        return $this === self::LIGHT;
+    }
+
+    public function isDark(): bool
+    {
+        return $this === self::DARK;
+    }
+
+    public function isAuto(): bool
+    {
+        return $this === self::AUTO;
+    }
+
+    /**
+     * Get CSS data-theme attribute value
+     */
+    public function toDataAttribute(): string
+    {
+        return match ($this) {
+            self::LIGHT => 'light',
+            self::DARK => 'dark',
+            self::AUTO => '', // No attribute for auto mode
+        };
+    }
+
+    /**
+     * Get CSS class name
+     */
+    public function toCssClass(string $prefix = 'theme'): string
+    {
+        return "{$prefix}-{$this->value}";
+    }
+}