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/Queue/Initializers/JobDistributionInitializer.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Queue\Initializers;
+
+use App\Framework\DI\Initializer;
+use App\Framework\DI\Container;
+use App\Framework\Queue\Services\JobDistributionService;
+use App\Framework\Queue\Services\WorkerRegistry;
+use App\Framework\Queue\Interfaces\DistributedLockInterface;
+use App\Framework\Database\ConnectionInterface;
+use App\Framework\Logging\Logger;
+
+/**
+ * Job Distribution Service Initializer
+ */
+final readonly class JobDistributionInitializer
+{
+    #[Initializer]
+    public function __invoke(Container $container): JobDistributionService
+    {
+        $workerRegistry = $container->get(WorkerRegistry::class);
+        $distributedLock = $container->get(DistributedLockInterface::class);
+        $connection = $container->get(ConnectionInterface::class);
+        $logger = $container->get(Logger::class);
+
+        return new JobDistributionService(
+            workerRegistry: $workerRegistry,
+            distributedLock: $distributedLock,
+            connection: $connection,
+            logger: $logger
+        );
+    }
+}