feat: implement T-019 reliable event ingress

Brain/yovision_brain/runtime.py

@@ -24,8 +24,12 @@ DEFAULT_ZONE = Zone(
 )
 
 
+class EventIngressUnavailable(RuntimeError):
+    pass
+
+
 class DemoEngine:
-    def __init__(self, source: Any, fps: float = 2.0, event_limit: int = 100) -> None:
+    def __init__(self, source: Any, fps: float = 2.0, event_limit: int = 100, event_ingress: Any | None = None) -> None:
         if not math.isfinite(fps) or fps <= 0.0 or fps > 30.0:
             raise ValueError("fps must be within (0, 30]")
         if not 1 <= event_limit <= 100:
@@ -36,6 +40,7 @@ class DemoEngine:
         self._detector = None if source.fixture else HOGPersonDetector()
         self._tracker = CentroidTracker()
         self._evaluator = ZoneEntryEvaluator(source.source_ref, source.fixture)
+        self._event_ingress = event_ingress
         self._zone = DEFAULT_ZONE
         self._events: deque[dict[str, object]] = deque(maxlen=event_limit)
         self._lock = threading.RLock()
@@ -54,6 +59,8 @@ class DemoEngine:
     def start(self) -> None:
         if self._thread is not None:
             return
+        if self._event_ingress is not None:
+            self._event_ingress.start()
         self._thread = threading.Thread(target=self._run, name="brain-demo", daemon=True)
         self._thread.start()
 
@@ -62,6 +69,8 @@ class DemoEngine:
         if self._thread is not None:
             self._thread.join(timeout=3.0)
             self._thread = None
+        if self._event_ingress is not None:
+            self._event_ingress.stop()
         self._source.close()
 
     def _run(self) -> None:
@@ -70,6 +79,9 @@ class DemoEngine:
             started = time.perf_counter()
             try:
                 self.step()
+            except EventIngressUnavailable:
+                with self._lock:
+                    self._last_error_code = "event_outbox_unavailable"
             except RuntimeError:
                 with self._lock:
                     self._connected = False
@@ -89,6 +101,12 @@ class DemoEngine:
         with self._lock:
             zone = self._zone
         new_events, inside_by_track = self._evaluator.evaluate(self._sequence, packet.captured_at, zone, detections)
+        if self._event_ingress is not None:
+            try:
+                for item in new_events:
+                    self._event_ingress.submit(item)
+            except Exception as exc:
+                raise EventIngressUnavailable("persist event candidate") from exc
         ok, encoded = cv2.imencode(".jpg", packet.frame, [int(cv2.IMWRITE_JPEG_QUALITY), 82])
         if not ok:
             raise RuntimeError("frame encoding failed")
@@ -96,7 +114,12 @@ class DemoEngine:
         serialized_detections = [self._serialize_detection(item, inside_by_track.get(item.track_id, False)) for item in detections]
         with self._lock:
             for event in new_events:
-                self._events.appendleft(event.as_dict())
+                serialized_event = event.as_dict()
+                if self._event_ingress is not None:
+                    # This is an immutable handoff fact, not a live delivery
+                    # status. Current counts live under event_ingress.
+                    serialized_event["delivery_status"] = "outbox_persisted"
+                self._events.appendleft(serialized_event)
             self._frame_jpeg = encoded.tobytes()
             self._frame_width = int(width)
             self._frame_height = int(height)
@@ -130,6 +153,13 @@ class DemoEngine:
     def state(self) -> dict[str, object]:
         with self._lock:
             zone = self._zone
+            if self._event_ingress is None:
+                ingress_status: dict[str, object] = {"enabled": False}
+            else:
+                try:
+                    ingress_status = self._event_ingress.status()
+                except Exception:
+                    ingress_status = {"enabled": True, "last_error_code": "event_outbox_unavailable"}
             return {
                 "prototype": True,
                 "notice": "工程原型；合成回放不是模型输出，HOG 适配器不是生产检测模型。",
@@ -159,6 +189,7 @@ class DemoEngine:
                 },
                 "detections": list(self._detections),
                 "events": list(self._events),
+                "event_ingress": ingress_status,
                 "last_error_code": self._last_error_code,
                 "generated_at": datetime.now(timezone.utc).isoformat().replace("+00:00", "Z"),
             }