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

fix_admin_layout.sh

@@ -0,0 +1,40 @@
+#!/bin/bash
+
+# Script to fix AdminLayoutProcessor usage across all admin controllers
+# Replaces primitive obsession with proper Value Object pattern
+
+files=(
+    "src/Application/Admin/Content/ImageManagerController.php"
+    "src/Application/Admin/Content/ImageSlotsController.php"
+    "src/Application/Admin/Analytics/AnalyticsController.php"
+    "src/Application/Admin/System/HealthController.php"
+    "src/Application/Admin/System/PhpInfoController.php"
+    "src/Application/Admin/System/EnvironmentController.php"
+    "src/Application/Admin/System/PerformanceController.php"
+    "src/Application/Admin/Development/WafTestController.php"
+    "src/Application/Admin/Development/DesignSystemController.php"
+    "src/Application/Admin/Development/StyleguideController.php"
+    "src/Application/Admin/Development/RoutesController.php"
+    "src/Application/Admin/Infrastructure/ServicesController.php"
+    "src/Application/Admin/Infrastructure/CacheMetricsController.php"
+    "src/Application/Admin/Infrastructure/LogViewerController.php"
+    "src/Application/Admin/Infrastructure/RedisController.php"
+)
+
+for file in "${files[@]}"; do
+    if [ -f "$file" ]; then
+        echo "Fixing $file..."
+
+        # Replace the method call pattern
+        sed -i 's/\$layoutData = \$this->layoutProcessor->processAdminLayout(\$data);/\$finalData = \$this->layoutProcessor->processLayoutFromArray(\$data);/g' "$file"
+
+        # Replace the ViewResult data pattern
+        sed -i 's/data: array_merge(\$layoutData, \$data)/data: \$finalData/g' "$file"
+
+        echo "Fixed $file"
+    else
+        echo "File not found: $file"
+    fi
+done
+
+echo "All files processed!"