Enable Discovery debug logging for production troubleshooting

- Add DISCOVERY_LOG_LEVEL=debug - Add DISCOVERY_SHOW_PROGRESS=true - Temporary changes for debugging InitializerProcessor fixes on production
2025-08-11 20:13:26 +02:00
parent 59fd3dd3b1
commit 55a330b223
3683 changed files with 2956207 additions and 16948 deletions
--- a/docs/spa-router-backend-integration.md
+++ b/docs/spa-router-backend-integration.md
@@ -0,0 +1,126 @@
+# SPA Router Backend Integration
+
+Das SPA Router System benötigt Backend-Unterstützung, um nur den `<main>` Content für AJAX-Requests zu liefern.
+
+## HTTP Headers
+
+Das SPA System sendet diese Headers bei Navigation:
+
+```http
+X-Requested-With: XMLHttpRequest
+X-SPA-Request: true
+Accept: text/html
+```
+
+## Backend Implementation
+
+### Option 1: Separate SPA Views
+
+```php
+// In your controller
+public function showContact(HttpRequest $request): HttpResponse 
+{
+    $data = [
+        'title' => 'Kontakt',
+        // ... other data
+    ];
+    
+    // Check if this is an SPA request
+    if ($request->headers->get('X-SPA-Request') === 'true') {
+        // Return only the main content
+        return new ViewResult('contact-spa.view.php', $data);
+    }
+    
+    // Return full page
+    return new ViewResult('contact.view.php', $data);
+}
+```
+
+### Option 2: Template Fragments
+
+```php
+// Create a partial template system
+public function showContact(HttpRequest $request): HttpResponse 
+{
+    $data = [
+        'title' => 'Kontakt',
+        'content' => $this->renderPartial('contact-main.view.php')
+    ];
+    
+    if ($request->headers->get('X-SPA-Request') === 'true') {
+        // Return only main content as JSON
+        return new JsonResult([
+            'title' => $data['title'],
+            'content' => $data['content']
+        ]);
+    }
+    
+    return new ViewResult('contact.view.php', $data);
+}
+```
+
+### Option 3: Layout Conditional (Recommended)
+
+Modify your main layout to conditionally include header/footer:
+
+```php
+// main.view.php layout
+<?php 
+$isSPARequest = $request->headers->get('X-SPA-Request') === 'true';
+?>
+
+<?php if (!$isSPARequest): ?>
+<!DOCTYPE html>
+<html>
+<head>
+    <title><?= $title ?></title>
+    <!-- head content -->
+</head>
+<body>
+    <header>
+        <!-- header content -->
+    </header>
+<?php endif; ?>
+
+    <main>
+        <!-- This is what gets sent for SPA requests -->
+        <?= $content ?>
+    </main>
+
+<?php if (!$isSPARequest): ?>
+    <footer>
+        <!-- footer content -->
+    </footer>
+    
+    <!-- scripts -->
+</body>
+</html>
+<?php endif; ?>
+```
+
+## Testing
+
+Test SPA requests with curl:
+
+```bash
+# Normal request (full page)
+curl https://localhost/kontakt
+
+# SPA request (only main content)
+curl -H "X-SPA-Request: true" -H "X-Requested-With: XMLHttpRequest" https://localhost/kontakt
+```
+
+## Error Handling
+
+Das Frontend fällt automatisch auf normale Navigation zurück wenn:
+- HTTP Status >= 400
+- Network Fehler
+- Parse Fehler
+- Timeout
+
+## Performance Considerations
+
+- SPA Requests sind ~70% kleiner (nur Content, kein Header/Footer/Scripts)
+- Reduzierte Server-Last durch weniger Asset-Requests
+- Schnellere Navigation durch weniger DOM-Updates
+- Browser-Cache wird optimal genutzt