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/ProcessorManager.php

@@ -19,9 +19,10 @@ final readonly class ProcessorManager
 
     public function addProcessor(LogProcessor $processor): self
     {
-        $processors = $this->sortProcessors($processor, ...$this->processors);
+        $allProcessors = [...$this->processors, $processor];
+        $sorted = $this->sortProcessorsList($allProcessors);
 
-        return new self(...$processors);
+        return new self(...$sorted);
     }
 
     /**
@@ -50,6 +51,18 @@ final readonly class ProcessorManager
         return $processors;
     }
 
+    /**
+     * Sortiert eine Liste von Processors
+     */
+    private function sortProcessorsList(array $processors): array
+    {
+        usort($processors, function (LogProcessor $a, LogProcessor $b) {
+            return $b->getPriority() <=> $a->getPriority(); // Absteigend sortieren
+        });
+
+        return $processors;
+    }
+
     /**
      * Gibt alle registrierten Processors zurück
      *