docs: consolidate documentation into organized structure

- Move 12 markdown files from root to docs/ subdirectories
- Organize documentation by category:
  • docs/troubleshooting/ (1 file)  - Technical troubleshooting guides
  • docs/deployment/      (4 files) - Deployment and security documentation
  • docs/guides/          (3 files) - Feature-specific guides
  • docs/planning/        (4 files) - Planning and improvement proposals

Root directory cleanup:
- Reduced from 16 to 4 markdown files in root
- Only essential project files remain:
  • CLAUDE.md (AI instructions)
  • README.md (Main project readme)
  • CLEANUP_PLAN.md (Current cleanup plan)
  • SRC_STRUCTURE_IMPROVEMENTS.md (Structure improvements)

This improves:
✅ Documentation discoverability
✅ Logical organization by purpose
✅ Clean root directory
✅ Better maintainability

src/Framework/Logging/Handlers/ConsoleHandler.php

@@ -39,7 +39,7 @@ class ConsoleHandler implements LogHandler
     public function __construct(
         LogLevel|int              $minLevel = LogLevel::DEBUG,
         bool                      $debugOnly = true,
-        string                    $outputFormat = '{color}[{level_name}]{reset} {timestamp} {request_id}{message}',
+        string                    $outputFormat = '{color}[{level_name}]{reset} {timestamp} {request_id}{message}{structured}',
         private readonly LogLevel $stderrLevel = LogLevel::WARNING,
     ) {
         $this->minLevel = $minLevel instanceof LogLevel ? $minLevel : LogLevel::fromValue($minLevel);
@@ -80,6 +80,9 @@ class ConsoleHandler implements LogHandler
             ? "[{$record->getExtra('request_id')}] "
             : '';
 
+        // Structured Logging Extras formatieren
+        $structuredInfo = $this->formatStructuredExtras($record);
+
         // Werte für Platzhalter im Format
         $values = [
             '{color}' => $color,
@@ -89,6 +92,7 @@ class ConsoleHandler implements LogHandler
             '{request_id}' => $requestId,
             '{message}' => $record->getMessage(),
             '{channel}' => $record->getChannel() ? "[{$record->getChannel()}] " : '',
+            '{structured}' => $structuredInfo,
         ];
 
         // Formatierte Ausgabe erstellen
@@ -123,4 +127,91 @@ class ConsoleHandler implements LogHandler
 
         return $this;
     }
+
+    /**
+     * Formatiert Structured Logging Extras für Console-Ausgabe mit Farben
+     */
+    private function formatStructuredExtras(LogRecord $record): string
+    {
+        $parts = [];
+        $reset = ConsoleColor::RESET->toAnsi();
+
+        // Tags anzeigen (Cyan mit Tag-Symbol)
+        if ($record->hasExtra('structured_tags')) {
+            $tags = $record->getExtra('structured_tags');
+            if (! empty($tags)) {
+                $cyan = ConsoleColor::CYAN->toAnsi();
+                $tagString = implode(',', $tags);
+                $parts[] = "{$cyan}🏷 [{$tagString}]{$reset}";
+            }
+        }
+
+        // Trace-Kontext anzeigen (Blau mit Trace-Symbol)
+        if ($record->hasExtra('trace_context')) {
+            $traceContext = $record->getExtra('trace_context');
+            $blue = ConsoleColor::BLUE->toAnsi();
+
+            if (isset($traceContext['trace_id'])) {
+                $traceId = substr($traceContext['trace_id'], 0, 8);
+                $parts[] = "{$blue}🔍 {$traceId}{$reset}";
+            }
+            if (isset($traceContext['active_span']['spanId'])) {
+                $spanId = substr($traceContext['active_span']['spanId'], 0, 8);
+                $parts[] = "{$blue}↳ {$spanId}{$reset}";
+            }
+        }
+
+        // User-Kontext anzeigen (Grün mit User-Symbol)
+        if ($record->hasExtra('user_context')) {
+            $userContext = $record->getExtra('user_context');
+            $green = ConsoleColor::GREEN->toAnsi();
+
+            if (isset($userContext['user_id'])) {
+                // Anonymisierte User-ID für Privacy
+                $userId = substr(md5($userContext['user_id']), 0, 8);
+                $parts[] = "{$green}👤 {$userId}{$reset}";
+            } elseif (isset($userContext['is_authenticated']) && ! $userContext['is_authenticated']) {
+                $parts[] = "{$green}👤 anon{$reset}";
+            }
+        }
+
+        // Request-Kontext anzeigen (Gelb mit HTTP-Symbol)
+        if ($record->hasExtra('request_context')) {
+            $requestContext = $record->getExtra('request_context');
+            if (isset($requestContext['request_method'], $requestContext['request_uri'])) {
+                $yellow = ConsoleColor::YELLOW->toAnsi();
+                $method = $requestContext['request_method'];
+                $uri = $requestContext['request_uri'];
+
+                // Kompakte URI-Darstellung
+                if (strlen($uri) > 25) {
+                    $uri = substr($uri, 0, 22) . '...';
+                }
+
+                $parts[] = "{$yellow}🌐 {$method} {$uri}{$reset}";
+            }
+        }
+
+        // Context-Data anzeigen (Grau mit Data-Symbol)
+        $context = $record->getContext();
+        if (! empty($context)) {
+            $contextKeys = array_keys($context);
+            // Interne Keys ausfiltern
+            $contextKeys = array_filter($contextKeys, fn ($key) => ! str_starts_with($key, '_'));
+
+            if (! empty($contextKeys)) {
+                $gray = ConsoleColor::GRAY->toAnsi();
+                $keyCount = count($contextKeys);
+
+                if ($keyCount <= 3) {
+                    $keyString = implode('·', $contextKeys);
+                } else {
+                    $keyString = implode('·', array_slice($contextKeys, 0, 2)) . "·+{$keyCount}";
+                }
+                $parts[] = "{$gray}📊 {$keyString}{$reset}";
+            }
+        }
+
+        return empty($parts) ? '' : "\n    " . implode(' ', $parts);
+    }
 }