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

@@ -4,21 +4,65 @@ declare(strict_types=1);
 
 namespace App\Framework\Logging;
 
+use App\Framework\Logging\ValueObjects\LogContext;
+
 interface Logger
 {
-    public function debug(string $message, array $context = []): void;
+    public function debug(string $message, ?LogContext $context = null): void;
 
-    public function info(string $message, array $context = []): void;
+    public function info(string $message, ?LogContext $context = null): void;
 
-    public function notice(string $message, array $context = []): void;
+    public function notice(string $message, ?LogContext $context = null): void;
 
-    public function warning(string $message, array $context = []): void;
+    public function warning(string $message, ?LogContext $context = null): void;
 
-    public function error(string $message, array $context = []): void;
+    public function error(string $message, ?LogContext $context = null): void;
 
-    public function critical(string $message, array $context = []): void;
+    public function critical(string $message, ?LogContext $context = null): void;
 
-    public function alert(string $message, array $context = []): void;
+    public function alert(string $message, ?LogContext $context = null): void;
 
-    public function emergency(string $message, array $context = []): void;
+    public function emergency(string $message, ?LogContext $context = null): void;
+
+    /**
+     * Log mit beliebigem Level
+     */
+    public function log(LogLevel $level, string $message, ?LogContext $context = null): void;
+
+    /**
+     * Log in einen spezifischen Channel
+     *
+     * @internal Wird von ChannelLogger verwendet
+     */
+    public function logToChannel(LogChannel $channel, LogLevel $level, string $message, ?LogContext $context = null): void;
+
+    /**
+     * Security Channel Logger
+     * für Sicherheitsereignisse und Authentifizierung
+     */
+    public ChannelLogger $security {get;}
+
+    /**
+     * Cache Channel Logger
+     * für Cache-Operationen und Debugging
+     */
+    public ChannelLogger $cache {get;}
+
+    /**
+     * Database Channel Logger
+     * für Datenbankabfragen und -operationen
+     */
+    public ChannelLogger $database {get;}
+
+    /**
+     * Framework Channel Logger
+     * für Framework-Interna und Debugging
+     */
+    public ChannelLogger $framework {get;}
+
+    /**
+     * Error Channel Logger
+     * für Error-spezifische Logs
+     */
+    public ChannelLogger $error {get;}
 }