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

tests/Framework/Discovery/DiscoveryServiceIntegrationTest.php

@@ -29,7 +29,9 @@ describe('DiscoveryService Integration with Console Commands', function () {
         $serializer = new PhpSerializer(PhpSerializerConfig::safe());
         $this->cache = new GeneralCache($cacheDriver, $serializer);
         $this->clock = new SystemClock();
-        $this->pathProvider = new PathProvider('/home/michael/dev/michaelschiemer');
+        // Use correct base path for Docker environment
+        $basePath = file_exists('/var/www/html/src') ? '/var/www/html' : '/home/michael/dev/michaelschiemer';
+        $this->pathProvider = new PathProvider($basePath);
 
         // Register dependencies in container
         $this->container->singleton(Cache::class, $this->cache);
@@ -228,7 +230,9 @@ describe('DiscoveryService Performance and Error Handling', function () {
         $serializer = new PhpSerializer(PhpSerializerConfig::safe());
         $this->cache = new GeneralCache($cacheDriver, $serializer);
         $this->clock = new SystemClock();
-        $this->pathProvider = new PathProvider('/home/michael/dev/michaelschiemer');
+        // Use correct base path for Docker environment
+        $basePath = file_exists('/var/www/html/src') ? '/var/www/html' : '/home/michael/dev/michaelschiemer';
+        $this->pathProvider = new PathProvider($basePath);
 
         $this->container->singleton(Cache::class, $this->cache);
         $this->container->singleton(Clock::class, $this->clock);