Files
MikrotikManager/backend/src/services/bandwidth-external-node-registry-schema.ts
T

111 lines
8.4 KiB
TypeScript

/** Fresh-only, explicit owner installation. Requires the original registry and core guards.
* No seed, migration registration, occupancy mutation or automatic execution. */
export const BANDWIDTH_EXTERNAL_NODE_REGISTRY_TABLES = Object.freeze(["bandwidth_external_node_aliases", "bandwidth_external_node_events"] as const)
export const BANDWIDTH_EXTERNAL_NODE_REGISTRY_DDL = `
CREATE TABLE mmapp_control.bandwidth_external_node_aliases (
enrollment_id uuid PRIMARY KEY,
incarnation uuid NOT NULL UNIQUE,
node_id uuid NOT NULL REFERENCES mmapp_control.bandwidth_nodes(node_id) ON DELETE RESTRICT ON UPDATE RESTRICT,
status text COLLATE "C" NOT NULL CHECK (status IN ('active','tombstoned','quarantined')),
record_mac text COLLATE "C" NOT NULL CHECK (record_mac ~ '^[a-f0-9]{64}$'),
created_at timestamptz NOT NULL DEFAULT clock_timestamp()
);
CREATE INDEX bandwidth_external_node_aliases_node_idx ON mmapp_control.bandwidth_external_node_aliases(node_id);
CREATE TABLE mmapp_control.bandwidth_external_node_events (
event_id uuid PRIMARY KEY,
enrollment_id uuid NOT NULL REFERENCES mmapp_control.bandwidth_external_node_aliases(enrollment_id) ON DELETE RESTRICT ON UPDATE RESTRICT,
incarnation uuid NOT NULL,
node_id uuid NOT NULL REFERENCES mmapp_control.bandwidth_nodes(node_id) ON DELETE RESTRICT ON UPDATE RESTRICT,
kind text COLLATE "C" NOT NULL CHECK (kind IN ('enroll','tombstone','quarantine')),
old_status text COLLATE "C" CHECK (old_status='active'),
new_status text COLLATE "C" NOT NULL CHECK (new_status IN ('active','tombstoned','quarantined')),
authority_proof text COLLATE "C" NOT NULL CHECK (authority_proof ~ '^[a-f0-9]{64}$'),
event_mac text COLLATE "C" NOT NULL CHECK (event_mac ~ '^[a-f0-9]{64}$'),
created_at timestamptz NOT NULL DEFAULT clock_timestamp(),
UNIQUE (enrollment_id,kind),
CHECK (COALESCE(
(kind='enroll' AND old_status IS NULL AND new_status='active')
OR (kind='tombstone' AND old_status='active' AND new_status='tombstoned')
OR (kind='quarantine' AND old_status='active' AND new_status='quarantined'), false))
);
CREATE INDEX bandwidth_external_node_events_node_idx ON mmapp_control.bandwidth_external_node_events(node_id);
CREATE FUNCTION mmapp_control.bandwidth_external_node_alias_guard() RETURNS trigger
LANGUAGE plpgsql SET search_path=pg_catalog,mmapp_control AS $body$
BEGIN
IF TG_OP='DELETE' THEN RAISE EXCEPTION 'bandwidth node aliases cannot be deleted' USING ERRCODE='23514'; END IF;
IF TG_OP='INSERT' THEN
IF NEW.status <> 'active' THEN RAISE EXCEPTION 'bandwidth node alias must start active' USING ERRCODE='23514'; END IF;
-- Keep the reference invariant under replica mode as well: ordinary FK
-- implementation triggers are not ALWAYS, while this row guard is.
-- Nodes cannot be updated or deleted, so this existence check needs no row
-- lock (and must not require UPDATE rights for the registry runtime).
PERFORM 1 FROM mmapp_control.bandwidth_nodes WHERE node_id=NEW.node_id;
IF NOT FOUND THEN RAISE EXCEPTION 'bandwidth node alias requires its original node' USING ERRCODE='23514'; END IF;
RETURN NEW;
END IF;
IF ROW(NEW.enrollment_id,NEW.incarnation,NEW.node_id,NEW.created_at)
IS DISTINCT FROM ROW(OLD.enrollment_id,OLD.incarnation,OLD.node_id,OLD.created_at)
OR OLD.status <> 'active' OR NEW.status NOT IN ('tombstoned','quarantined')
OR NEW.record_mac IS NOT DISTINCT FROM OLD.record_mac THEN
RAISE EXCEPTION 'bandwidth node alias cannot be rebound or reactivated' USING ERRCODE='23514';
END IF;
RETURN NEW;
END;
$body$;
CREATE FUNCTION mmapp_control.bandwidth_external_node_event_guard() RETURNS trigger
LANGUAGE plpgsql SET search_path=pg_catalog,mmapp_control AS $body$
DECLARE alias_row mmapp_control.bandwidth_external_node_aliases%ROWTYPE;
BEGIN
IF TG_OP <> 'INSERT' THEN RAISE EXCEPTION 'bandwidth node events are append only' USING ERRCODE='23514'; END IF;
SELECT * INTO alias_row FROM mmapp_control.bandwidth_external_node_aliases WHERE enrollment_id=NEW.enrollment_id FOR UPDATE;
IF NOT FOUND OR alias_row.incarnation <> NEW.incarnation OR alias_row.node_id <> NEW.node_id OR alias_row.status <> NEW.new_status THEN
RAISE EXCEPTION 'bandwidth node event does not match its original alias' USING ERRCODE='23514';
END IF;
RETURN NEW;
END;
$body$;
CREATE FUNCTION mmapp_control.bandwidth_external_node_alias_consistency_guard() RETURNS trigger
LANGUAGE plpgsql SET search_path=pg_catalog,mmapp_control AS $body$
DECLARE target_id uuid; alias_row mmapp_control.bandwidth_external_node_aliases%ROWTYPE;
total bigint; enrollments bigint; terminals bigint; terminal mmapp_control.bandwidth_external_node_events%ROWTYPE;
BEGIN
IF TG_OP='DELETE' THEN target_id:=OLD.enrollment_id; ELSE target_id:=NEW.enrollment_id; END IF;
SELECT * INTO alias_row FROM mmapp_control.bandwidth_external_node_aliases WHERE enrollment_id=target_id FOR UPDATE;
IF NOT FOUND THEN RAISE EXCEPTION 'bandwidth node alias missing' USING ERRCODE='23514'; END IF;
SELECT count(*),count(*) FILTER (WHERE kind='enroll'),count(*) FILTER (WHERE kind IN ('tombstone','quarantine'))
INTO total,enrollments,terminals FROM mmapp_control.bandwidth_external_node_events WHERE enrollment_id=target_id;
IF enrollments <> 1 OR terminals > 1 OR total <> enrollments+terminals OR total > 2
OR EXISTS(SELECT 1 FROM mmapp_control.bandwidth_external_node_events WHERE enrollment_id=target_id
AND (incarnation <> alias_row.incarnation OR node_id <> alias_row.node_id)) THEN
RAISE EXCEPTION 'bandwidth node alias event chain is incomplete' USING ERRCODE='23514';
END IF;
IF alias_row.status='active' THEN
IF total <> 1 OR terminals <> 0 THEN RAISE EXCEPTION 'active bandwidth alias has a terminal event' USING ERRCODE='23514'; END IF;
ELSE
SELECT * INTO terminal FROM mmapp_control.bandwidth_external_node_events WHERE enrollment_id=target_id AND kind IN ('tombstone','quarantine');
IF terminals <> 1 OR terminal.old_status IS DISTINCT FROM 'active' OR terminal.new_status IS DISTINCT FROM alias_row.status
OR (alias_row.status='tombstoned' AND terminal.kind IS DISTINCT FROM 'tombstone')
OR (alias_row.status='quarantined' AND terminal.kind IS DISTINCT FROM 'quarantine') THEN
RAISE EXCEPTION 'terminal bandwidth node alias event mismatch' USING ERRCODE='23514';
END IF;
END IF;
RETURN NULL;
END;
$body$;
CREATE TRIGGER bandwidth_external_node_alias_guard BEFORE INSERT OR UPDATE OR DELETE ON mmapp_control.bandwidth_external_node_aliases FOR EACH ROW EXECUTE FUNCTION mmapp_control.bandwidth_external_node_alias_guard();
CREATE TRIGGER bandwidth_external_node_event_guard BEFORE INSERT OR UPDATE OR DELETE ON mmapp_control.bandwidth_external_node_events FOR EACH ROW EXECUTE FUNCTION mmapp_control.bandwidth_external_node_event_guard();
CREATE TRIGGER bandwidth_external_node_aliases_no_truncate BEFORE TRUNCATE ON mmapp_control.bandwidth_external_node_aliases FOR EACH STATEMENT EXECUTE FUNCTION mmapp_control.bandwidth_admission_reject_truncate();
CREATE TRIGGER bandwidth_external_node_events_no_truncate BEFORE TRUNCATE ON mmapp_control.bandwidth_external_node_events FOR EACH STATEMENT EXECUTE FUNCTION mmapp_control.bandwidth_admission_reject_truncate();
CREATE CONSTRAINT TRIGGER bandwidth_external_node_alias_consistency AFTER INSERT OR UPDATE OR DELETE ON mmapp_control.bandwidth_external_node_aliases DEFERRABLE INITIALLY DEFERRED FOR EACH ROW EXECUTE FUNCTION mmapp_control.bandwidth_external_node_alias_consistency_guard();
CREATE CONSTRAINT TRIGGER bandwidth_external_node_event_consistency AFTER INSERT OR UPDATE OR DELETE ON mmapp_control.bandwidth_external_node_events DEFERRABLE INITIALLY DEFERRED FOR EACH ROW EXECUTE FUNCTION mmapp_control.bandwidth_external_node_alias_consistency_guard();
ALTER TABLE mmapp_control.bandwidth_external_node_aliases ENABLE ALWAYS TRIGGER bandwidth_external_node_alias_guard;
ALTER TABLE mmapp_control.bandwidth_external_node_events ENABLE ALWAYS TRIGGER bandwidth_external_node_event_guard;
ALTER TABLE mmapp_control.bandwidth_external_node_aliases ENABLE ALWAYS TRIGGER bandwidth_external_node_aliases_no_truncate;
ALTER TABLE mmapp_control.bandwidth_external_node_events ENABLE ALWAYS TRIGGER bandwidth_external_node_events_no_truncate;
ALTER TABLE mmapp_control.bandwidth_external_node_aliases ENABLE ALWAYS TRIGGER bandwidth_external_node_alias_consistency;
ALTER TABLE mmapp_control.bandwidth_external_node_events ENABLE ALWAYS TRIGGER bandwidth_external_node_event_consistency;
`