Toolvana: production-ready media tools platform (CodeIgniter 4)

- 134-tool registry with programmatic SEO (unique titles/H1/descriptions, JSON-LD graphs, sitemap index, canonical 301 enforcement via required filter) - DB-backed job queue (SKIP LOCKED) with drivers: Ffmpeg, Images (GD), Pdf (qpdf/gs/poppler), Youtube (thumbnails), Qr (server-side PNG) - Security: SSRF guard, MIME validation, rate limits, API-key auth, bcrypt admin login, security headers - Admin panel: dashboard, tools/categories/guides CRUD, SEO audit, analytics, job inspector with retry, system health, feature flags - Docker deployment (nginx + web/api FPM pools + scalable workers), PHPUnit suite (19 tests / 1139 assertions), PWA manifest + service worker
2026-08-23 07:10:30 +00:00
commit beaf0e1f37
217 changed files with 19619 additions and 0 deletions
@@ -0,0 +1,134 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use CodeIgniter\Model;
+
+final class JobModel extends Model
+{
+    protected $table         = 'jobs';
+    protected $primaryKey    = 'id';
+    protected $returnType    = 'array';
+    protected $useTimestamps = false;
+    protected $allowedFields = [
+        'id', 'session_id', 'ip_hash', 'tool_id', 'operation', 'params',
+        'input_file', 'input_name', 'input_size', 'input_mime',
+        'output_file', 'output_name', 'output_size', 'status', 'progress',
+        'stage', 'error', 'priority', 'attempts', 'source', 'download_count',
+        'created_at', 'started_at', 'completed_at', 'expires_at',
+    ];
+
+    public function create(array $data): string
+    {
+        $data['id']        ??= $this->uuid();
+        $now                 = date('Y-m-d H:i:s');
+        $data['created_at']  = $now;
+        $data['expires_at'] ??= gmdate('Y-m-d H:i:s', time() + (int) config('Site')->retentionHours * 3600);
+
+        $this->insert($data);
+
+        return $data['id'];
+    }
+
+    /**
+     * Atomically claim the next queued job. Uses SKIP LOCKED so N workers
+     * never grab the same row and the API stays responsive.
+     */
+    public function claimNext(): ?array
+    {
+        $db   = $this->db;
+        $sql  = "SELECT id FROM {$this->table}
+                 WHERE status = 'queued'
+                   AND created_at <= ?
+                 ORDER BY priority ASC, created_at ASC
+                 LIMIT 1";
+
+        // One transaction per claim; InnoDB row locks do the rest.
+        $db->transBegin();
+        try {
+            $query  = $db->query($sql . ' FOR UPDATE SKIP LOCKED', [date('Y-m-d H:i:s')]);
+            $row    = $query->getFirstRow();
+            if ($row === null) {
+                $db->transRollback();
+
+                return null;
+            }
+
+            $db->table($this->table)
+                ->where('id', $row->id)
+                ->update([
+                    'status'     => 'processing',
+                    'stage'      => 'preparing',
+                    'progress'   => 1,
+                    'started_at' => date('Y-m-d H:i:s'),
+                ]);
+            $this->db->query("UPDATE {$this->table} SET attempts = attempts + 1 WHERE id = ?", [$row->id]);
+            $db->transCommit();
+
+            return $this->find((string) $row->id);
+        } catch (\Throwable $e) {
+            $db->transRollback();
+            throw $e;
+        }
+    }
+
+    /** @return list<array> */
+    public function forSession(string $sessionHash, int $limit = 20): array
+    {
+        return $this->where('session_id', $sessionHash)
+            ->orderBy('created_at', 'DESC')
+            ->limit($limit)
+            ->findAll();
+    }
+
+    public function countQueued(): int
+    {
+        return $this->where('status', 'queued')->countAllResults();
+    }
+
+    public function countProcessing(): int
+    {
+        return $this->where('status', 'processing')->countAllResults();
+    }
+
+    /** Jobs stuck in processing longer than the max runtime — failed by reaper. */
+    public function findStale(int $maxSeconds): array
+    {
+        return $this->where('status', 'processing')
+            ->where('started_at <', gmdate('Y-m-d H:i:s', time() - $maxSeconds - 60))
+            ->findAll();
+    }
+
+    /** Rows past retention (any terminal/abandoned state) for the reaper. */
+    public function findExpired(int $batchSize = 200): array
+    {
+        $now = gmdate('Y-m-d H:i:s');
+        return $this->where('expires_at <', $now)
+            ->whereIn('status', ['queued', 'processing', 'completed', 'cancelled', 'expired'])
+            ->limit($batchSize)
+            ->findAll();
+    }
+
+    /** Failed jobs older than an hour, cleaned on the same cadence. */
+    public function findOldFailed(int $olderThanSeconds = 3600, int $batchSize = 100): array
+    {
+        return $this->where('status', 'failed')
+            ->where('completed_at <', gmdate('Y-m-d H:i:s', time() - $olderThanSeconds))
+            ->limit($batchSize)
+            ->findAll();
+    }
+
+    private function uuid(): string
+    {
+        $bytes = random_bytes(16);
+        $bytes[6] = chr((ord($bytes[6]) & 0x0f) | 0x40);
+        $bytes[8] = chr((ord($bytes[8]) & 0x3f) | 0x80);
+        $hex = bin2hex($bytes);
+
+        return sprintf('%s-%s-%s-%s-%s',
+            substr($hex, 0, 8), substr($hex, 8, 4), substr($hex, 12, 4),
+            substr($hex, 16, 4), substr($hex, 20, 12));
+    }
+}