Add Gundi v2 push receiver for ICU and normalized data model

ICU now pushes camera events via a Gundi-v2-compatible API instead of
dropping file triplets into S3. The new gundi-receiver service accepts
them directly, so images are in the system within seconds instead of
waiting out the 90s age gate + poll interval. OCR of the burnt-in camera
timestamp stays mandatory (ICU only sends server times; OCR detects
drifting camera clocks) but now runs asynchronously after ingest.

The push path writes a normalized model that separates what the legacy
metadata table conflates: camera_status (status time series), image
(image properties) and detection (classifications), plus the
image_with_status view as the portal's migration target. A repeatable,
batched migration splits existing metadata/category rows into it.

The legacy poller is unchanged and keeps writing metadata/category until
the portal is switched over.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
dom
2026-09-18 13:54:21 +00:00
co-authored by Claude Opus 5
parent 94bfc60fc4
commit 2fc8dea10c
13 changed files with 1638 additions and 11 deletions
+17
View File
@@ -39,3 +39,20 @@ app:
enable_deermapper_api: false
deermapper_api_timeout_seconds: 20
deermapper_api_image_field: "image"
# Gundi-v2-Push-Empfaenger (Service gundi-receiver).
# api key -> via ENV (.env): GUNDI_API_KEY (min. 24 Zeichen)
gundi:
enabled: true
bind_host: "0.0.0.0" # im Container; nach aussen nur 127.0.0.1:8090 (compose)
bind_port: 8090
inbox_prefix: "icu/gundi-test/inbox/"
processed_prefix: "icu/gundi-test/processed/" # spaeter: icu/processed/
thumb_prefix: "icu/gundi-test/thumbnails/" # spaeter: icu/thumbnails/
workers: 4
ocr_workers: 2
max_request_bytes: 33554432
abandon_after_hours: 24
sweep_seconds: 60
stale_after_seconds: 300
max_attempts: 3