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/View/Processors/AssetInjector.php

@@ -8,6 +8,7 @@ use App\Framework\Core\PathProvider;
 use App\Framework\Template\Processing\DomProcessor;
 use App\Framework\View\DomHeadService;
 use App\Framework\View\DomWrapper;
+use App\Framework\View\Exceptions\TemplateProcessorException;
 use App\Framework\View\RenderContext;
 
 final class AssetInjector implements DomProcessor
@@ -25,9 +26,8 @@ final class AssetInjector implements DomProcessor
 
         #$manifestPath = dirname(__DIR__, 3) . '../public/.vite/manifest.json';
 
-
         if (! is_file($manifestPath)) {
-            throw new \RuntimeException("Vite manifest not found: $manifestPath");
+            throw TemplateProcessorException::manifestNotFound($manifestPath);
         }
         $json = file_get_contents($manifestPath);
 
@@ -36,36 +36,43 @@ final class AssetInjector implements DomProcessor
 
     public function process(DomWrapper $dom, RenderContext $context): DomWrapper
     {
+        // Skip if this is a partial render (e.g. component)
+        if ($context->isPartial ?? false) {
+            return $dom;
+        }
+
         // JS-Key, wie im Manifest unter "resources/js/main.js"
         $jsKey = 'resources/js/main.js';
-        // CSS-Key, wie im Manifest unter "resources/css/styles.css"
-        $cssKey = 'resources/css/styles.css';
 
-        #$head = $dom->getElementsByTagName('head')->item(0);
-        $head = $dom->document->head;
-        $insertParent = $head ?: $dom->document->getElementsByTagName('body')->item(0) ?: $dom->document->documentElement;
+        // Debug: Log what we have in manifest
+        error_log("AssetInjector: Processing with manifest: " . json_encode($this->manifest));
 
-        // --- CSS, wie von Vite empfohlen: Feld "css" beim js-Eintrag! ---
+        // Check if we have the JS key in manifest
+        if (! isset($this->manifest[$jsKey])) {
+            error_log("AssetInjector: Key '$jsKey' not found in manifest!");
+
+            return $dom;
+        }
+
+        // Debug: Log the CSS array
+        if (isset($this->manifest[$jsKey]['css'])) {
+            error_log("AssetInjector: CSS array found: " . json_encode($this->manifest[$jsKey]['css']));
+        } else {
+            error_log("AssetInjector: No CSS array in manifest entry!");
+        }
+
+        // Use DomHeadService instead of direct manipulation
         if (! empty($this->manifest[$jsKey]['css']) && is_array($this->manifest[$jsKey]['css'])) {
             foreach ($this->manifest[$jsKey]['css'] as $cssFile) {
-
+                error_log("AssetInjector: Adding CSS file: " . $cssFile);
                 $this->headService->addStylesheet($dom, '/' . ltrim($cssFile, '/'));
-
-                /*$link = $dom->document->createElement('link');
-                $link->setAttribute('rel', 'stylesheet');
-                $link->setAttribute('href', '/' . ltrim($cssFile, '/'));
-                $insertParent->appendChild($link);*/
             }
         }
 
         // --- JS Main Script ---
         if (isset($this->manifest[$jsKey]['file']) && str_ends_with($this->manifest[$jsKey]['file'], '.js')) {
-
+            error_log("AssetInjector: Adding JS file: " . $this->manifest[$jsKey]['file']);
             $this->headService->addScript($dom, '/' . ltrim($this->manifest[$jsKey]['file'], '/'));
-            /*$script = $dom->document->createElement('script');
-            $script->setAttribute('src', '/' . ltrim($this->manifest[$jsKey]['file'], '/'));
-            $script->setAttribute('type', 'module');
-            $insertParent->appendChild($script);*/
         }
 
         return $dom;