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/Migrations/CreateJobProgressTable.php

@@ -0,0 +1,71 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Queue\Migrations;
+
+use App\Framework\Database\ConnectionInterface;
+use App\Framework\Database\Migration\Migration;
+use App\Framework\Database\Migration\MigrationVersion;
+use App\Framework\Database\Schema\Schema;
+
+final readonly class CreateJobProgressTable implements Migration
+{
+    public function up(ConnectionInterface $connection): void
+    {
+        $schema = new Schema($connection);
+
+        $schema->createIfNotExists('job_progress', function ($table) {
+            // Primary key
+            $table->string('id', 26)->primary();
+
+            // Job reference
+            $table->string('job_id', 26)->index();
+
+            // Progress tracking
+            $table->decimal('percentage', 5, 2)->index(); // 0.00 to 100.00
+            $table->text('message');
+            $table->string('step_name', 100)->nullable()->index();
+
+            // Additional data
+            $table->json('metadata')->nullable();
+
+            // Status flags
+            $table->boolean('is_completed')->default(false)->index();
+            $table->boolean('is_failed')->default(false)->index();
+
+            // Timestamp
+            $table->timestamp('updated_at')->index();
+
+            // Composite indexes for efficient querying
+            $table->index(['job_id', 'updated_at']);
+            $table->index(['job_id', 'is_completed']);
+            $table->index(['is_completed', 'updated_at']);
+            $table->index(['percentage', 'updated_at']);
+        });
+
+        $schema->execute();
+    }
+
+    public function down(ConnectionInterface $connection): void
+    {
+        $schema = new Schema($connection);
+        $schema->dropIfExists('job_progress');
+        $schema->execute();
+    }
+
+    public function getVersion(): MigrationVersion
+    {
+        return MigrationVersion::fromTimestamp("2024_12_31_140003");
+    }
+
+    public function getDescription(): string
+    {
+        return "Create Job Progress Table";
+    }
+
+    public function getDomain(): string
+    {
+        return "Framework";
+    }
+}