Phase 7: Benachrichtigungen und Termine

Terminkalender mit Serienterminen, Selbstanmeldung, Warteliste und
Anwesenheitsliste. Vier Zustellwege hinter Schnittstellen: echtes SMTP,
ntfy (selbst gehostet), Telegram und Web-Push. Kalenderabonnement als
ICS-Feed, digitaler Dienstausweis mit signiertem QR und Pruefseite.

Niemand wird ungefragt benachrichtigt: ein neuer Zustellweg hat eine leere
Ereignisliste, und der Seed legt bewusst keine an. Was das Netz der Wehr
verlaesst, bekommt nur die Kurzfassung ohne Namen und Details.

Kein CalDAV (Lesen genuegt, ICS kann jeder Kalender) und kein WhatsApp
(Verarbeitung ueber Meta, Kosten je Konversation, Telefonbuchabgleich) --
beides im README begruendet.

56 neue Unit-Tests, 17 neue E2E-Tests, Version 0.8.0.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Florian Wilde
2026-09-04 08:39:38 +02:00
co-authored by Claude Opus 5
parent c779266450
commit 0b8874da26
134 changed files with 9340 additions and 123 deletions
@@ -0,0 +1,209 @@
-- Phase 7 — Benachrichtigungen und Termine
--
-- Von Prisma erzeugt, danach von Hand um die DropIndex-Anweisungen erleichtert
-- (siehe Kopf der Migration 20260903190219_atemschutz_fwdv7). Rechte,
-- Mandantentrennung und die Regeln fuer Termine stehen in der Migration
-- daneben.
-- CreateEnum
CREATE TYPE "EreignisTyp" AS ENUM ('PRUEFUNG_FAELLIG', 'MANGEL_GEMELDET', 'QUALIFIKATION_LAEUFT_AB', 'TERMIN_NEU', 'TERMIN_ERINNERUNG', 'TERMIN_ABGESAGT', 'EINSATZBERICHT_FREIGEGEBEN');
-- CreateEnum
CREATE TYPE "Kanal" AS ENUM ('MAIL', 'TELEGRAM', 'NTFY', 'WEBPUSH');
-- CreateEnum
CREATE TYPE "TerminArt" AS ENUM ('DIENST', 'UEBUNG', 'LEHRGANG', 'ARBEITSDIENST', 'VERANSTALTUNG', 'SITZUNG', 'SONSTIGES');
-- CreateEnum
CREATE TYPE "Serienmuster" AS ENUM ('KEINE', 'WOECHENTLICH', 'ZWEIWOECHENTLICH', 'MONATLICH', 'JAEHRLICH');
-- CreateEnum
CREATE TYPE "Teilnahmestand" AS ENUM ('ZUGESAGT', 'ABGESAGT', 'WARTELISTE');
-- CreateEnum
CREATE TYPE "Zustellstand" AS ENUM ('WARTET', 'GESENDET', 'FEHLGESCHLAGEN', 'UEBERSPRUNGEN');
-- CreateTable
CREATE TABLE "benachrichtigungsvorlage" (
"id" UUID NOT NULL,
"organisationId" UUID NOT NULL,
"ereignis" "EreignisTyp" NOT NULL,
"kanal" "Kanal" NOT NULL,
"betreff" VARCHAR(200),
"text" VARCHAR(2000) NOT NULL,
"rollen" "RolleSchluessel"[],
"aktiv" BOOLEAN NOT NULL DEFAULT true,
"erstelltAm" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
"geaendertAm" TIMESTAMPTZ(3) NOT NULL,
CONSTRAINT "benachrichtigungsvorlage_pkey" PRIMARY KEY ("id")
);
-- CreateTable
CREATE TABLE "zustellkanal" (
"id" UUID NOT NULL,
"organisationId" UUID NOT NULL,
"personId" UUID NOT NULL,
"kanal" "Kanal" NOT NULL,
"ziel" VARCHAR(500) NOT NULL,
"p256dh" VARCHAR(200),
"auth" VARCHAR(200),
"ereignisse" "EreignisTyp"[],
"bezeichnung" VARCHAR(120),
"aktiv" BOOLEAN NOT NULL DEFAULT true,
"letzteZustellung" TIMESTAMPTZ(3),
"fehlversuche" INTEGER NOT NULL DEFAULT 0,
"erstelltAm" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
"geaendertAm" TIMESTAMPTZ(3) NOT NULL,
CONSTRAINT "zustellkanal_pkey" PRIMARY KEY ("id")
);
-- CreateTable
CREATE TABLE "benachrichtigung" (
"id" UUID NOT NULL,
"organisationId" UUID NOT NULL,
"ereignis" "EreignisTyp" NOT NULL,
"kanal" "Kanal" NOT NULL,
"personId" UUID NOT NULL,
"betreff" VARCHAR(200),
"text" VARCHAR(2000) NOT NULL,
"ziel" VARCHAR(500) NOT NULL,
"entitaet" VARCHAR(80),
"entitaetId" UUID,
"stand" "Zustellstand" NOT NULL DEFAULT 'WARTET',
"versuche" INTEGER NOT NULL DEFAULT 0,
"gesendetAm" TIMESTAMPTZ(3),
"fehler" VARCHAR(500),
"erstelltAm" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
CONSTRAINT "benachrichtigung_pkey" PRIMARY KEY ("id")
);
-- CreateTable
CREATE TABLE "termin" (
"id" UUID NOT NULL,
"organisationId" UUID NOT NULL,
"art" "TerminArt" NOT NULL DEFAULT 'DIENST',
"titel" VARCHAR(200) NOT NULL,
"beschreibung" VARCHAR(4000),
"ort" VARCHAR(200),
"beginn" TIMESTAMPTZ(3) NOT NULL,
"ende" TIMESTAMPTZ(3),
"ganztaegig" BOOLEAN NOT NULL DEFAULT false,
"leiterId" UUID,
"teilnehmerLimit" INTEGER,
"anmeldeschluss" TIMESTAMPTZ(3),
"anmeldungNoetig" BOOLEAN NOT NULL DEFAULT false,
"serieId" UUID,
"serienmuster" "Serienmuster" NOT NULL DEFAULT 'KEINE',
"abgesagtAm" TIMESTAMPTZ(3),
"absageGrund" VARCHAR(500),
"erinnertAm" TIMESTAMPTZ(3),
"erstelltAm" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
"geaendertAm" TIMESTAMPTZ(3) NOT NULL,
"geloeschtAm" TIMESTAMPTZ(3),
CONSTRAINT "termin_pkey" PRIMARY KEY ("id")
);
-- CreateTable
CREATE TABLE "terminanmeldung" (
"id" UUID NOT NULL,
"organisationId" UUID NOT NULL,
"terminId" UUID NOT NULL,
"personId" UUID NOT NULL,
"stand" "Teilnahmestand" NOT NULL DEFAULT 'ZUGESAGT',
"grund" VARCHAR(300),
"anwesend" BOOLEAN,
"gemeldetAm" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
"geaendertAm" TIMESTAMPTZ(3) NOT NULL,
CONSTRAINT "terminanmeldung_pkey" PRIMARY KEY ("id")
);
-- CreateTable
CREATE TABLE "kalenderzugang" (
"id" UUID NOT NULL,
"organisationId" UUID NOT NULL,
"personId" UUID NOT NULL,
"bezeichnung" VARCHAR(120) NOT NULL,
"tokenHash" VARCHAR(64) NOT NULL,
"nurEigene" BOOLEAN NOT NULL DEFAULT false,
"aktiv" BOOLEAN NOT NULL DEFAULT true,
"letzterZugriff" TIMESTAMPTZ(3),
"zugriffe" INTEGER NOT NULL DEFAULT 0,
"erstelltAm" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
"widerrufenAm" TIMESTAMPTZ(3),
CONSTRAINT "kalenderzugang_pkey" PRIMARY KEY ("id")
);
-- CreateIndex
CREATE UNIQUE INDEX "benachrichtigungsvorlage_organisationId_ereignis_kanal_key" ON "benachrichtigungsvorlage"("organisationId", "ereignis", "kanal");
-- CreateIndex
CREATE INDEX "zustellkanal_organisationId_kanal_idx" ON "zustellkanal"("organisationId", "kanal");
-- CreateIndex
CREATE UNIQUE INDEX "zustellkanal_personId_kanal_ziel_key" ON "zustellkanal"("personId", "kanal", "ziel");
-- CreateIndex
CREATE INDEX "benachrichtigung_organisationId_stand_idx" ON "benachrichtigung"("organisationId", "stand");
-- CreateIndex
CREATE INDEX "benachrichtigung_organisationId_personId_erstelltAm_idx" ON "benachrichtigung"("organisationId", "personId", "erstelltAm" DESC);
-- CreateIndex
CREATE INDEX "termin_organisationId_beginn_idx" ON "termin"("organisationId", "beginn");
-- CreateIndex
CREATE INDEX "termin_organisationId_serieId_idx" ON "termin"("organisationId", "serieId");
-- CreateIndex
CREATE INDEX "terminanmeldung_organisationId_personId_idx" ON "terminanmeldung"("organisationId", "personId");
-- CreateIndex
CREATE UNIQUE INDEX "terminanmeldung_terminId_personId_key" ON "terminanmeldung"("terminId", "personId");
-- CreateIndex
CREATE INDEX "kalenderzugang_organisationId_personId_idx" ON "kalenderzugang"("organisationId", "personId");
-- CreateIndex
CREATE UNIQUE INDEX "kalenderzugang_tokenHash_key" ON "kalenderzugang"("tokenHash");
-- AddForeignKey
ALTER TABLE "benachrichtigungsvorlage" ADD CONSTRAINT "benachrichtigungsvorlage_organisationId_fkey" FOREIGN KEY ("organisationId") REFERENCES "organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-- AddForeignKey
ALTER TABLE "zustellkanal" ADD CONSTRAINT "zustellkanal_organisationId_fkey" FOREIGN KEY ("organisationId") REFERENCES "organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-- AddForeignKey
ALTER TABLE "zustellkanal" ADD CONSTRAINT "zustellkanal_personId_fkey" FOREIGN KEY ("personId") REFERENCES "person"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-- AddForeignKey
ALTER TABLE "benachrichtigung" ADD CONSTRAINT "benachrichtigung_organisationId_fkey" FOREIGN KEY ("organisationId") REFERENCES "organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-- AddForeignKey
ALTER TABLE "benachrichtigung" ADD CONSTRAINT "benachrichtigung_personId_fkey" FOREIGN KEY ("personId") REFERENCES "person"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-- AddForeignKey
ALTER TABLE "termin" ADD CONSTRAINT "termin_organisationId_fkey" FOREIGN KEY ("organisationId") REFERENCES "organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-- AddForeignKey
ALTER TABLE "termin" ADD CONSTRAINT "termin_leiterId_fkey" FOREIGN KEY ("leiterId") REFERENCES "person"("id") ON DELETE SET NULL ON UPDATE CASCADE;
-- AddForeignKey
ALTER TABLE "terminanmeldung" ADD CONSTRAINT "terminanmeldung_organisationId_fkey" FOREIGN KEY ("organisationId") REFERENCES "organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-- AddForeignKey
ALTER TABLE "terminanmeldung" ADD CONSTRAINT "terminanmeldung_terminId_fkey" FOREIGN KEY ("terminId") REFERENCES "termin"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-- AddForeignKey
ALTER TABLE "terminanmeldung" ADD CONSTRAINT "terminanmeldung_personId_fkey" FOREIGN KEY ("personId") REFERENCES "person"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-- AddForeignKey
ALTER TABLE "kalenderzugang" ADD CONSTRAINT "kalenderzugang_organisationId_fkey" FOREIGN KEY ("organisationId") REFERENCES "organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
-- AddForeignKey
ALTER TABLE "kalenderzugang" ADD CONSTRAINT "kalenderzugang_personId_fkey" FOREIGN KEY ("personId") REFERENCES "person"("id") ON DELETE CASCADE ON UPDATE CASCADE;
@@ -0,0 +1,111 @@
-- =============================================================================
-- Phase 7: Mandantentrennung und die Regeln fuer Termine und Zustellung.
--
-- 1. Row Level Security fuer die sechs neuen Tabellen.
--
-- 2. Bedingungen, die Unmoegliches abweisen: ein Termin, der endet, bevor er
-- beginnt; ein Teilnehmerlimit von null; ein Anmeldeschluss nach dem
-- Termin.
--
-- 3. Teilindizes fuer die beiden Abfragen, die staendig laufen: was steht an
-- (kommende Termine) und was ist noch zu verschicken (offene
-- Benachrichtigungen).
--
-- 4. Ein zugestellter Eintrag wird nicht geloescht. Er ist der Nachweis
-- dafuer, wer wann worueber informiert wurde — und wer nicht.
-- =============================================================================
-- -----------------------------------------------------------------------------
-- Row Level Security
-- -----------------------------------------------------------------------------
DO $$
DECLARE
tabelle text;
BEGIN
FOREACH tabelle IN ARRAY ARRAY[
'benachrichtigungsvorlage',
'zustellkanal',
'benachrichtigung',
'termin',
'terminanmeldung',
'kalenderzugang'
]
LOOP
EXECUTE format('ALTER TABLE %I ENABLE ROW LEVEL SECURITY', tabelle);
EXECUTE format(
'CREATE POLICY %I ON %I FOR ALL '
'USING ("organisationId" = aktuelle_organisation()) '
'WITH CHECK ("organisationId" = aktuelle_organisation())',
tabelle || '_mandant', tabelle
);
END LOOP;
END;
$$;
-- -----------------------------------------------------------------------------
-- Was es nicht geben darf
-- -----------------------------------------------------------------------------
ALTER TABLE "termin" ADD CONSTRAINT "termin_ende_nach_beginn" CHECK (
"ende" IS NULL OR "ende" >= "beginn"
);
ALTER TABLE "termin" ADD CONSTRAINT "termin_limit_sinnvoll" CHECK (
"teilnehmerLimit" IS NULL OR "teilnehmerLimit" > 0
);
-- Ein Anmeldeschluss nach dem Termin ist keiner.
ALTER TABLE "termin" ADD CONSTRAINT "termin_anmeldeschluss_vorher" CHECK (
"anmeldeschluss" IS NULL OR "anmeldeschluss" <= "beginn"
);
ALTER TABLE "benachrichtigung" ADD CONSTRAINT "benachrichtigung_versuche_plausibel" CHECK (
"versuche" >= 0 AND "versuche" <= 100
);
-- -----------------------------------------------------------------------------
-- Teilindizes fuer den laufenden Betrieb
-- -----------------------------------------------------------------------------
-- Was noch raus muss. Die Tabelle waechst ueber Jahre, die Warteschlange ist
-- immer kurz.
CREATE INDEX "benachrichtigung_offen" ON "benachrichtigung" ("organisationId", "erstelltAm")
WHERE "stand" = 'WARTET';
-- Was ansteht. Abgesagte und geloeschte Termine stehen im Kalender nicht mehr.
CREATE INDEX "termin_kommend" ON "termin" ("organisationId", "beginn")
WHERE "geloeschtAm" IS NULL AND "abgesagtAm" IS NULL;
-- Wer sich zu was gemeldet hat — fuer die Anwesenheitsliste.
CREATE INDEX "terminanmeldung_zugesagt" ON "terminanmeldung" ("terminId")
WHERE "stand" = 'ZUGESAGT';
-- -----------------------------------------------------------------------------
-- Volltextsuche ueber Termine
-- -----------------------------------------------------------------------------
CREATE INDEX "termin_suche_titel" ON "termin" USING GIN ("titel" gin_trgm_ops);
-- -----------------------------------------------------------------------------
-- Rechte fuer die Anwendungsrolle
--
-- Eine zugestellte Benachrichtigung wird nicht geloescht: sie ist der Nachweis
-- dafuer, wer wann worueber informiert wurde. Geaendert werden darf sie, denn
-- der Hintergrundprozess traegt Zustellstand und Fehlversuche nach.
-- -----------------------------------------------------------------------------
DO $$
BEGIN
IF EXISTS (SELECT FROM pg_roles WHERE rolname = 'florian_app') THEN
EXECUTE 'GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO florian_app';
EXECUTE 'GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO florian_app';
EXECUTE 'REVOKE INSERT, UPDATE, DELETE ON "berechtigung" FROM florian_app';
EXECUTE 'REVOKE UPDATE, DELETE ON "audit_log" FROM florian_app';
EXECUTE 'REVOKE UPDATE, DELETE ON "kiosk_vorgang" FROM florian_app';
EXECUTE 'REVOKE UPDATE, DELETE ON "druckmessung" FROM florian_app';
EXECUTE 'REVOKE UPDATE, DELETE ON "atemschutz_ereignis" FROM florian_app';
EXECUTE 'REVOKE DELETE ON "benachrichtigung" FROM florian_app';
ELSE
RAISE NOTICE 'Rolle florian_app nicht vorhanden — Rechtevergabe uebersprungen.';
END IF;
END;
$$;