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/Database/EntityManagerInitializer.php

@@ -7,6 +7,8 @@ namespace App\Framework\Database;
 use App\Framework\Core\Events\EventDispatcher;
 use App\Framework\Database\Cache\EntityCacheManager;
 use App\Framework\Database\Config\DatabaseConfig;
+use App\Framework\Database\Platform\DatabasePlatform;
+use App\Framework\Database\Platform\MySQLPlatform;
 use App\Framework\DateTime\Clock;
 use App\Framework\DateTime\Timer;
 use App\Framework\DI\Container;
@@ -29,8 +31,12 @@ final readonly class EntityManagerInitializer
             $logger = $container->get(Logger::class);
         }
 
+        // Create platform for the database (defaulting to MySQL)
+        $platform = new MySQLPlatform();
+
         $db = new DatabaseManager(
             $databaseConfig,
+            $platform,
             $timer,
             'database/migrations',
             $clock,
@@ -52,6 +58,6 @@ final readonly class EntityManagerInitializer
             $cacheManager = $container->get(EntityCacheManager::class);
         }
 
-        return EntityManagerFactory::create($db, $eventDispatcher, $clock, $cacheManager);
+        return EntityManagerFactory::create($db, $eventDispatcher, $clock, $container, $cacheManager);
     }
 }