Files
melesICUmover/schema/001_domain_model.sql
T
domandClaude Opus 5 2fc8dea10c 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>
2026-09-18 13:54:21 +00:00

180 lines
6.0 KiB
SQL

-- Normalisiertes Fachmodell: Kamerastatus, Bildeigenschaften, Objektklassifikationen.
-- Idempotent; wird vom gundi-receiver beim Start unter Advisory-Lock angewendet.
-- Setzt das bestehende Schema remote_cam voraus (die App-Rolle hat kein CREATE auf DB-Ebene).
-- Statusupdates / Kameraeigenschaften: eine Zeile je Statusmeldung (Zeitreihe).
CREATE TABLE IF NOT EXISTS remote_cam.camera_status (
status_id bigserial PRIMARY KEY,
imei text NOT NULL,
reported_at timestamptz NOT NULL,
received_at timestamptz NOT NULL DEFAULT now(),
iccid text,
init_key text,
camera_name text,
camera_model text,
firmware_version text,
camera_language text,
customer_timezone text,
mcc text,
mnc text,
lac text,
cell_id text,
camera_network text,
battery_pct integer,
signal_strength integer,
temperature_c integer,
coordinate_switch boolean,
work_period boolean,
work_start text,
work_end text,
image_format text,
image_night text,
thumbnail_size text,
pir_interval text,
time_scan text,
lat double precision,
lon double precision,
settings_changed_at timestamptz,
source text NOT NULL CHECK (source IN ('gundi', 'entrance')),
source_ref text,
raw jsonb
);
-- Legacy hat 173 doppelte (imei, servertime)-Paare, daher keine globale Eindeutigkeit.
CREATE UNIQUE INDEX IF NOT EXISTS camera_status_gundi_uq
ON remote_cam.camera_status (imei, reported_at) WHERE source = 'gundi';
CREATE UNIQUE INDEX IF NOT EXISTS camera_status_entrance_uq
ON remote_cam.camera_status (source_ref) WHERE source = 'entrance';
CREATE INDEX IF NOT EXISTS camera_status_imei_reported_idx
ON remote_cam.camera_status (imei, reported_at DESC);
-- Bildeigenschaften.
CREATE TABLE IF NOT EXISTS remote_cam.image (
image_uuid uuid PRIMARY KEY,
imei text NOT NULL,
servertime timestamptz NOT NULL,
ocr_ts timestamptz,
ocr_state text NOT NULL DEFAULT 'PENDING' CHECK (ocr_state IN ('PENDING', 'OK', 'FAIL')),
ocr_attempts integer NOT NULL DEFAULT 0,
ocr_error text,
camera_ts timestamptz,
camera_name text,
camera_make text,
lat double precision,
lon double precision,
size_bytes integer,
processed_key text,
thumbnail_key text,
source text NOT NULL CHECK (source IN ('gundi', 'entrance')),
source_ref text,
imported_at timestamptz NOT NULL DEFAULT now(),
updated_at timestamptz NOT NULL DEFAULT now(),
raw jsonb
);
CREATE INDEX IF NOT EXISTS image_imei_servertime_idx
ON remote_cam.image (imei, servertime DESC);
CREATE INDEX IF NOT EXISTS image_servertime_idx
ON remote_cam.image (servertime DESC);
CREATE INDEX IF NOT EXISTS image_ocr_pending_idx
ON remote_cam.image (updated_at) WHERE ocr_state = 'PENDING';
-- Objektklassifikationen.
CREATE TABLE IF NOT EXISTS remote_cam.detection (
detection_id bigserial PRIMARY KEY,
image_uuid uuid NOT NULL REFERENCES remote_cam.image (image_uuid) ON DELETE CASCADE,
category text NOT NULL,
confidence double precision CHECK (confidence BETWEEN 0 AND 1),
bbox_x integer,
bbox_y integer,
bbox_w integer,
bbox_h integer,
model_version text,
source text NOT NULL CHECK (source IN ('gundi', 'entrance'))
);
CREATE INDEX IF NOT EXISTS detection_image_confidence_idx
ON remote_cam.detection (image_uuid, confidence DESC);
CREATE INDEX IF NOT EXISTS detection_category_idx
ON remote_cam.detection (category);
-- Transportschicht des Push-Pfads: Rohevents + Zustandsmaschine.
CREATE TABLE IF NOT EXISTS remote_cam.gundi_inbox (
object_id uuid PRIMARY KEY,
event_type text NOT NULL,
source text,
recorded_at timestamptz,
payload jsonb NOT NULL,
received_at timestamptz NOT NULL DEFAULT now(),
attachment_key text,
attachment_received_at timestamptz,
state text NOT NULL CHECK (state IN (
'AWAITING_ATTACHMENT', 'RECEIVED', 'INGESTED',
'FAILED', 'ABANDONED', 'IGNORED')),
attempts integer NOT NULL DEFAULT 0,
last_error text,
updated_at timestamptz NOT NULL DEFAULT now()
);
CREATE INDEX IF NOT EXISTS gundi_inbox_open_idx
ON remote_cam.gundi_inbox (state, updated_at)
WHERE state IN ('AWAITING_ATTACHMENT', 'RECEIVED');
-- Bild + der zum Aufnahme-Serverzeitpunkt gueltige Kamerastatus.
-- Tie-Breaker bei gleichem reported_at: der aus derselben Legacy-Zeile abgespaltene Status.
CREATE OR REPLACE VIEW remote_cam.image_with_status AS
SELECT
i.image_uuid,
i.imei,
i.servertime,
i.ocr_ts,
i.ocr_state,
i.camera_ts,
i.camera_name,
i.camera_make,
i.lat,
i.lon,
i.size_bytes,
i.processed_key,
i.thumbnail_key,
i.source,
i.imported_at,
s.status_id,
s.reported_at AS status_reported_at,
s.iccid,
s.init_key,
s.camera_name AS status_camera_name,
s.camera_model,
s.firmware_version,
s.camera_language,
s.customer_timezone,
s.mcc,
s.mnc,
s.lac,
s.cell_id,
s.camera_network,
s.battery_pct,
s.signal_strength,
s.temperature_c,
s.coordinate_switch,
s.work_period,
s.work_start,
s.work_end,
s.image_format,
s.image_night,
s.thumbnail_size,
s.pir_interval,
s.time_scan,
s.settings_changed_at
FROM remote_cam.image i
LEFT JOIN LATERAL (
SELECT cs.*
FROM remote_cam.camera_status cs
WHERE cs.imei = i.imei
AND cs.reported_at <= i.servertime
ORDER BY cs.reported_at DESC,
(cs.source_ref = i.image_uuid::text) DESC NULLS LAST,
cs.status_id DESC
LIMIT 1
) s ON TRUE;