Beteiligte in den Suchindex der Fallakte

Wer „Jonathan Fletcher" eingibt, will die Akten sehen, in denen er vorkommt -
auch die, in denen er weder im Titel steht noch im Text erwähnt wird, sondern
nur als Betroffener eingetragen ist. Genau das wurde nicht gefunden.

Die Namen der Beteiligten stehen jetzt im Vektor der Fallakte, Gewicht B: ein
Name sagt etwas über die Akte aus, aber weniger als ihr Titel. In allen sechs
Vektoren und nicht erst ab einer Stufe - das ist die Stelle, an der man zweimal
hinsehen muss, und sie war bereits entschieden: der Name eines Beteiligten
steht in der Beteiligtenliste jeder Akte, die man lesen darf, zurückgehalten
wird allein der Verweis auf seine Personalakte. Der Index gibt also nichts
heraus, was die Akte nicht ohnehin zeigt.

Die Akte selbst muss man weiterhin lesen dürfen. Ein Test prüft genau das: eine
Stufe-4-Akte wird über den Namen ihres Zeugen für Stufe 1 nicht auffindbar,
auch nicht als Trefferzahl.

Drei Auslöser halten den Index aktuell: geänderte Beteiligung, geänderter Name
in einer Personalakte, geänderter Anzeigename eines Kontos. Den letzten gleicht
der Worker mit Discord ab; ohne ihn fände die Suche nach einer Umbenennung
weiter den alten Namen.

Die Trefferzeile sagt dazu, warum sie passt: „Jonathan Fletcher als
Betroffener". Ohne den Hinweis sieht ein Treffer, dessen Begriff nirgends im
sichtbaren Text steht, wie ein Fehlgriff aus.

packages/db/prisma/migrations/20260904120000_beteiligte_in_der_suche/migration.sql

