feat: background analysis job queue servisi ve corresponding tests eklendi

app/services/analysis_jobs.py

@@ -234,7 +234,10 @@ class Job:
         data: Dict[str, Any] = {
             "jobId": self.id,
             "sourceType": self.source_type,
-            "status": self.status if self.finished else self.progress.phase,
+            # "running" until settled, whether waiting or working, so clients
+            # that predate the queue keep polling; `phase` tells them apart.
+            "status": self.status if self.finished else "running",
+            "phase": self.status if self.finished else self.progress.phase,
             "steps": self.progress.snapshot(),
             "elapsedSec": round((self.updated if self.finished else time.time()) - self.created, 2),
             "response": self.response,

tests/test_analysis_jobs.py

@@ -39,8 +39,9 @@ def test_jobs_take_the_cpu_one_at_a_time_in_order() -> None:
         jobs = [store.start("file", FILE_STEPS, gated(0.05)) for _ in range(3)]
         await asyncio.sleep(0.01)
         snaps = [j.to_dict() for j in jobs]
-        assert snaps[0]["status"] == "running"
-        assert snaps[1]["status"] == "queued" and snaps[1]["queue"]["position"] == 1
+        assert snaps[0]["phase"] == "running" and "queue" not in snaps[0]
+        assert snaps[1]["status"] == "running" and snaps[1]["phase"] == "queued"
+        assert snaps[1]["queue"]["position"] == 1 and snaps[1]["queue"]["ahead"] == 1
         assert snaps[2]["queue"]["position"] == 2
         await asyncio.sleep(0.25)
         assert all(j.to_dict()["status"] == "done" for j in jobs)

tests/test_analyze_queue.py

@@ -70,7 +70,7 @@ def test_ten_visitors_at_once_queue_and_finish(stub_pipeline) -> None:
             assert len(set(ids)) == 10
 
             snaps = [(await client.get(f"/api/analyze/jobs/{i}")).json() for i in ids]
-            positions = sorted(s["queue"]["position"] for s in snaps if s["status"] == "queued")
+            positions = sorted(s["queue"]["position"] for s in snaps if s["phase"] == "queued")
             assert positions == list(range(1, len(positions) + 1))
             assert len(positions) >= 8