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/Http/MiddlewareManager.php

@@ -12,6 +12,7 @@ use App\Framework\Http\Middlewares\DDoSProtectionMiddleware;
 use App\Framework\Http\Middlewares\RateLimitMiddleware;
 use App\Framework\Http\Middlewares\WafMiddleware;
 use App\Framework\Logging\Logger;
+use App\Framework\Logging\ValueObjects\LogContext;
 use App\Framework\Reflection\ReflectionProvider;
 
 final readonly class MiddlewareManager implements MiddlewareManagerInterface
@@ -26,7 +27,19 @@ final readonly class MiddlewareManager implements MiddlewareManagerInterface
     ) {
         $middlewares = $this->buildMiddlewareStack();
 
-        error_log("MiddlewareManager: Middleware stack: " . implode(', ', array_map(fn ($m) => basename($m), $middlewares)));
+        // Debug logging mit strukturiertem Logger falls verfügbar
+        if ($this->container->has(Logger::class)) {
+            try {
+                $logger = $this->container->get(Logger::class);
+                $logger->debug('Middleware stack initialized', LogContext::withData([
+                    'middleware_count' => count($middlewares),
+                    'middleware_stack' => array_map(fn ($m) => basename($m), $middlewares),
+                    'component' => 'MiddlewareManager',
+                ]));
+            } catch (\Throwable $e) {
+                // Ignore logger errors during initialization
+            }
+        }
 
         $this->chain = new HttpMiddlewareChain(
             $middlewares,