@@ -0,0 +1,129 @@
+-- Beteiligte in den Suchindex der Fallakte.
+--
+-- Wer nach einem Namen sucht, will die Akten finden, in denen die Person
+-- vorkommt — auch dann, wenn sie weder im Titel steht noch im Text erwähnt
+-- wird, sondern nur als Zeuge oder Betroffener eingetragen ist.
+--
+-- Das verrät nichts Neues: der Name eines Beteiligten steht ohnehin in der
+-- Beteiligtenliste jeder Akte, die man lesen darf. Zurückgehalten wird dort
+-- allein der Verweis auf seine Personalakte, wenn die höher eingestuft ist
+-- ("der Beteiligte ist Teil der Akte, seine Personalakte nicht", siehe
+-- lib/cases/participants.ts). Deshalb steht der Name in allen sechs Vektoren
+-- und nicht erst ab einer Stufe.
+--
+-- Gewicht B, wie die Abschnitte: ein Name sagt etwas über die Akte aus, aber
+-- weniger als ihr Titel.
+
+CREATE OR REPLACE FUNCTION refresh_case_search(target_id text) RETURNS void AS $$
+DECLARE
+  stufe int;
+  kopf tsvector;
+  beteiligte tsvector;
+  abschnitte tsvector;
+  eintraege tsvector;
+BEGIN
+  DELETE FROM "SearchIndex" WHERE "targetType" = 'case' AND "targetId" = target_id;
+
+  SELECT setweight(to_tsvector('german', c."caseNumber" || ' ' || c."title"), 'A')
+    INTO kopf
+    FROM "Case" c WHERE c."id" = target_id;
+
+  IF kopf IS NULL THEN
+    RETURN; -- Der Fall ist weg, dann gehört auch kein Index dazu.
+  END IF;
+
+  -- Die Namen der Beteiligten, gleich ob sie an einem Konto oder an einer
+  -- Personalakte hängen. Sie hängen nicht von der Stufe ab und werden deshalb
+  -- einmal vor der Schleife berechnet.
+  SELECT coalesce(
+    to_tsvector('german', string_agg(coalesce(u."displayName", pf."displayName", ''), ' ')),
+    ''::tsvector
+  ) INTO beteiligte
+    FROM "CaseParticipant" cp
+    LEFT JOIN "User" u ON u."id" = cp."userId"
+    LEFT JOIN "PersonnelFile" pf ON pf."id" = cp."personnelFileId"
+   WHERE cp."caseId" = target_id;
+
+  FOR stufe IN 0..5 LOOP
+    SELECT coalesce(
+      to_tsvector('german', string_agg(strip_redactions_above(s."value" #>> '{}', stufe), ' ')),
+      ''::tsvector
+    ) INTO abschnitte
+      FROM "CaseSection" s
+     WHERE s."caseId" = target_id AND s."minClearance" <= stufe;
+
+    SELECT coalesce(
+      to_tsvector('german', string_agg(strip_redactions_above(e."body", stufe), ' ')),
+      ''::tsvector
+    ) INTO eintraege
+      FROM "CaseEntry" e
+     WHERE e."caseId" = target_id
+       AND e."minClearance" <= stufe
+       AND e."retractedAt" IS NULL;
+
+    INSERT INTO "SearchIndex" ("targetType", "targetId", "minClearance", "vector")
+    VALUES (
+      'case',
+      target_id,
+      stufe,
+      kopf || setweight(beteiligte, 'B') || setweight(abschnitte, 'B')
+        || setweight(eintraege, 'C')
+    );
+  END LOOP;
+END;
+$$ LANGUAGE plpgsql;
+
+-- Der Verteiler kennt zwei neue Anlässe: eine geänderte Beteiligung, und einen
+-- geänderten Namen. Beim Namen sind alle Akten der Person betroffen — sonst
+-- fände die Suche nach einer Umbenennung weiter den alten Namen.
+CREATE OR REPLACE FUNCTION search_index_trigger() RETURNS trigger AS $$
+DECLARE
+  ziel text;
+  fall record;
+BEGIN
+  IF TG_TABLE_NAME = 'Case' THEN
+    PERFORM refresh_case_search(NEW."id");
+  ELSIF TG_TABLE_NAME IN ('CaseSection', 'CaseEntry') THEN
+    ziel := CASE WHEN TG_OP = 'DELETE' THEN OLD."caseId" ELSE NEW."caseId" END;
+    IF ziel IS NOT NULL THEN PERFORM refresh_case_search(ziel); END IF;
+  ELSIF TG_TABLE_NAME = 'CaseParticipant' THEN
+    ziel := CASE WHEN TG_OP = 'DELETE' THEN OLD."caseId" ELSE NEW."caseId" END;
+    IF ziel IS NOT NULL THEN PERFORM refresh_case_search(ziel); END IF;
+  ELSIF TG_TABLE_NAME = 'Document' THEN
+    PERFORM refresh_document_search(NEW."id");
+  ELSIF TG_TABLE_NAME = 'DocumentSection' THEN
+    ziel := CASE WHEN TG_OP = 'DELETE' THEN OLD."documentId" ELSE NEW."documentId" END;
+    IF ziel IS NOT NULL THEN PERFORM refresh_document_search(ziel); END IF;
+  ELSIF TG_TABLE_NAME = 'PersonnelFile' THEN
+    PERFORM refresh_personnel_search(NEW."id");
+    FOR fall IN
+      SELECT DISTINCT cp."caseId" AS id FROM "CaseParticipant" cp
+       WHERE cp."personnelFileId" = NEW."id"
+    LOOP
+      PERFORM refresh_case_search(fall.id);
+    END LOOP;
+  ELSIF TG_TABLE_NAME = 'User' THEN
+    FOR fall IN
+      SELECT DISTINCT cp."caseId" AS id FROM "CaseParticipant" cp
+       WHERE cp."userId" = NEW."id"
+    LOOP
+      PERFORM refresh_case_search(fall.id);
+    END LOOP;
+  END IF;
+  RETURN NULL;
+END;
+$$ LANGUAGE plpgsql;
+
+CREATE TRIGGER search_on_case_participant
+  AFTER INSERT OR UPDATE OR DELETE ON "CaseParticipant"
+  FOR EACH ROW EXECUTE FUNCTION search_index_trigger();
+
+-- Der Worker gleicht Anzeigenamen mit Discord ab; ohne diesen Auslöser fände
+-- die Suche nach einer Umbenennung weiter den alten Namen.
+CREATE TRIGGER search_on_user_name
+  AFTER UPDATE OF "displayName" ON "User"
+  FOR EACH ROW EXECUTE FUNCTION search_index_trigger();
+
+-- Bestand einmal nachziehen, sonst tragen die vorhandenen Akten den alten
+-- Vektor ohne Beteiligte.
+SELECT refresh_case_search(c."id") FROM "Case" c;