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/ReadWriteConnection.php

@@ -8,6 +8,7 @@ use App\Framework\Database\Config\ReadWriteConfig;
 use App\Framework\Database\Exception\DatabaseException;
 use App\Framework\Database\ReadWrite\MasterSlaveRouter;
 use App\Framework\Database\ReadWrite\ReplicationLagDetector;
+use App\Framework\Database\ValueObjects\SqlQuery;
 use App\Framework\DateTime\Clock;
 
 /**
@@ -53,39 +54,39 @@ final class ReadWriteConnection implements ConnectionInterface
         }
     }
 
-    public function execute(string $sql, array $parameters = []): int
+    public function execute(SqlQuery $query): int
     {
         $this->forceWrite = true;
 
-        return $this->writeConnection->execute($sql, $parameters);
+        return $this->writeConnection->execute($query);
     }
 
-    public function query(string $sql, array $parameters = []): ResultInterface
+    public function query(SqlQuery $query): ResultInterface
     {
-        $connection = $this->getConnection($sql);
+        $connection = $this->getConnection($query->sql);
 
-        return $connection->query($sql, $parameters);
+        return $connection->query($query);
     }
 
-    public function queryOne(string $sql, array $parameters = []): ?array
+    public function queryOne(SqlQuery $query): ?array
     {
-        $connection = $this->getConnection($sql);
+        $connection = $this->getConnection($query->sql);
 
-        return $connection->queryOne($sql, $parameters);
+        return $connection->queryOne($query);
     }
 
-    public function queryColumn(string $sql, array $parameters = []): array
+    public function queryColumn(SqlQuery $query): array
     {
-        $connection = $this->getConnection($sql);
+        $connection = $this->getConnection($query->sql);
 
-        return $connection->queryColumn($sql, $parameters);
+        return $connection->queryColumn($query);
     }
 
-    public function queryScalar(string $sql, array $parameters = []): mixed
+    public function queryScalar(SqlQuery $query): mixed
     {
-        $connection = $this->getConnection($sql);
+        $connection = $this->getConnection($query->sql);
 
-        return $connection->queryScalar($sql, $parameters);
+        return $connection->queryScalar($query);
     }
 
     public function beginTransaction(): void