Merge main with notdienst planning and notification improvements

deploy/README.md

@@ -53,7 +53,7 @@ Grenzen: 10 MiB pro Datei, fünf Dateien und 25 MiB pro Nachricht; standardmäß
 
 `npm run uploads:cleanup` zeigt zunächst nur verwaiste Dateien mit mindestens 24 Stunden Alter. Nach Prüfung entfernt `npm run uploads:cleanup -- --delete` diese Dateien. Backups, Speicherüberwachung und eine Aufbewahrungs-/Löschstrategie für Backups separat einrichten. Dateien gelöschter Datensätze werden auch unmittelbar bestmöglich entfernt.
 
-Die SQL-Migrationen ergänzen **41 zusammengesetzte Tenant-Fremdschlüssel**, die Prisma wegen der vorhandenen optionalen Cascade-/SetNull-Beziehungen nicht vollständig abbildet. Zukünftige generierte Migrationen auf unbeabsichtigtes Entfernen dieser Constraints prüfen. Kein `prisma db push` auf verwalteten Datenbanken einsetzen. Runtime-Grants nach zukünftigen Migrationen erneut bereitstellen.
+Die SQL-Migrationen ergänzen **45 zusammengesetzte Tenant-Fremdschlüssel**, die Prisma wegen der vorhandenen optionalen Cascade-/SetNull-Beziehungen nicht vollständig abbildet. Zukünftige generierte Migrationen auf unbeabsichtigtes Entfernen dieser Constraints prüfen. Kein `prisma db push` auf verwalteten Datenbanken einsetzen. Runtime-Grants nach zukünftigen Migrationen erneut bereitstellen.
 
 ## Verifikation und Updates
 
@@ -68,3 +68,20 @@ npm audit --omit=dev
 Die Integrationstests setzen eine ausdrücklich isolierte lokale PostgreSQL-Datenbank namens `kita_security_test` voraus; `SECURITY_TEST_DATABASE_URL` darf keine Anwendungsdaten enthalten. `npm run test:security` prüft Aktionen und echte DB-Transaktionen. `npm run test:security:http` benötigt den Production-Server auf localhost:3057 mit derselben Testdatenbank, `UPLOAD_DIR` und dem im Test dokumentierten Test-Secret. Niemals dieses Test-Secret in Produktion verwenden.
 
 Docker-Images sind auf Digests fixiert. Neue Sicherheitsreleases regelmäßig prüfen und die Digests bewusst aktualisieren. Zum Prüfzeitpunkt verbleibt eine ungepatchte `braces`-Schwachstelle in der Entwicklungs-Lint-Kette; `npm audit --force` löst sie nicht sinnvoll. Der Runtime-Audit ist ohne bekannte Findings. NextAuth bleibt eine Beta-Abhängigkeit und benötigt weiterhin Update-Beobachtung.
+
+## Familieneinladungen und Abwesenheiten
+
+Die Migration `20261010000000_family_invitation_flows` ergänzt den Versandstatus und die mandantengebundene Empfängerreferenz. Der bestehende Migrationsdienst spielt sie vor dem App-Start ein; kein `prisma db push` und kein erneutes Löschen erforderlich. Fehlgeschlagene Familieneinladungen können in der Familienübersicht erneut versendet werden. Fachliche Abläufe: [Familien und Abwesenheiten](../docs/FAMILIEN_UND_ABWESENHEITEN.md).
+
+
+## Notdienst-Erinnerungen und Veröffentlichungsmails
+
+Die Migration `20261012000000_notdienst_notifications` ergänzt Mailaufträge und die monatliche Erinnerungsrunde. Vor dem Start der neuen App `npm run db:migrate:deploy` ausführen und die Runtime-Grants erneut bereitstellen. Der bestehende Initialisierungsdienst erledigt beide Schritte im Compose-Deployment. Kein `db push` verwenden; die bisherigen Tenant-Constraints bleiben erhalten.
+
+`NOTDIENST_JOB_SECRET` (mindestens 32 Zeichen), `AUTH_URL`/`NEXT_PUBLIC_SITE_URL`, `RESEND_API_KEY` und `EMAIL_FROM` müssen eingerichtet sein. Ein neues Secret oder ein zusätzlicher externer Cronjob ist nicht nötig, wenn der vorhandene Notdienstjob bereits konfiguriert ist. Der Produktionsstart überwacht Webserver und Worker gemeinsam: der Worker wird nach einem Abbruch neu gestartet; beim Ende des Webservers werden beide Prozesse beendet.
+
+Der geschützte `POST /api/jobs/notdienstalarme` verarbeitet weiterhin Alarme und zusätzlich Planungserinnerungen/gespeicherte Benachrichtigungen. Die JSON-Antwort ergänzt `planning` mit `queued`, `sent`, `failed` und `skipped`. Ein Lauf bearbeitet bis zu 100 fällige Kitas und zwölf Planungsmails (vier parallel). Der Worker ruft die Route minütlich auf. Versanddetails und manuelle Wiederholung finden sich in der Monatsplanung.
+
+Die automatische Runde läuft einmal pro Kita und Folgemonat, ab 9 Uhr Berliner Zeit, standardmäßig ab dem 19. (sieben Tage vor Ende der Eintragsfrist am 26.). Ein verpasster Termin wird bis zum 26. nachgeholt. Die Einstellung 0 schaltet diese Runde ab; ein bereits veröffentlichter Plan beendet Verfügbarkeitserinnerungen. Manuelle Erinnerungen sind für den offenen Folgemonat möglich und je Konto/Tag mit der automatischen Runde zusammen dedupliziert.
+
+Veröffentlichung und Mailvorbereitung sind eine Transaktion. Anschließend wird der Versand versucht; ein Mailfehler setzt den Plan nicht zurück. Wiederholungen prüfen aktuelle Konten, Haushalt, aktive Kinder und Einteilungen erneut. Pro Konto wird eine Mail mit allen aktuellen eigenen Diensten vorbereitet. Versandaufträge erhalten einen stabilen Idempotenzschlüssel je Nachrichteninhalt und eine fünfminütige Reservierung; Fehler erhalten zunehmende Wartezeiten und bleiben sichtbar. Der Mailtransport bricht HTTP-Anfragen nach zehn Sekunden ab. Anbieterannahme, wiederholter Versand nach unbekanntem Transportausgang und tatsächliche Postfachzustellung sind weiterhin durch die Garantien des Mailanbieters begrenzt.

deploy/production.env.example

@@ -40,7 +40,7 @@ RESEND_API_KEY="re_[PRODUCTION_API_KEY]"
 EMAIL_FROM="Kita-Planer <[absender@deine-domain.de]>"
 ADMIN_EMAIL="[kontakt@deine-domain.de]"
 
-# Automatische Notdienst-Fristpruefung im App-Container.
+# Automatische Notdienst-Fristpruefung, Verfuegbarkeitserinnerungen und Mail-Wiederholungen.
 # Eigenes Secret, mindestens 32 Zeichen; generieren mit: openssl rand -hex 32
 NOTDIENST_JOB_SECRET="[GENERATE_ME]"
 

deploy/sql/familieneinladungen.sql

@@ -0,0 +1,32 @@
+-- Historical upgrade helper, retained for compatibility tests only.
+-- Production uses prisma/migrations/20261010000000_family_invitation_flows.
+-- Additive upgrade before Prisma db push; safe to run repeatedly.
+-- On a fresh database Prisma creates the entire schema afterwards.
+DO $upgrade$
+BEGIN
+  IF to_regclass('invitations') IS NULL THEN
+    RETURN;
+  END IF;
+
+  ALTER TABLE "invitations"
+    ADD COLUMN IF NOT EXISTS "userId" TEXT,
+    ADD COLUMN IF NOT EXISTS "sentAt" TIMESTAMP(3),
+    ADD COLUMN IF NOT EXISTS "lastAttemptAt" TIMESTAMP(3),
+    ADD COLUMN IF NOT EXISTS "leaseUntil" TIMESTAMP(3),
+    ADD COLUMN IF NOT EXISTS "attempts" INTEGER NOT NULL DEFAULT 0,
+    ADD COLUMN IF NOT EXISTS "failed" BOOLEAN NOT NULL DEFAULT false;
+
+  CREATE UNIQUE INDEX IF NOT EXISTS "invitations_userId_key" ON "invitations"("userId");
+
+  IF NOT EXISTS (
+    SELECT 1 FROM pg_constraint
+    WHERE conname = 'invitations_userId_fkey'
+      AND conrelid = 'invitations'::regclass
+  ) THEN
+    ALTER TABLE "invitations"
+      ADD CONSTRAINT "invitations_userId_fkey"
+      FOREIGN KEY ("userId") REFERENCES "users"("id")
+      ON DELETE CASCADE ON UPDATE CASCADE;
+  END IF;
+END
+$upgrade$;

deploy/sql/notdienstalarm.sql

@@ -1,5 +1,7 @@
+-- HISTORISCHER UPGRADEPFAD: aktuelle Releases verwenden prisma/migrations und deploy/README.md.
+-- Nicht zusätzlich zu versionierten Migrationen oder auf bereits aktualisierten Datenbanken ausführen.
 -- Additives Upgrade für einen Personalbereich einschließlich vorhandener Mail-Erweiterung.
--- Einmalig vor dem Start der neuen Anwendung ausführen, sofern nicht prisma db push verwendet wird.
+-- Beschreibt ausschließlich den damaligen Ausgangsstand vor Einführung der Migrationshistorie.
 BEGIN;
 
 -- CreateEnum

deploy/sql/personalbereich-email.sql

@@ -1,5 +1,7 @@
+-- HISTORISCHER UPGRADEPFAD: aktuelle Releases verwenden prisma/migrations und deploy/README.md.
+-- Nicht zusätzlich zu versionierten Migrationen oder auf bereits aktualisierten Datenbanken ausführen.
 -- Nur E-Mail-Erweiterung für einen bereits mit 043fed2 eingeführten Personalbereich.
--- Alternative zu prisma db push, nicht zusätzlich oder mehrfach ausführen.
+-- Beschreibt ausschließlich den damaligen Ausgangsstand vor Einführung der Migrationshistorie.
 BEGIN;
 
 -- AlterTable

deploy/sql/personalbereich.sql

@@ -1,5 +1,7 @@
+-- HISTORISCHER UPGRADEPFAD: aktuelle Releases verwenden prisma/migrations und deploy/README.md.
+-- Nicht zusätzlich zu versionierten Migrationen oder auf bereits aktualisierten Datenbanken ausführen.
 -- Einmalige Einführung des vollständigen Personalbereichs inklusive E-Mails ab ec3f4f9.
--- Alternative zu prisma db push, nicht zusätzlich oder mehrfach ausführen.
+-- Beschreibt ausschließlich den damaligen Ausgangsstand vor Einführung der Migrationshistorie.
 BEGIN;
 
 -- CreateEnum

docs/ABLAUFPRUEFUNG.md

@@ -0,0 +1,214 @@
+# Prüfung der Bedienabläufe im Kita-Planer
+
+Stand: 9. Oktober 2026 · geprüfter Code: `4702bf5abb0037ab9e0913dbef01ffbe21bbb96d` (`origin/main` zum Prüfzeitpunkt).
+
+Fortschreibung: F01 (Familieneinladungen), F02 (Abwesenheitsverwaltung) und die Entfernung des künstlichen Gruppenfilters aus F12 wurden anschließend auf `codex/family-absence-flows` bearbeitet. Den neuen Ablauf und die Deployment-Schritte beschreibt [Familien und Abwesenheiten](FAMILIEN_UND_ABWESENHEITEN.md). Die folgenden Befunde dokumentieren weiterhin den ursprünglichen Prüfstand.
+
+## Umfang und Methode
+
+Geprüft wurden die zentralen Abläufe für Eltern, Fachkräfte, Kita-Admins und Notdienst-Koordination: Einrichtung, Familien, Profile, Einladungen, Abwesenheiten, Arbeitszeit und Urlaub, Kalender und Anmeldungen, Mitteilungen, Dienste, Notdienstplanung und Alarmierung. Login, Kontoverwaltung und die Superadmin-Oberflächen wurden ergänzend im Quellcode geprüft.
+
+Grundlage sind die aktuellen Seiten, Formulare, Server-Aktionen und Datenmodelle. Einzelne Abläufe wurden zusätzlich in einer lokalen Vorschau mit synthetischen Testkonten nachvollzogen: Familienverwaltung, Eltern-Abwesenheiten sowie Kalender in Agenda- und Listenansicht. Dabei wurden keine fachlichen Datensätze angelegt, geändert oder gelöscht und keine E-Mails verschickt. Die produktive Website wurde nicht getestet.
+
+Die folgenden Befunde beschreiben den bestehenden Stand. Die vorgeschlagenen Zielabläufe sind noch nicht umgesetzt. Diese Prüfung ist kein vollständiger Sicherheitstest oder Test aller Berechnungen. Die ältere `FUNKTIONSUEBERSICHT.md` wurde nicht als Beleg für fehlende Funktionen verwendet: Kalender-Anmeldungen, Mitteilungen, Personalverwaltung und Notdienstalarm sind inzwischen vorhanden.
+
+## Bereits mit dem Nutzer geklärt
+
+- Eltern dürfen eigene Abwesenheitsmeldungen **für zukünftige Tage** ändern und zurücknehmen. Für laufende Tage ist die Kita zuständig.
+- **Kita-Admins dürfen innerhalb ihrer eigenen Kita weitere Admins und die Notdienst-Koordination ernennen.**
+
+Diese Regeln sind für die spätere Umsetzung verbindlich. Die Datumsregel muss auch auf dem Server gelten. Für Meldungen, die einen laufenden und zukünftige Tage umfassen, ist die Behandlung des zukünftigen Teilzeitraums noch zu konkretisieren.
+
+## Prioritäten
+
+„Hoch“ bezeichnet einen blockierten Ablauf, widersprüchliche Rückmeldungen oder fachlich irreführende Angaben. „Mittel“ bezeichnet vermeidbare Nacharbeit oder einen fehlenden direkten Weg. „Niedrig“ bezeichnet kleinere Verbesserungen bei Benennung und Orientierung.
+
+| ID | Priorität | Bereich | Wichtigster Befund |
+| --- | --- | --- | --- |
+| F01 | Hoch | Familieneinladungen | Gespeicherte Familie erscheint bei Mailfehler als fehlgeschlagener Vorgang; erneutes Senden fehlt. |
+| F02 | Hoch | Kinder-Abwesenheiten | Elternlink führt zu „Zugriff verweigert“; Ändern und Zurücknehmen fehlen. |
+| F03 | Hoch | Notdienst-Erinnerungen | Oberfläche verspricht Automatik, die Einstellung wird dafür nicht verwendet; unvollständige Rückmeldungen werden übergangen. |
+| F04 | Hoch | Rollenverwaltung | Weitere Kita-Admins und Koordination lassen sich nicht regulär ernennen. |
+| F05 | Mittel | Notdienstplan | Manuelle Einteilung zeigt Verfügbarkeit nicht am Auswahlpunkt; Erstveröffentlichung verschickt keine Nachricht. |
+| F06 | Mittel | Kalender und Mitbringen | Funktionen hängen von der Ansicht ab; Mitbring-Einträge lassen sich nur löschen und neu anlegen. |
+| F07 | Mittel | Mitteilungen | Korrektur und gezieltes erneutes Senden fehlen. |
+| F08 | Mittel | Eigene Ersteinrichtung | Haushalt, Kinder und Kontakt werden separat gespeichert; Admins ohne eigene Kinder gelten als unvollständig. |
+| F09 | Mittel | Personal | Neue Zeiterfassung verliert den betrachteten Zeitraum; Ein-Tages-Anträge verlangen zweimal das Datum. |
+| F10 | Niedrig | Ämter und Dienste | Gleich benannte Ämter-Schaltflächen lassen die betroffene Person erst nach dem Öffnen erkennen. |
+| F11 | Mittel | Zugang und Wiederherstellung | Passwort-Wiederherstellung fehlt; alte Aktivierungslinks und seltene Alt-Konten enden in Sackgassen. |
+| F12 | Hoch / Niedrig | Filter und Anzeigen | Abwesenheitsgruppen sind aus Namen erfunden; die Notdienst-Zahl im Menü ist fest eingetragen. |
+
+## F01 – Familieneinladungen sauber abschließen und erneut senden
+
+**Aktueller Ablauf:** Admin legt eine Familie samt Eltern und Kindern an. Die Datenbank speichert die Familie, Konten und Aktivierungslinks. Anschließend werden die Einladungsmails versendet. Scheitert eine Mail, meldet die Aktion einen Formularfehler; der erfolgreiche Abschluss und die Aktualisierung der Ansicht bleiben aus. Ein erneuter Speicherversuch kann dann an den bereits angelegten E-Mail-Adressen scheitern. Bei mehreren Einladungen stoppt der Versand bereits beim ersten Fehler.
+
+Die Familienliste zeigt offene Einladungen, bietet aber weder dort noch in „Details“ eine Funktion zum erneuten Senden. Das wurde im lokalen Browser bestätigt. Auch der Hinweis eines abgelaufenen Aktivierungslinks, beim Admin einen neuen Link anzufordern, hat damit keinen passenden Bedienweg.
+
+**Vorgeschlagener Zielablauf:** Familie einmal anlegen → Erfolg anzeigen und Liste aktualisieren → Versandstatus je Elternteil anzeigen → bei Bedarf ausschließlich die Einladung erneut senden. Der Datensatz bleibt unabhängig vom Mailversand erfolgreich angelegt. Fehlgeschlagene Mails werden gespeichert und gezielt wiederholt; weitere Empfänger werden trotz eines einzelnen Fehlers bearbeitet.
+
+**Belege:** `src/app/dashboard/families/actions.ts:125`, `:277`, `:459`; `src/app/dashboard/families/add-family-dialog.tsx`; `src/app/dashboard/families/_components/families-list-client.tsx`; `src/app/dashboard/families/edit-family-dialog.tsx`.
+
+**Abnahme:** Simulierter Mailfehler führt zu genau einer Familie, sichtbarem Versandfehler und einem funktionierenden erneuten Senden ohne erneute Personeneingabe. Der kürzlich verbesserte Fachkräfte-Ablauf dient als Vorlage.
+
+## F02 – Eigene Abwesenheiten direkt verwalten
+
+**Aktueller Ablauf:** Eltern melden ein Kind ab und sehen die Meldung auf der Übersicht. Dort fehlen Änderungs- und Rücknahmeaktionen. „Alle Abwesenheiten“ führt auf eine Seite, die nur Admins, Koordination und Fachkräfte betreten dürfen. Der Elternaccount erreicht im lokalen Browser „Zugriff verweigert“.
+
+Die vorhandene Server-Aktion `deleteAbsence` wird von keiner Oberfläche verwendet. Sie prüft die Haushaltszugehörigkeit, aber bisher keine Beschränkung auf zukünftige Tage. Eine Aktion zum Ändern fehlt. Die Kita-Übersicht bietet ebenfalls nur die Anzeige, keinen direkten Korrekturweg für laufende Meldungen.
+
+**Vorgeschlagener Zielablauf:** „Meine Abwesenheiten“ → Meldung ansehen → zukünftige Tage bearbeiten oder zurücknehmen. Für laufende Tage führt ein verständlicher Hinweis zur Kita; berechtigte Kita-Nutzer können die Meldung in ihrer Übersicht korrigieren. Eltern bekommen eine eigene Haushaltsansicht. Die kitaweite Übersicht behält ihre bestehenden Zugriffsgrenzen.
+
+**Belege:** `src/app/dashboard/absence-card.tsx:234`, `:241`; `src/app/dashboard/admin/abwesenheiten/page.tsx:16`; `src/actions/absences.ts:107`; `src/app/dashboard/admin/abwesenheiten/absence-table.tsx`.
+
+**Abnahme:** Eltern erreichen ihre Meldungen ohne Zugriffsfehler. Änderungen gelten nur für den eigenen Haushalt und die erlaubten Tage; Kita-Korrekturen sind innerhalb derselben Kita möglich. Für die Datumsgrenze gilt die lokale Kita-Zeitzone.
+
+## F03 – Notdienst-Einstellungen und Erinnerungen verständlich machen
+
+**Aktueller Ablauf:** „Mindesteinteilungen pro Kind/Monat“ wird als Richtmaß der automatischen Verteilung erklärt. Tatsächlich bestimmt der Wert die erforderliche Anzahl gemeldeter Verfügbarkeiten. „Erinnerungsfrist“ verspricht automatische E-Mails; im geprüften Code wird die Einstellung gespeichert und angezeigt, aber von keinem Erinnerungsjob ausgewertet. Die Eingabesperre folgt stattdessen dem fest codierten Stichtag 26. Der vorhandene Notdienstalarm-Job betrifft Alarm-Erinnerungen und ersetzt diese Verfügbarkeits-Erinnerung nicht.
+
+Die manuelle Erinnerungsaktion behandelt eine Familie schon nach einem einzigen Verfügbarkeitseintrag als beantwortet. Familien unterhalb ihrer geforderten Anzahl werden dadurch nicht angeschrieben. Einzelne Versandfehler landen im Log; die Oberfläche zeigt nur die Anzahl erfolgreicher Mails. Erneutes Auslösen wiederholt auch bereits erfolgreich versendete Mails.
+
+Zusätzlich kann die Planung einen beliebigen Monat anzeigen. Der Link in einer Erinnerung führt dagegen ohne Monatsangabe zur Elternseite, die den nächsten Monat öffnet. Erinnerung und Eingabe können dadurch unterschiedliche Monate betreffen.
+
+**Vorgeschlagener Zielablauf:** „Erforderliche Verfügbarkeiten“ und tatsächlichen Abgabeschluss klar benennen → Rücklauf als „fehlt / unvollständig / vollständig“ zeigen → Empfänger vor dem Versand sichtbar machen → Versandstatus und gezieltes Wiederholen anbieten. Eine automatische Erinnerung benötigt einen echten Job und eine passende Einstellung. Erinnerungen müssen den betroffenen Monat öffnen oder auf den tatsächlich bearbeitbaren Monat beschränkt sein.
+
+**Belege:** `src/app/dashboard/notdienst/plan/_components/settings-modal.tsx:76`, `:95`; `src/app/dashboard/notdienst/page.tsx:52`; `src/lib/date-utils.ts:14`; `src/app/dashboard/notdienst/plan/actions.ts:426`, `:485`, `:503`, `:532`.
+
+**Abnahme:** Texte entsprechen der tatsächlichen Berechnung und Automatik. Auch teilweise ausgefüllte Haushalte werden berücksichtigt. Der E-Mail-Link führt zur richtigen Eingabe; fehlgeschlagene Zustellungen können einzeln wiederholt werden.
+
+## F04 – Rollen dort verwalten, wo Personen verwaltet werden
+
+**Aktueller Ablauf:** Registrierung und Kita-Einrichtung erzeugen den ersten Admin. Familienanlage erzeugt Elternkonten; die Fachkräfte-Anlage erzeugt Fachkraftkonten. Es gibt keinen regulären Weg, einen weiteren Kita-Admin oder eine Notdienst-Koordination zu ernennen. Auch die Superadmin-Aktionen bieten keine Rollenänderung.
+
+Ein festes Amt wie „Vorstand“ ist eine gesonderte Zuordnung und verleiht keine Admin-Rechte. Diese Trennung ist in der Bedienung nicht ausreichend erkennbar.
+
+**Vorgeschlagener Zielablauf, vom Nutzer bestätigt:** Kita-Admin öffnet eine Person innerhalb seiner Kita → wählt deren Zugriffsrolle → speichert die Änderung. Zuständigkeiten/Ämter und Zugriffsrechte erhalten klar getrennte Bezeichnungen. Mindestens ein erreichbarer Kita-Admin muss bestehen bleiben. Dies muss auch bei der eigenen Kontolöschung berücksichtigt werden: `deleteMyAccount` prüft derzeit Notdienst-Verpflichtungen, aber keine letzte Admin-Rolle.
+
+**Belege:** `src/app/register/actions.ts:91`; `src/app/onboarding/actions.ts:130`; `src/app/dashboard/families/actions.ts:236`, `:404`; `src/app/admin/actions.ts`; `src/app/dashboard/families/duty-manager.tsx`; `src/app/dashboard/profil/actions.ts:286`.
+
+**Abnahme:** Rollenänderungen wirken innerhalb der eigenen Kita und sind nachvollziehbar. Ein Amt allein verändert keine Berechtigungen. Bestehende Fachkraftprofile und Haushaltszuordnungen werden bei einer Rollenänderung ausdrücklich berücksichtigt.
+
+## F05 – Manuelle Notdienstplanung ohne Gegenprüfung in einer zweiten Ansicht
+
+**Aktueller Ablauf:** Bei der manuellen Einteilung enthält die Auswahl sämtliche aktiven Kinder samt Familie und bisheriger Einteilungszahl. Ob die Familie am gewählten Tag verfügbar ist, steht nicht in dieser Auswahl. Die Koordination muss die Verfügbarkeit in einer anderen Ansicht prüfen. Geschwister erscheinen als separate Auswahlmöglichkeiten für denselben Haushalt.
+
+Beim erstmaligen Veröffentlichen wird der Plan freigegeben, aber keine E-Mail versendet. Spätere Änderungen können dagegen Benachrichtigungen auslösen. Das ist eine uneinheitliche Kommunikation; eine Mail zur Erstveröffentlichung ist ein Verbesserungsvorschlag, bisher keine bestätigte Produktregel.
+
+**Vorgeschlagener Zielablauf:** Tag auswählen → verfügbare Haushalte direkt erkennen → Einteilung vornehmen. Andere Haushalte bleiben für bewusst begründete Sonderfälle auswählbar und sind gekennzeichnet. Veröffentlichung bietet einen klar bezeichneten Schritt zur Information der Familien mit sichtbarem Versandstatus.
+
+**Belege:** `src/app/dashboard/notdienst/plan/page.tsx:118`; `src/app/dashboard/notdienst/plan/plan-view.tsx:643`; `src/app/dashboard/notdienst/plan/actions.ts:139`, `:353`.
+
+Der Übergang vom Plan zum Notdienstalarm ist dagegen bereits sinnvoll: Der Link übergibt die konkrete Einteilung, sodass diese im Alarmformular nicht erneut gesucht werden muss.
+
+## F06 – Kalenderfunktionen in jeder Ansicht erreichbar machen
+
+**Aktueller Ablauf:** Die Listenansicht bietet „Details“ einschließlich Mitbring-Liste. Die Monatsansicht bietet diese Inhalte über den Tagesdialog. Die Agenda zeigt zwar Termine und RSVP-Antworten, bietet aber keinen entsprechenden Detailzugang und keine Mitbring-Liste. Eltern müssen die Ansicht wechseln, um denselben Termin vollständig zu bearbeiten. Der Unterschied wurde im lokalen Browser bestätigt.
+
+Mitbring-Einträge besitzen nur Hinzufügen und Löschen. Eine Mengenänderung oder ein Tippfehler erfordert Löschen und erneute Eingabe.
+
+**Vorgeschlagener Zielablauf:** Einheitlicher Termindialog aus Monat, Agenda und Liste → Beschreibung, Anmeldung und Mitbringen am selben Ort. Eigene Mitbring-Einträge lassen sich direkt bearbeiten. Bestehende Berechtigungen für fremde Einträge bleiben maßgeblich. Aktueller Zeitraum und Filter bleiben beim Öffnen und Schließen erhalten.
+
+**Belege:** `src/app/dashboard/kalender/_components/calendar-overview-client.tsx:329`, `:856`; `src/app/dashboard/kalender/_components/termin-list.tsx:326`, `:429`; `src/app/dashboard/kalender/_components/mitbringsel-list.tsx:32`, `:46`; `src/app/dashboard/kalender/actions.ts:1048`, `:1089`.
+
+Die Anmeldung pro Familie oder Kind ist bereits vorhanden und integriert. Sie muss dafür nicht neu gebaut werden.
+
+## F07 – Mitteilungen korrigieren und Versand unabhängig wiederholen
+
+**Aktueller Ablauf:** Admins können eine Mitteilung erstellen und optional per E-Mail versenden. Nach der Veröffentlichung gibt es keine Bearbeitungsfunktion und keinen erneuten Versand. Die Admin-Seite zeigt nur die letzten acht Mitteilungen, ohne weiterführende Verwaltungsansicht. Eine Korrektur führt deshalb praktisch zu einem weiteren Beitrag; ein Mailfehler hat keinen Wiederholungsweg.
+
+Positiv: Die Aktion behandelt einen Mailfehler bereits als Warnung zu einer erfolgreich gespeicherten Mitteilung. Die Familienanlage sollte denselben verständlichen Abschluss bieten.
+
+**Vorgeschlagener Zielablauf:** Veröffentlichte Mitteilung öffnen → Inhalt korrigieren und Änderungsstand sichtbar machen → bei Bedarf über die Korrektur informieren. Für den Versand gibt es einen eigenen Status und eine gezielte Wiederholung. Ältere Mitteilungen bleiben für Admins verwaltbar.
+
+**Belege:** `src/actions/announcements.ts:80`, `:172`, `:203`, `:211`; `src/app/dashboard/admin/news/page.tsx:50`, `:116`.
+
+## F08 – Die eigene Ersteinrichtung zusammenführen und rollenabhängig gestalten
+
+**Aktueller Ablauf:** Wer noch keinen eigenen Haushalt hat, legt zuerst dessen Namen an, schließt den Dialog, legt Kinder in einem anderen Dialog an und ergänzt Kontaktdaten in einem weiteren Formular. Der Einrichtungshinweis verlangt einen Haushalt samt Kindern für alle Rollen außer Fachkräften – also auch für Admins oder Koordination ohne eigene Kita-Kinder.
+
+Dieser Befund betrifft die eigene Ersteinrichtung. Eltern, die über die Familienverwaltung eingeladen wurden, haben ihren Haushalt bereits; dort werden Eltern und Kinder zusammen erfasst.
+
+**Vorgeschlagener Zielablauf:** Eine geführte Einrichtung mit bekannten Angaben, Kontakten und – wenn relevant – Haushalt samt Kindern. Nach jedem Schritt ist der nächste direkt erreichbar. Admins und Koordination können angeben, ob sie auch als Eltern teilnehmen; fehlende eigene Kinder dürfen sonst keinen dauerhaften Unvollständigkeitshinweis erzeugen. Diese Rollenvariante ist noch fachlich zu bestätigen.
+
+Kleine Zusatzkorrektur: „Hinweis dauerhaft ausblenden“ wird heute über einen browserweiten Schlüssel gespeichert. Die Einstellung sollte dem jeweiligen Nutzer zugeordnet sein, damit ein anderes Konto am selben Gerät seine eigenen Hinweise behält.
+
+**Belege:** `src/app/dashboard/profil/_components/create-family-dialog.tsx:29`, `:57`; `src/app/dashboard/profil/page.tsx`; `src/components/OnboardingDialog.tsx:46`, `:55`.
+
+## F09 – Personalformulare mit dem betrachteten Tag verbinden
+
+**Aktueller Ablauf:** „Arbeitszeit erfassen“ erhält nur das Personalprofil. Ein neuer Eintrag startet immer mit dem heutigen Datum, 08:00–16:00 Uhr und 30 Minuten Pause – auch wenn gerade eine andere Woche betrachtet wird. Nach dem Speichern schließt sich das Formular. Für weitere Arbeitsblöcke muss die Fachkraft es erneut öffnen und den Tag wieder wählen.
+
+Freizeitausgleich und halber Urlaubstag verlangen laut Formular „Von = Bis“, zeigen aber zwei unabhängige Datumsfelder. Ein einzelner Tag muss damit zweimal angegeben werden.
+
+**Vorgeschlagener Zielablauf:** „Zeit erfassen“ am konkreten Tag mit vorausgewähltem Datum. „Speichern und weiteren Block erfassen“ behält den Tag bei. Bei Ein-Tages-Anträgen genügt ein Datum; das Ende wird daraus abgeleitet. Tatsächliche Arbeitszeiten bleiben ausdrücklich eingegebene Werte, auch bei festen Arbeitstagen.
+
+Für die erstmalige Personaleinrichtung wäre ergänzend ein geführter Abschluss für Arbeitsmodell, Urlaubskonto und Anfangssaldo hilfreich. Die getrennten Einstellungen sind für spätere Änderungen sinnvoll; die bisher vereinbarte Anlage mit anschließender Profileinrichtung ist daher kein Fehler.
+
+**Belege:** `src/app/dashboard/personal/page.tsx:287`; `src/app/dashboard/personal/forms.tsx:368`, `:375`, `:477`, `:498`, `:643`.
+
+## F10 – Ämter-Schaltflächen eindeutig einer Person zuordnen
+
+**Aktueller Ablauf:** Eine Familie mit zwei Elternkonten bekommt zwei nahezu gleich beschriftete „Ämter“-Schaltflächen. Erst nach dem Öffnen zeigt der Dialog, welches Elternteil gemeint ist. Das wurde im lokalen Browser bestätigt. Ein neues Amt anzulegen und es der gerade geöffneten Person zuzuweisen sind außerdem separate Aktionen.
+
+**Vorgeschlagener Zielablauf:** „Ämter: Vorname“ oder eine gemeinsame Familienansicht mit klar getrennten Personen. Im Personenkontext kann „Amt anlegen und zuweisen“ beide Schritte verbinden.
+
+Die festen persönlichen Ämter und die wechselnden Elterndienste sind fachlich verschiedene Dinge. Verständliche Bezeichnungen sollten diese Unterscheidung sichtbar machen.
+
+**Belege:** `src/app/dashboard/families/_components/families-list-client.tsx:292`; `src/app/dashboard/families/duty-manager.tsx:107`, `:123`; `prisma/schema.prisma` (`ParentDuty`, `DutyType`).
+
+## F11 – Zugang wiederherstellen statt außerhalb der Anwendung lösen
+
+**Aktueller Ablauf:** Im Login fehlt „Passwort vergessen“, im Profil die eigene Passwortänderung. Ein bereits verwendeter Aktivierungslink kann nach dem Löschen des Tokens eine allgemeine 404-Seite liefern. Abgelaufene Links verweisen auf den Admin; bei Familien fehlt dessen erneuter Versandweg aus F01.
+
+Ein seltener Alt-Daten-Fall führt zusätzlich auf „Datenschutz-Einwilligung erforderlich“, bietet dort aber nur einen Verweis an Admin oder Support. Die Seite hat keinen direkten Abschluss; auch die bestehenden Support-Aktionen bieten dafür keinen passenden Korrekturablauf. Der normale Registrierungs- und Einladungsablauf erfasst die Einwilligung bereits.
+
+**Vorgeschlagener Zielablauf:** Passwort-Wiederherstellung über einen zeitlich begrenzten Link; eindeutige Weiterleitung zum Login nach bereits erfolgter Aktivierung; passende Möglichkeit für einen neuen Einladungslink. Alt-Konten können eine fehlende Einwilligung innerhalb der Anwendung nachholen.
+
+**Belege:** `src/app/login/login-form.tsx`; `src/app/dashboard/profil/page.tsx`; `src/app/invite/[token]/page.tsx:39`, `:84`; `src/app/invite/[token]/actions.ts:153`; `src/app/onboarding/consent/page.tsx:46`; `src/app/admin/actions.ts`.
+
+## F12 – Fachliche Filter und Statuszahlen verlässlich anzeigen
+
+**Hoch:** Der Gruppenfilter in der Kita-Abwesenheitsübersicht ordnet Kinder über den Zeichencode des ersten Buchstabens ihres Namens „Krippe“ oder „Elementar“ zu. Das ist keine tatsächliche Gruppenzuordnung. Der Filter kann Kinder aus einer vermeintlich fachlichen Übersicht entfernen und dadurch falsche Schlüsse nahelegen.
+
+**Niedrig:** Das Menü zeigt beim Notdienst fest die Zahl „4“. Sie wird nicht aus offenen Aufgaben berechnet und verändert sich durch deren Erledigung nicht.
+
+**Vorgeschlagener Zielablauf:** Gruppenfilter erst mit einer echten gespeicherten Gruppenzuordnung anbieten; bis dahin ausblenden. Statuszahlen aus den jeweiligen offenen Aufgaben berechnen und ihre Bedeutung benennen oder weglassen.
+
+**Belege:** `src/app/dashboard/admin/abwesenheiten/_components/absences-client.tsx:69`, `:77`; `src/components/dashboard/sidebar-nav.tsx:60`.
+
+## Bereits sinnvolle Abläufe und Prüfungsabdeckung
+
+| Bereich | Ergebnis der Ablaufprüfung |
+| --- | --- |
+| Fachkraft anlegen und aktivieren | Name, Pflicht-E-Mail und Starttermin gemeinsam; Profilübergang sowie Einladungsstatus und erneutes Senden vorhanden. |
+| Familie anlegen | Eltern und Kinder gemeinsam erfassbar; hauptsächlich der Abschluss bei Mailproblemen und der erneute Versand brauchen Verbesserung (F01). |
+| Profil und Kinderverwaltung | Eigene Kinder und Kontaktdaten bearbeitbar; Ersteinrichtung und Wiederherstellung siehe F08/F11. |
+| Adressbuch | Suchen, Filtern und Kontakt öffnen am selben Ort; Freigabe im Profil ist eine nachvollziehbare gesonderte Einstellung. |
+| Kinder-Abwesenheiten | Meldung direkt vom Dashboard möglich; Verwaltung und Gruppenfilter siehe F02/F12. |
+| Arbeitszeit und Urlaub | Zeiten, Wochenfreigaben, Anträge, feste Arbeitsmodelle und Konten integriert; Eingabekontext siehe F09. |
+| Feiertage im Personalbereich | Eintrag im selben Personalbereich; nicht automatisch mit Kita-Schließtagen gleichsetzen, da Schließtage Arbeitstage sein können. |
+| Kalender und RSVP | Anmeldung pro Familie/Kind sowie Terminverwaltung vorhanden; Detailzugang und Mitbringen siehe F06. |
+| Terminanfragen und Notdiensttausch | Anfrage und Antwortaktionen vorhanden; Freigabe bzw. Zustimmung anderer Personen ist ein notwendiger fachlicher Schritt. |
+| Mitteilungen | Dashboard-Anzeige und eigenes Archiv vorhanden; Korrektur und Versandverwaltung siehe F07. |
+| Wechselnde Elterndienste | Dienstarten und Einteilung auf derselben Verwaltungsseite; fachliche Unterscheidung zu persönlichen Ämtern siehe F10. |
+| Notdienstplanung | Automatischer Vorschlag, Vorschau, manuelle Einteilung und Veröffentlichung vorhanden; F03/F05 betreffen Orientierung und Kommunikation. |
+| Notdienstalarm | Einteilung aus dem Plan vorausgewählt; Rückmeldung, Frist und Mailstatus integriert. Separater Alarmdialog ist fachlich sinnvoll. |
+| Kita-Einrichtung, Login und Superadmin | Bestehende Einrichtung, Diagnose und Support geprüft; Zugriffsrollen und Wiederherstellung siehe F04/F11. Keine produktiven Support-Aktionen ausgeführt. |
+
+„Vorhanden“ bedeutet hier, dass der Bedienweg im aktuellen Code nachvollziehbar ist. Es ist keine Zusicherung, dass jede Ausnahme oder Berechnung bereits durch diese Prüfung getestet wurde.
+
+## Empfohlene Umsetzungspakete
+
+1. **Sackgassen und falsche Anzeigen beseitigen:** Eltern-Abwesenheitslink und eigene Verwaltungsansicht (F02), erfundenen Gruppenfilter entfernen (F12), gespeicherte Familien bei Mailfehler korrekt abschließen und Einladungen erneut senden (F01).
+2. **Notdienst-Rücklauf verlässlich machen:** Einstellungen richtig benennen, unvollständige Meldungen erkennen, Monatsbezug und Versandstatus korrigieren (F03); anschließend manuelle Einteilung und Veröffentlichung vereinfachen (F05).
+3. **Personen und Zugänge verwalten:** Kita-interne Rollenverwaltung gemäß Nutzerentscheidung (F04), Passwort- und Aktivierungs-Wiederherstellung (F11).
+4. **Alltagskorrekturen direkt ermöglichen:** Einheitliche Kalenderdetails und editierbare Mitbring-Einträge (F06), bearbeitbare Mitteilungen mit eigenständigem Versandstatus (F07).
+5. **Weniger wiederholte Eingaben:** Tagesbezogene Arbeitszeitformulare und Ein-Tages-Anträge (F09), geführte Ersteinrichtung (F08), eindeutig beschriftete Ämter (F10) und echte Menü-Zahlen (F12).
+
+Vor der Umsetzung der jeweiligen Zusatzregel noch zu entscheiden: Umgang mit mehrtägigen Abwesenheiten über die Grenze „heute“ hinweg; Teilnahme von Admins/Koordination ohne eigene Kinder; automatische Verfügbarkeits-Erinnerungen samt Termin; E-Mail zur ersten Planveröffentlichung. Diese Punkte verhindern nicht die bereits eindeutig beschriebenen Korrekturen.
+
+## Verifikation und nächster Arbeitsstand
+
+Die Quellcodebefunde wurden gegen den genannten Commit geprüft. Im lokalen Browser bestätigt wurden insbesondere der nicht nutzbare Eltern-Abwesenheitslink, die fehlenden Einladungsaktionen in Familien-Details, gleich benannte Ämter-Schaltflächen sowie unterschiedliche Detailzugänge im Kalender.
+
+Dieses Dokument liegt auf der eigenen Arbeitsbranch `codex/flow-audit`. Für die Dokumentation wurden keine Anwendungstests oder ein neuer Build benötigt. Bei der Umsetzung gehören gezielte Tests der Datums-/Rollenregeln und der Mailfehlerfälle zu den jeweiligen Paketen.

docs/FAMILIEN_UND_ABWESENHEITEN.md

@@ -0,0 +1,68 @@
+# Familieneinladungen und Abwesenheitsverwaltung
+
+Stand: 9. Oktober 2026. Umsetzung der Befunde F01 und F02 aus der [Ablaufprüfung](ABLAUFPRUEFUNG.md), einschließlich Entfernung des künstlichen Gruppenfilters aus F12.
+
+## Familieneinladungen
+
+- Die Familienanlage erfasst weiterhin Eltern und Kinder gemeinsam. Die Familie, Konten, Aktivierungslinks und Versandaufträge werden gemeinsam gespeichert.
+- Scheitert danach der Mailversand, bleibt die Familienanlage erfolgreich. Das Formular schließt, die Liste aktualisiert sich und eine Warnung weist auf den erneuten Versand hin. Auch die Ergänzung eines Elternteils in einer bestehenden Familie folgt diesem Ablauf.
+- Jeder Empfänger wird bearbeitet, auch wenn eine andere Einladung fehlschlägt.
+- Tabelle, Kartenansicht und Familien-Details zeigen den Status je Elternkonto: aktiviert, Aktivierung offen, Versand läuft, versendet, fehlgeschlagen oder abgelaufen. Soweit vorhanden, wird das Ablaufdatum angezeigt.
+- Kita-Admins können die Einladung innerhalb ihrer Kita beim jeweiligen Elternteil erneut senden. Aktivierte Konten werden nicht erneut eingeladen. Parallel ausgelöste Versandversuche werden gegen doppelte Bearbeitung geschützt.
+- Ein noch gültiger, fehlgeschlagener Versand wird mit demselben Link wiederholt. Bei abgelaufenem oder zuvor erfolgreich versendetem Link wird ein neuer Link für sieben Tage erstellt; ältere Aktivierungslinks des Kontos werden ersetzt. Direkt nach einem erfolgreichen Versand gilt eine Minute Abstand bis zum erneuten Versand.
+- Wird die Adresse eines noch nicht aktivierten Kontos korrigiert, versendet das Speichern automatisch eine neue Einladung an diese Adresse. Solange die Adressänderung ungespeichert ist, ist der separate erneute Versand gesperrt.
+- Bereits bestehende Elternkonten und Aktivierungslinks bleiben gültig. Alte Konten ohne gespeicherten Versandstatus erscheinen als „Aktivierung offen“; beim erneuten Senden wird der Status ergänzt. Das Löschen und Neuanlegen einer Familie ist dafür nicht nötig.
+- Nach der Aktivierung wird der Einladungsstatus abgeschlossen. „Versendet“ bedeutet, dass der Mailtransport die Nachricht angenommen hat; eine tatsächliche Zustellung oder ein späterer Bounce wird hier nicht überwacht.
+
+Bei Eingabefehlern bleiben die Formulardaten erhalten. Nach einem erfolgreichen Vorgang öffnet sich das Formular wieder mit einem frischen Zustand. Die Kinder-Schaltfläche entfernt das tatsächlich gewählte Kind aus dem Entwurf.
+
+## Kinder-Abwesenheiten
+
+„Meine Abwesenheiten“ ist über das Menü und die Dashboard-Karte erreichbar. Die Seite zeigt ausschließlich Meldungen des eigenen Haushalts, getrennt nach aktuellen/zukünftigen und vergangenen Meldungen, mit jeweils bis zu 20 Meldungen pro Seite.
+
+| Rolle | Neue Meldung | Ändern oder zurücknehmen |
+| --- | --- | --- |
+| Eltern | Eigene aktive Kinder, ab heute | Eigene Meldungen, deren Beginn nach heute liegt; auch der neue Beginn muss zukünftig bleiben. |
+| Kita-Admin, Notdienst-Koordination, Fachkraft | Der bestehende Dashboard-Meldeweg betrifft den eigenen Haushalt. | Vorhandene Meldungen innerhalb der eigenen Kita, einschließlich laufender Meldungen, in der Kita-Tagesübersicht korrigieren oder zurücknehmen. |
+
+Die vom Nutzer bestätigte Mehrtagesregel gilt für die gesamte Meldung: **Sobald sie begonnen hat, übernimmt die Kita auch die noch zukünftigen Tage.** Eltern können die zukünftige Hälfte einer laufenden Meldung nicht eigenständig abtrennen.
+
+Die Bearbeitung zeigt Zeitraum, Grund und Bemerkung in einem Dialog. Bei Verschieben des Beginns hinter das bisherige Ende wird das Ende angepasst. Eine Rücknahme erhält einen eigenen Bestätigungsdialog. Laufende Meldungen zeigen Eltern einen verständlichen Hinweis auf die Kita.
+
+Die Regeln gelten auch serverseitig:
+
+- Aktuelle Rollen und Haushaltszugehörigkeit werden vor Schreibzugriffen aus der Datenbank geprüft.
+- Kalendertage werden unabhängig von der Server-Zeitzone als UTC-Datum gespeichert; die Grenze „heute“ folgt `Europe/Berlin`.
+- Ungültige Tage, umgekehrte Zeiträume und Überschneidungen werden abgewiesen. Gleichzeitige Meldungen für dasselbe Kind werden serialisiert.
+- Ein veralteter Bearbeitungsstand überschreibt keine zwischenzeitliche Änderung. Die Oberfläche bietet bei diesem Konflikt das Aktualisieren der Ansicht an.
+- Erfolgreiche Änderungen aktualisieren Dashboard, eigene Verwaltung und Kita-Tagesübersicht.
+
+Der bisherige Gruppenfilter „Krippe/Elementar“ wurde entfernt, weil keine tatsächliche Gruppenzuordnung hinterlegt ist. Ein fachlicher Gruppenfilter bleibt ein eigener späterer Ausbau.
+
+## Deployment und Betrieb
+
+Das Prisma-Modell `Invitation` erhält einen optionalen Bezug zum Elternkonto sowie Versandzeit, Versuchszähler, Fehlerstatus und eine zeitlich begrenzte Versandsperre. Vorhandene Datensätze müssen nicht neu angelegt werden.
+
+Der vorgeschaltete Compose-Dienst `migrate` führt `prisma migrate deploy` und die eingeschränkten Runtime-Grants aus. Die versionierte Migration `20261010000000_family_invitation_flows` ergänzt die Felder und prüft die Mandantenzuordnung des Empfängers. Der App-Start benötigt keine Schema- oder Administrationsrechte. **Es sind keine neuen Umgebungsvariablen nötig.** Resend-Absender, API-Schlüssel und App-Adresse werden wie bisher verwendet.
+
+Bei einem eigenen Startablauf die versionierten Migrationen und Runtime-Grants vor dem neuen App-Code ausführen; siehe die zentrale Deployment-Anleitung. Kein `prisma db push` und kein historisches SQL-Upgrade zusätzlich zu den Migrationen verwenden.
+
+Die normalen Sicherungs- und Schema-Prüfschritte gelten weiterhin; siehe [Deployment und Mailversand](../deploy/DEPLOYMENT_UND_MAILVERSAND.md). Für Familieneinladungen ist kein zusätzlicher Cronjob erforderlich. Fehlgeschlagene oder unterbrochene Versandversuche werden gezielt durch Kita-Admins wiederholt.
+
+## Prüfung
+
+- Unit-Tests für echte Kalendertage, Berliner Mitternachts-/Zeitumstellungsgrenzen und Einladungszustände.
+- PostgreSQL-Integrationstests mit simuliertem Mailtransport: Speicherung trotz Mailfehler, zweiter Empfänger, gezieltes erneutes Senden, Ablauf/Erneuerung, Alt-Konten, paralleler Versand, Aktivierungsabschluss, Adresskorrektur und Berechtigungen.
+- PostgreSQL-Integrationstests für Eltern- und Kita-Korrekturen, begonnene Mehrtagesmeldungen, fremde Haushalte/Kitas, Überschneidungen, konkurrierende Erstellung und veraltete Bearbeitungsstände.
+- Wiederholbarkeit des SQL-Upgrades auf leerem und bestehendem Testschema mit Erhalt vorhandener Tokens.
+- Lokale Browserprüfung mit deaktiviertem echtem Mailversand: Anlage und Bearbeitung schließen trotz Versandwarnung; Formulare behalten Fehler-Eingaben und lassen sich erneut öffnen; zukünftige Elternmeldung und laufende Kita-Meldung werden erfolgreich korrigiert.
+- TypeScript, ESLint und Produktionsbuild.
+
+Testbefehle:
+
+```sh
+npm run test:family-absence
+TEST_DATABASE_URL='postgresql://USER@127.0.0.1:PORT/TEST_DATABASE' npm run test:family-absence:integration
+```
+
+Integrationstests akzeptieren nur eine ausdrücklich benannte lokale Testdatenbank. Die Browserprüfung nutzt ausschließlich synthetische Daten und verschickt keine echten E-Mails.

docs/FUNKTIONSUEBERSICHT.md

@@ -1,5 +1,44 @@
 # Kita-Planer – Funktionsübersicht und aktueller Stand
 
+## Ergänzung vom 12.10.2026: Notdienst-Benachrichtigungen
+
+- Automatische Erinnerungen erfassen auch unvollständige Verfügbarkeiten. Das Soll wird aus allen aktiven Kindern und die Istzahl aus unterschiedlichen gültigen Tagen berechnet. Admin-/Koordinationskonten mit eigenem Haushalt gehören zur Eltern-Empfängergruppe.
+- Die Erinnerungsfrist bezieht sich jetzt ausdrücklich auf den 26. als Ende der Eintragsfrist. Standard: sieben Tage vorher ab 9 Uhr Berliner Zeit; 0 deaktiviert die automatische Runde. Verpasste Läufe werden innerhalb der noch offenen Frist nachgeholt. Jede Kita/Folgemonat erhält eine automatische Runde; manuelle Erinnerungen sind je Konto/Tag dedupliziert.
+- Beim ersten Veröffentlichen werden Mailaufträge in derselben Transaktion gespeichert. Pro erreichbarem Konto wird eine gemeinsame Nachricht mit den aktuellen eigenen Diensten erzeugt. Mehrfaches Veröffentlichen erzeugt keine zweite Runde. Mailfehler ändern den veröffentlichten Status nicht.
+- Die Monatsplanung zeigt Versandzahlen und Einzelstatus sowie eine manuelle Wiederholung offener/fehlgeschlagener Nachrichten. Bereits versendete oder inzwischen überholte Aufträge werden dabei nicht neu verschickt.
+- Der bestehende geschützte Notdienstjob verarbeitet die Nachrichten automatisch. Gespeicherte Reservierungen, Idempotenzschlüssel, zunehmende Wiederholungsabstände und erneute Berechtigungs-/Einteilungsprüfung sichern die Verarbeitung. Der Produktionsstart startet einen abgebrochenen Worker erneut.
+- Additive Migration: `20261012000000_notdienst_notifications`. Sie erhält die bisherigen Constraints und ergänzt drei weitere Tenant-Fremdschlüssel. Einrichtung und Grenzen stehen in [deploy/README.md](../deploy/README.md).
+
+Prüfbefehle: `npm run test:mail`, `npm run test:runtime`, `npm run test:notdienst` und `TEST_DATABASE_URL=postgresql://USER:PASSWORD@127.0.0.1:PORT/kita_notifications_test npm run test:notdienst:notifications` nach Anwendung der Migrationen auf dieser separaten Testdatenbank. Die Versandtests verwenden ersetzte Transporte; reale Eltern werden nicht angeschrieben.
+
+Abnahme: 33 neue Versand-Integrationstests, vier Tests des tatsächlichen SDK-Transports, zwei Supervisor-Tests, sechs Datums-/Fristtests sowie 106 bestehende Sicherheits-, Planungs-, Kalender- und Elternablauftests erfolgreich (151 insgesamt, keine übersprungenen Tests). Browserprüfung mit lokalem Mailserver: automatische Erinnerung einmalig, Veröffentlichung trotz simuliertem Versandfehler, sichtbare Einzelstatus, erfolgreiche Wiederholung und mobile Anzeige. TypeScript und Produktionsbuild erfolgreich; ESLint ohne Fehler mit acht bestehenden Warnungen.
+Zusätzliche Upgrade-Prüfung gegen das vorige Schema: vorhandene Familien, Konten, Kinder, veröffentlichter Plan und Einteilung unverändert erhalten; keine nachträglichen Veröffentlichungsmails angelegt. Die Zahl der ergänzenden Tenant-Fremdschlüssel steigt von 41 auf 44.
+
+## Ergänzung vom 12.10.2026: Kalender und kleine Bedienungsverbesserungen
+
+- Eigene Mitbringbeiträge lassen sich direkt mit Speichern/Abbrechen bearbeiten. Enter speichert; Escape schließt den Termindialog und verwirft den Entwurf. Eingaben werden auf 1 bis 500 Zeichen begrenzt; fremde Beiträge können auch von Admin/Koordination nicht umgeschrieben werden. Ein bestätigter Termin mit aktiver Mitbringliste und die Kita-/Autorzuordnung werden serverseitig geprüft.
+- Eltern mit Admin- oder Koordinationsrolle können für den eigenen Haushalt Dienste tauschen. Kalenderknöpfe und offene eingehende/ausgehende Anfragen stehen ihnen ebenfalls zur Verfügung. Tauschmails berücksichtigen verifizierte, aktive Elternkonten aller drei Rollen im jeweils beteiligten Haushalt. Konten ohne eigenen Haushalt erhalten dadurch kein Tauschrecht; fremde Angebote und aktive Alarme bleiben gesperrt.
+- Die fest eingetragene „4“ am Menüpunkt Notdienst wurde entfernt.
+- Kein Schema-Upgrade erforderlich. Automatische Erinnerungen und Veröffentlichungsmails bleiben die nächste Etappe.
+
+Prüfbefehl für die neuen Abläufe: `TEST_DATABASE_URL=postgresql://USER:PASSWORD@127.0.0.1:PORT/kita_quickwins_test npm run test:calendar:integration`. Er verlangt eine ausdrücklich benannte lokale Testdatenbank mit den vorhandenen Migrationen. Die 26 Fälle prüfen echte Server Actions und PostgreSQL; Mailtransport und Anmeldesession werden isoliert ersetzt. Die bestehenden Elternabläufe wurden ebenfalls mit 9 Integrationstests und 9 Berechnungstests geprüft.
+
+Im Browser geprüft: eigener Beitrag speichern und abbrechen, Anzeige bei 390 Pixeln, fehlender Bearbeiten-Knopf bei fremden Beiträgen, Navigation ohne festen Zähler, Admin-Tauschanfrage mit eigenem Angebot sowie Anzeige und Annahme durch Koordination. E-Mails wurden dabei ausschließlich im Entwicklungsmodus simuliert.
+
+Abnahme dieser Etappe: 26 neue Integrationstests, 18 bestehende Elternablauftests und 28 Sicherheitstests erfolgreich (72 insgesamt, keine übersprungenen Tests). TypeScript und Produktionsbuild erfolgreich; projektweites ESLint ohne Fehler mit acht bestehenden Warnungen.
+
+## Ergänzung vom 12.10.2026: Verlässliche Notdienst-Planungsregeln
+
+- Das Verfügbarkeitssoll wird aus allen aktiven Kindern des angemeldeten Haushalts berechnet. Ausgelassene, doppelte, fremde oder inaktive Kinder werden zurückgewiesen; doppelte Datumsangaben zählen nur einmal.
+- Oberfläche, Speicherung, Generierung und manuelle Zuweisung verwenden gemeinsame Regeln: nur Werktage des Planungsmonats, ohne bestätigte Schließtage und Teamtage. Mehrtägige Termine schließen beide Randtage ein; Kalenderzeiten werden in `Europe/Berlin` ausgewertet. Ausstehende/abgelehnte Termine und Termine anderer Kitas blockieren nichts.
+- Alte ungültige Verfügbarkeiten werden nicht für neue Pläne verwendet. Vor der Veröffentlichung werden Entwürfe auf zulässige Tage und aktive Kinder geprüft. Ungültige vorhandene Einteilungen bleiben sichtbar und können über „Manuell zuweisen“ entfernt werden; aktive Alarme und vergangene veröffentlichte Dienste behalten ihre Bearbeitungssperre.
+- Kindlöschung im Elternprofil und in der Familienverwaltung ist bei heutigen/zukünftigen veröffentlichten Notdiensten oder aktiven Alarmen gesperrt. Zuerst muss die Koordination die Einteilung klären. Prüfung und Löschung laufen in derselben serialisierbaren Transaktion mit einer Sperre der betroffenen Kinder.
+- Kein Schema-Upgrade erforderlich. Automatische Erinnerungen und Benachrichtigungen bei Erstveröffentlichung sind weiterhin offen.
+
+Prüfbefehle: `npm run test:notdienst` (Datumsregeln) und `TEST_DATABASE_URL=postgresql://USER:PASSWORD@127.0.0.1:PORT/kita_notdienst_test npm run test:notdienst:integration` (echte Server Actions und PostgreSQL). Der Integrationsbefehl verlangt ausdrücklich eine separate lokale Testdatenbank; fehlende Konfiguration führt zu einem Fehler. Zuvor die vorhandenen Migrationen auf dieser Testdatenbank anwenden.
+
+Abnahme: 4 Datumstests, 34 PostgreSQL-Regressionstests und 28 bestehende Sicherheitstests erfolgreich. Im Browser geprüft: gesperrter Teamtag/Wochenende, Speicherung des vollständigen Haushaltssolls, Veröffentlichungssperre, Entfernen einer alten ungültigen Einteilung und gültige manuelle Zuweisung mit anschließender Veröffentlichung. TypeScript und Produktionsbuild erfolgreich; projektweites ESLint ohne Fehler mit acht bestehenden Warnungen.
+
 ## Ergänzung vom 09.10.2026: Notdienstalarm
 
 Der Notdienstalarm ist inzwischen umgesetzt. Admins und Koordination alarmieren die eingeteilte Familie für einen ganzen Tag oder ein Zeitfenster. Persönliche Rückmeldelinks erzeugen eine gemeinsame Haushaltsantwort; Dashboard-Hinweise, eine 30-Minuten-Frist, Klärungsbedarf, verspätete Freigabe, telefonische Korrektur, Stornierung, Versandstatus und Hintergrundprüfung sind angebunden. Aktive Alarme sperren Planumzuordnung und Diensttausche. Siehe [NOTDIENSTALARM.md](NOTDIENSTALARM.md) für Bedienung und benötigte Hosting-Konfiguration.

docs/NOTDIENSTALARM.md

@@ -47,7 +47,7 @@ HTTP 401 bedeutet fehlende/falsche Berechtigung, 503 fehlendes/zu kurzes Job-Sec
 
 Das Schema ergänzt einen gemeinsamen Alarmvorgang, einzelne Empfänger und Tokens, Hinweise, Mailaufträge und einen Verlauf. Die bisherigen `NotdienstAlert`-Datensätze bleiben erhalten. Ein aktiver Alarm reserviert seine Einteilung eindeutig; Transaktionen schützen konkurrierende Antworten und Planänderungen.
 
-Der bestehende Docker-Start nutzt `prisma db push --skip-generate`. Für kontrollierte SQL-Upgrades liegt alternativ [deploy/sql/notdienstalarm.sql](../deploy/sql/notdienstalarm.sql) vor. Es setzt den vollständigen Personalbereich einschließlich seiner Mail-Erweiterung voraus, ist einmalig auszuführen und enthält keine Datenlöschung. Nicht zusätzlich ausführen, wenn `db push` diese Änderungen bereits angewandt hat. Datenbanksicherung und Prüfung des Ausgangsschemas gehören zum Deployment. Die Auswahl der SQL-Alternativen erklärt die [zentrale Deployment- und Mailanleitung](../deploy/DEPLOYMENT_UND_MAILVERSAND.md).
+Aktuelle Releases verwenden versionierte Prisma-Migrationen über den separaten Initialisierungsdienst. Die Einrichtung beschreibt [deploy/README.md](../deploy/README.md); `prisma db push` und die historischen SQL-Upgrades sind kein aktueller Betriebsweg. Der bestehende Hintergrundjob übernimmt zusätzlich Verfügbarkeitserinnerungen und gespeicherte Veröffentlichungsmails.
 
 Bisherige Einzelalarme werden beim Verwaltungsaufruf, Joblauf oder Aufruf eines alten Links in Gruppen pro Einteilung übernommen. Alte gültige Tokens bleiben nutzbar; Originalantworten bleiben gespeichert. Nur vollständig übereinstimmende gültige Antworten ergeben eine sichere gemeinsame Zusage. Widersprüche, fehlende/ungeklärte Empfänger oder doppelte Einzelalarme führen zu Klärungsbedarf. Bei doppelten Datensätzen eines Elternkontos wird ein Rückmeldetoken übernommen; die übrigen Originaldatensätze bleiben erhalten. Die Übernahme verschickt keine erneute Alarmanfrage.
 

docs/PERSONALBEREICH.md

@@ -60,12 +60,9 @@ Parallele Änderungen laufen in serialisierbaren Datenbanktransaktionen mit Wied
 
 ## Einführung und Schema
 
-Das Projekt verwendet weiterhin seinen vorhandenen Ablauf mit `prisma db push`. Es gibt keine vollständige versionierte Prisma-Migrationshistorie. Die neuen Tabellen sind additiv; vorhandene Personen erhalten noch kein automatisch befülltes Beschäftigungsprofil.
+Aktuelle Releases verwenden die versionierten Migrationen in `prisma/migrations` und einen separaten Initialisierungsdienst vor dem App-Start. Die [zentrale Betriebsanleitung](../deploy/README.md) beschreibt Installation, Updates, Baseline für bestehende Datenbanken und Runtime-Grants. `scripts/start-production.sh` startet die Anwendung; es verändert das Schema nicht. Kein `prisma db push` auf verwalteten Datenbanken verwenden.
 
-- Lokal: Abhängigkeiten installieren, Prisma-Client generieren, Schema gegen eine dafür vorgesehene Datenbank anwenden, App starten und Profile einrichten.
-- Im vorhandenen Docker-Ablauf erzeugt `npm run build:prod` den Client; `scripts/start-production.sh` wendet das Schema vor App-Start an.
-- [Prüfbares SQL](../deploy/sql/personalbereich.sql) beschreibt dieselbe additive Änderung gegen den dokumentierten Ausgangsstand. Es ist einmalig und nicht idempotent. Entweder den vorhandenen Schemaabgleich **oder** dieses SQL verwenden; das SQL nicht nach bereits erfolgtem Schemaabgleich erneut ausführen.
-- Ist der Personalbereich bereits auf Stand `043fed2` eingeführt, beschreibt [Personalbereich-E-Mail-SQL](../deploy/sql/personalbereich-email.sql) ausschließlich die zusätzlichen Mail-Tabellen und die Profileinstellung. Auch dieses Skript ist eine einmalige Alternative zum Schemaabgleich.
+Die historischen SQL-Dateien [Personalbereich](../deploy/sql/personalbereich.sql) und [Personalbereich-E-Mails](../deploy/sql/personalbereich-email.sql) dokumentieren ihre damaligen Ausgangsstände. Sie sind kein aktueller Deployment-Schritt und dürfen nicht zusätzlich zu den versionierten Migrationen ausgeführt werden. Vorhandene Personen erhalten weiterhin erst durch Einrichtung ein Beschäftigungsprofil.
 
 Die reale Projekt- und Produktionsdatenbank wurde bei dieser Umsetzung nicht verändert. Alle DB- und Browserprüfungen liefen mit synthetischen Daten in einer separaten lokalen PostgreSQL-Datenbank.
 

docs/elternablaeufe.md

@@ -12,16 +12,9 @@
 
 ## Bestehende Daten und Schemaaktualisierung
 
-Das Projekt verwendet weiterhin `prisma db push`; es besitzt keine Prisma-Migrationshistorie. Der vorhandene Produktionsstart aktualisiert das Schema automatisch. Die neuen Pflichtfelder haben kompatible Defaults: bisherige Termine bleiben `CHILD`, bisherige Meldungen erhalten `ALLE`. Bestehende Kinderantworten werden nicht verändert.
+Aktuelle Releases verwenden die versionierten Migrationen in `prisma/migrations`. Der separate Initialisierungsdienst wendet sie vor dem App-Start an und stellt die Runtime-Grants bereit. Einrichtung und Updates beschreibt [deploy/README.md](../deploy/README.md). Kein `prisma db push` auf verwalteten Datenbanken einsetzen: zusätzliche Tenant-Constraints ergänzen das Prisma-Modell.
 
-Für eine kontrollierte, einmalige Aktualisierung einer Datenbank mit dem bisherigen Schema liegt zusätzlich die additive SQL-Datei `prisma/updates/20261007_parent_flows.sql` vor. Sie ist eine Alternative zum ersten `db push`, kein nachträglich anzuwendender zweiter Schritt. Beispiel:
-
-```sh
-psql "$DATABASE_URL" -v ON_ERROR_STOP=1 --single-transaction -f prisma/updates/20261007_parent_flows.sql
-npm run prisma:generate
-```
-
-Die Datei gehört bewusst nicht in `prisma/migrations`: Eine Einführung von `prisma migrate deploy` würde zuerst eine Baseline für bereits existierende Datenbanken verlangen.
+`prisma/updates/20261007_parent_flows.sql` dokumentiert den historischen Ausgangsstand vor Einführung der Migrationshistorie. Es gehört nicht zum aktuellen Deployment und darf nicht zusätzlich zu bereits angewandten Migrationen ausgeführt werden. Die kompatiblen Defaults für bisherige Termine (`CHILD`) und Meldungen (`ALLE`) sind in den versionierten Migrationen enthalten.
 
 ## Verifikation
 

package.json

@@ -24,7 +24,15 @@
     "test:staff:integration": "tsx --test tests/staff-service.test.ts",
     "test:alarms": "tsx --experimental-test-module-mocks --test tests/notdienst-alarm.test.ts",
     "test:parent-flows": "tsx --test tests/parent-flows.test.ts",
-    "test:parent-flows:integration": "tsx --experimental-test-module-mocks --test tests/parent-flows.integration.test.ts"
+    "test:parent-flows:integration": "tsx --experimental-test-module-mocks --test tests/parent-flows.integration.test.ts",
+    "test:notdienst": "tsx --test tests/notdienst-days.test.ts",
+    "test:notdienst:integration": "node --test tests/notdienst-planning.integration.test.cjs",
+    "test:calendar:integration": "node --test tests/calendar-actions.integration.test.cjs",
+    "test:notdienst:notifications": "node --test tests/notdienst-notifications.integration.test.cjs",
+    "test:mail": "node --test tests/mail-transport.test.cjs",
+    "test:runtime": "node --test tests/runtime-supervisor.test.cjs",
+    "test:family-absence": "tsx --test tests/absence-policy.test.ts",
+    "test:family-absence:integration": "tsx --experimental-test-module-mocks --test tests/family-absence-flows.integration.test.ts"
   },
   "prisma": {
     "seed": "tsx prisma/seed.ts"

prisma/migrations/20261010000000_family_invitation_flows/migration.sql

@@ -0,0 +1,13 @@
+-- Family invitation delivery status; applied before the restricted runtime starts.
+ALTER TABLE "invitations"
+  ADD COLUMN "userId" TEXT,
+  ADD COLUMN "sentAt" TIMESTAMP(3),
+  ADD COLUMN "lastAttemptAt" TIMESTAMP(3),
+  ADD COLUMN "leaseUntil" TIMESTAMP(3),
+  ADD COLUMN "attempts" INTEGER NOT NULL DEFAULT 0,
+  ADD COLUMN "failed" BOOLEAN NOT NULL DEFAULT false;
+CREATE UNIQUE INDEX "invitations_userId_key" ON "invitations"("userId");
+ALTER TABLE "invitations" ADD CONSTRAINT "invitations_userId_fkey"
+  FOREIGN KEY ("userId") REFERENCES "users"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+ALTER TABLE "invitations" ADD CONSTRAINT "invitations_userId_tenant_fkey"
+  FOREIGN KEY ("userId", "kitaId") REFERENCES "users"("id", "kitaId") ON DELETE CASCADE ON UPDATE NO ACTION;

prisma/migrations/20261012000000_notdienst_notifications/migration.sql

@@ -0,0 +1,47 @@
+BEGIN;
+CREATE TABLE "notdienst_emails" (
+  "id" TEXT NOT NULL,
+  "kitaId" TEXT NOT NULL,
+  "familyId" TEXT NOT NULL,
+  "userId" TEXT NOT NULL,
+  "planId" TEXT,
+  "year" INTEGER NOT NULL,
+  "month" INTEGER NOT NULL,
+  "kind" TEXT NOT NULL,
+  "eventKey" TEXT NOT NULL,
+  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  "sentAt" TIMESTAMP(3),
+  "skippedAt" TIMESTAMP(3),
+  "leaseUntil" TIMESTAMP(3),
+  "claimToken" TEXT,
+  "nextAttemptAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  "failed" BOOLEAN NOT NULL DEFAULT false,
+  "attempts" INTEGER NOT NULL DEFAULT 0,
+  "lastError" TEXT,
+  CONSTRAINT "notdienst_emails_pkey" PRIMARY KEY ("id"),
+  CONSTRAINT "notdienst_emails_month_check" CHECK ("month" BETWEEN 1 AND 12),
+  CONSTRAINT "notdienst_emails_kind_check" CHECK ("kind" IN ('REMINDER','PUBLICATION')),
+  CONSTRAINT "notdienst_emails_plan_check" CHECK (("kind" = 'PUBLICATION' AND "planId" IS NOT NULL) OR ("kind" = 'REMINDER' AND "planId" IS NULL))
+);
+CREATE UNIQUE INDEX "notdienst_emails_kitaId_userId_kind_year_month_eventKey_key" ON "notdienst_emails"("kitaId","userId","kind","year","month","eventKey");
+CREATE INDEX "notdienst_emails_sentAt_skippedAt_nextAttemptAt_idx" ON "notdienst_emails"("sentAt","skippedAt","nextAttemptAt");
+CREATE INDEX "notdienst_emails_kitaId_year_month_idx" ON "notdienst_emails"("kitaId","year","month");
+ALTER TABLE "notdienst_emails" ADD CONSTRAINT "notdienst_emails_kitaId_fkey" FOREIGN KEY ("kitaId") REFERENCES "kitas"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+ALTER TABLE "notdienst_emails" ADD CONSTRAINT "notdienst_emails_familyId_fkey" FOREIGN KEY ("familyId") REFERENCES "families"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+ALTER TABLE "notdienst_emails" ADD CONSTRAINT "notdienst_emails_userId_fkey" FOREIGN KEY ("userId") REFERENCES "users"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+ALTER TABLE "notdienst_emails" ADD CONSTRAINT "notdienst_emails_planId_fkey" FOREIGN KEY ("planId") REFERENCES "notdienst_plans"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+ALTER TABLE "notdienst_emails" ADD CONSTRAINT "notdienst_emails_familyId_tenant_fkey" FOREIGN KEY ("familyId","kitaId") REFERENCES "families"("id","kitaId") ON DELETE NO ACTION ON UPDATE NO ACTION;
+ALTER TABLE "notdienst_emails" ADD CONSTRAINT "notdienst_emails_userId_tenant_fkey" FOREIGN KEY ("userId","kitaId") REFERENCES "users"("id","kitaId") ON DELETE NO ACTION ON UPDATE NO ACTION;
+ALTER TABLE "notdienst_emails" ADD CONSTRAINT "notdienst_emails_planId_tenant_fkey" FOREIGN KEY ("planId","kitaId") REFERENCES "notdienst_plans"("id","kitaId") ON DELETE NO ACTION ON UPDATE NO ACTION;
+CREATE TABLE "notdienst_reminder_runs" (
+  "id" TEXT NOT NULL,
+  "kitaId" TEXT NOT NULL,
+  "year" INTEGER NOT NULL,
+  "month" INTEGER NOT NULL,
+  "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  CONSTRAINT "notdienst_reminder_runs_pkey" PRIMARY KEY ("id"),
+  CONSTRAINT "notdienst_reminder_runs_month_check" CHECK ("month" BETWEEN 1 AND 12)
+);
+CREATE UNIQUE INDEX "notdienst_reminder_runs_kitaId_year_month_key" ON "notdienst_reminder_runs"("kitaId","year","month");
+ALTER TABLE "notdienst_reminder_runs" ADD CONSTRAINT "notdienst_reminder_runs_kitaId_fkey" FOREIGN KEY ("kitaId") REFERENCES "kitas"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+COMMIT;

prisma/schema.prisma

@@ -159,6 +159,8 @@ model Kita {
   termine                 Termin[]
   mitbringselItems        MitbringselItem[]
   eventParticipations     EventParticipation[]
+  notdienstEmails        NotdienstEmail[]
+  notdienstReminderRuns  NotdienstReminderRun[]
   notdienstPlans         NotdienstPlan[]
   notdienstAvailabilities NotdienstAvailability[]
   notdienstAssignments    NotdienstAssignment[]
@@ -184,6 +186,7 @@ model Family {
 
   name            String
   notdienstAlarms NotdienstAlarm[]
+  notdienstEmails NotdienstEmail[]
 
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
@@ -268,6 +271,7 @@ model User {
 
   mitbringselItems   MitbringselItem[]
   invitationsCreated Invitation[]                 @relation("InvitationCreator")
+  familyInvitation   Invitation?                  @relation("InvitationRecipient")
   auditLogsAuthored  AuditLog[]                   @relation("AuditLogActor")
   staffProfile       StaffProfile?
   staffNotifications StaffNotification[]
@@ -275,6 +279,7 @@ model User {
   alarmRecipients    NotdienstAlarmRecipient[]
   alarmNotifications NotdienstAlarmNotification[]
   alarmEmails        NotdienstAlarmEmail[]
+  notdienstEmails   NotdienstEmail[]
 
   @@index([kitaId])
   @@index([familyId])
@@ -749,10 +754,19 @@ model Invitation {
   email String
   role  UserRole @default(ELTERN)
 
+  // Nullable for older, unlinked invitations. Family invitations belong to a user.
+  userId String? @unique
+  user   User?   @relation("InvitationRecipient", fields: [userId], references: [id], onDelete: Cascade)
+
   token      String           @unique
   status     InvitationStatus @default(PENDING)
   expiresAt  DateTime
   acceptedAt DateTime?
+  sentAt        DateTime?
+  lastAttemptAt DateTime?
+  leaseUntil    DateTime?
+  attempts      Int       @default(0)
+  failed        Boolean   @default(false)
 
   invitedById String?
   invitedBy   User?   @relation("InvitationCreator", fields: [invitedById], references: [id], onDelete: SetNull)
@@ -902,6 +916,7 @@ model NotdienstPlan {
   updatedAt DateTime @updatedAt
 
   assignments NotdienstAssignment[]
+  emails      NotdienstEmail[]
 
   @@unique([kitaId, year, month])
   @@index([kitaId])
@@ -1208,3 +1223,46 @@ model PendingRegistration {
   @@index([expiresAt])
   @@map("pending_registrations")
 }
+
+/// Durable notification jobs. No bearer tokens or personal response links.
+model NotdienstEmail {
+  id            String   @id @default(cuid())
+  kitaId        String
+  kita          Kita     @relation(fields: [kitaId], references: [id], onDelete: Cascade)
+  familyId      String
+  family        Family   @relation(fields: [familyId], references: [id], onDelete: Cascade)
+  userId        String
+  user          User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  planId        String?
+  plan          NotdienstPlan? @relation(fields: [planId], references: [id], onDelete: Cascade)
+  year          Int
+  month         Int
+  kind          String
+  eventKey      String
+  createdAt     DateTime @default(now())
+  sentAt        DateTime?
+  skippedAt     DateTime?
+  leaseUntil    DateTime?
+  claimToken    String?
+  nextAttemptAt DateTime @default(now())
+  failed        Boolean  @default(false)
+  attempts      Int      @default(0)
+  lastError     String?
+
+  @@unique([kitaId, userId, kind, year, month, eventKey])
+  @@index([sentAt, skippedAt, nextAttemptAt])
+  @@index([kitaId, year, month])
+  @@map("notdienst_emails")
+}
+
+model NotdienstReminderRun {
+  id        String   @id @default(cuid())
+  kitaId    String
+  kita      Kita     @relation(fields: [kitaId], references: [id], onDelete: Cascade)
+  year      Int
+  month     Int
+  createdAt DateTime @default(now())
+
+  @@unique([kitaId, year, month])
+  @@map("notdienst_reminder_runs")
+}

prisma/updates/20261007_parent_flows.sql

@@ -1,3 +1,5 @@
+-- HISTORISCHER UPGRADEPFAD: aktuelle Releases verwenden prisma/migrations und deploy/README.md.
+-- Nicht zusätzlich zu versionierten Migrationen oder auf bereits aktualisierten Datenbanken ausführen.
 -- CreateEnum
 CREATE TYPE "RsvpMode" AS ENUM ('CHILD', 'FAMILY');
 

scripts/check-tenant-integrity.sql

@@ -59,4 +59,11 @@ UNION ALL
 SELECT 'notdienst_alerts.educatorId' AS relation, count(*) AS invalid_rows FROM "notdienst_alerts" c JOIN "educators" p ON c."educatorId" = p.id WHERE c."kitaId" IS DISTINCT FROM p."kitaId"
 UNION ALL
 SELECT 'announcement_reads.userId' AS relation, count(*) AS invalid_rows FROM announcement_reads r JOIN announcements a ON r."announcementId" = a.id JOIN users u ON r."userId" = u.id WHERE u."kitaId" IS DISTINCT FROM a."kitaId"
+
+UNION ALL
+SELECT 'notdienst_emails.familyId' AS relation, count(*) AS invalid_rows FROM "notdienst_emails" c JOIN "families" p ON c."familyId" = p.id WHERE c."kitaId" IS DISTINCT FROM p."kitaId"
+UNION ALL
+SELECT 'notdienst_emails.userId' AS relation, count(*) AS invalid_rows FROM "notdienst_emails" c JOIN "users" p ON c."userId" = p.id WHERE c."kitaId" IS DISTINCT FROM p."kitaId"
+UNION ALL
+SELECT 'notdienst_emails.planId' AS relation, count(*) AS invalid_rows FROM "notdienst_emails" c JOIN "notdienst_plans" p ON c."planId" = p.id WHERE c."kitaId" IS DISTINCT FROM p."kitaId"
 ) violations WHERE invalid_rows > 0;

scripts/notdienst-alarm-worker.mjs

@@ -2,7 +2,7 @@
 const secret = process.env.NOTDIENST_JOB_SECRET;
 if (!secret || secret.length < 32) {
   console.error(
-    "Notdienst-Fristprüfung deaktiviert: NOTDIENST_JOB_SECRET muss mindestens 32 Zeichen haben.",
+    "Notdienst-Hintergrundjob deaktiviert: NOTDIENST_JOB_SECRET muss mindestens 32 Zeichen haben.",
   );
   process.exit(1);
 }
@@ -23,11 +23,11 @@ async function tick() {
     );
     if (!response.ok)
       console.error(
-        `Notdienst-Fristprüfung: HTTP ${response.status}; erneuter Versuch in einer Minute.`,
+        `Notdienst-Hintergrundjob: HTTP ${response.status}; erneuter Versuch in einer Minute.`,
       );
   } catch {
     console.error(
-      "Notdienst-Fristprüfung momentan nicht erreichbar; erneuter Versuch in einer Minute.",
+      "Notdienst-Hintergrundjob momentan nicht erreichbar; erneuter Versuch in einer Minute.",
     );
   }
   if (!stopped)

scripts/prepare-standalone.mjs

@@ -6,3 +6,5 @@ cpSync('scripts/start-production.sh', '.next/standalone/scripts/start-production
 cpSync('scripts/notdienst-alarm-worker.mjs', '.next/standalone/scripts/notdienst-alarm-worker.mjs');
 cpSync('scripts/runtime-database-url.mjs', '.next/standalone/scripts/runtime-database-url.mjs');
 cpSync('scripts/verify-runtime-isolation.mjs', '.next/standalone/scripts/verify-runtime-isolation.mjs');
+
+cpSync('scripts/start-runtime.mjs', '.next/standalone/scripts/start-runtime.mjs');

scripts/start-production.sh

@@ -7,7 +7,8 @@ if [ -n "${APP_DATABASE_PASSWORD_FILE:-}" ]; then
 fi
 unset POSTGRES_PASSWORD PGADMIN_DEFAULT_PASSWORD APP_DATABASE_PASSWORD MIGRATION_DATABASE_URL
 # Schema changes are applied by the maintenance image before runtime startup.
-if [ -n "${NOTDIENST_JOB_SECRET:-}" ]; then
-  node scripts/notdienst-alarm-worker.mjs &
+if [ -n "${NOTDIENST_JOB_SECRET:-}" ] && [ "${#NOTDIENST_JOB_SECRET}" -lt 32 ]; then
+  echo "NOTDIENST_JOB_SECRET muss mindestens 32 Zeichen haben." >&2
+  exit 1
 fi
-exec node server.js
+exec node scripts/start-runtime.mjs

scripts/start-runtime.mjs

@@ -0,0 +1,58 @@
+import { spawn } from "node:child_process";
+let stopping = false,
+  worker,
+  restartTimer,
+  stopTimer;
+const server = spawn(process.execPath, ["server.js"], { stdio: "inherit" });
+function shutdown(code = 0) {
+  if (stopping) return;
+  stopping = true;
+  process.exitCode = code;
+  clearTimeout(restartTimer);
+  server.kill("SIGTERM");
+  worker?.kill("SIGTERM");
+  stopTimer = setTimeout(() => {
+    server.kill("SIGKILL");
+    worker?.kill("SIGKILL");
+    process.exit(code);
+  }, 4000);
+  stopTimer.unref();
+  Promise.all(
+    [server, worker]
+      .filter(Boolean)
+      .map((child) =>
+        child.exitCode !== null || child.signalCode !== null
+          ? Promise.resolve()
+          : new Promise((resolve) => child.once("close", resolve)),
+      ),
+  ).then(() => {
+    clearTimeout(stopTimer);
+    process.exit(code);
+  });
+}
+function startWorker() {
+  if (stopping) return;
+  worker = spawn(process.execPath, ["scripts/notdienst-alarm-worker.mjs"], {
+    stdio: "inherit",
+  });
+  worker.on("close", () => {
+    if (stopping) return;
+    console.error(
+      "Notdienst-Hintergrundjob beendet; Neustart in fünf Sekunden.",
+    );
+    restartTimer = setTimeout(startWorker, 5000);
+  });
+  worker.on("error", () => {
+    if (!stopping)
+      console.error("Notdienst-Hintergrundjob konnte nicht starten.");
+  });
+}
+server.on("exit", (code) => shutdown(code ?? 1));
+server.on("error", () => shutdown(1));
+for (const signal of ["SIGTERM", "SIGINT"])
+  process.on(signal, () => shutdown(0));
+if ((process.env.NOTDIENST_JOB_SECRET?.length ?? 0) >= 32) startWorker();
+else
+  console.warn(
+    "Automatische Notdienst-Jobs deaktiviert: gültiges NOTDIENST_JOB_SECRET fehlt.",
+  );

src/actions/absences.ts

@@ -1,24 +1,33 @@
 "use server";
 
 import { revalidatePath } from "next/cache";
-import { AbsenceReason, UserRole } from "@prisma/client";
+import { AbsenceReason, Prisma, UserRole } from "@prisma/client";
 import { dateOnlySchema } from "@/lib/date-schema";
 import { z } from "zod";
-
 import { requireKitaSession, requireRole } from "@/lib/auth-utils";
 import { prisma } from "@/lib/prisma";
+import {
+  absenceDate,
+  absenceToday,
+  canManageKitaAbsences,
+} from "@/lib/absence-policy";
 
-const reportAbsenceSchema = z.object({
-  childId: z.string().min(1),
-  startDate: dateOnlySchema,
-  endDate: dateOnlySchema,
+const dateSchema = dateOnlySchema;
+const fieldsSchema = z.object({
+  startDate: dateSchema,
+  endDate: dateSchema,
   reason: z.nativeEnum(AbsenceReason),
   note: z.string().trim().max(500).optional(),
 });
-
-const dailyAbsenceSchema = z.object({
-  date: dateOnlySchema,
+const reportSchema = fieldsSchema.extend({
+  childId: z.string().min(1).max(128),
 });
+const identitySchema = z.object({
+  id: z.string().min(1).max(128),
+  updatedAt: z.string().datetime({ offset: true }),
+});
+const updateSchema = fieldsSchema.extend(identitySchema.shape);
+type MutationResult = { success?: boolean; error?: string };
 
 export type DailyAbsenceDto = {
   id: string;
@@ -28,112 +37,216 @@ export type DailyAbsenceDto = {
   note: string | null;
   startDate: string;
   endDate: string;
+  updatedAt: string;
 };
 
-function parseDateOnly(value: string) {
-  const date = new Date(`${value.slice(0, 10)}T00:00:00`);
-  if (Number.isNaN(date.getTime())) {
-    throw new Error("Ungueltiges Datum.");
-  }
-  return date;
+function refreshAbsences() {
+  revalidatePath("/dashboard");
+  revalidatePath("/dashboard/abwesenheiten");
+  revalidatePath("/dashboard/admin/abwesenheiten");
 }
 
-function toDateKey(date: Date) {
-  return date.toISOString().slice(0, 10);
-}
-
-export async function reportAbsence(rawPayload: unknown) {
-  const session = await requireKitaSession();
-  const parsed = reportAbsenceSchema.safeParse(rawPayload);
-
-  if (!parsed.success) {
-    return { error: "Ungültige Eingabedaten." };
-  }
-
-  if (!session.user.familyId) {
-    return { error: "Dein Account ist noch keinem Haushalt zugeordnet." };
-  }
-
-  const startDate = parseDateOnly(parsed.data.startDate);
-  const endDate = parseDateOnly(parsed.data.endDate);
-
-  if (endDate < startDate) {
-    return { error: "Das Enddatum darf nicht vor dem Startdatum liegen." };
-  }
-
-  const child = await prisma.child.findFirst({
+async function currentActor(
+  tx: Prisma.TransactionClient,
+  id: string,
+  kitaId: string,
+) {
+  return tx.user.findFirst({
     where: {
-      id: parsed.data.childId,
+      id,
+      kitaId,
+      role: {
+        in: [
+          UserRole.ELTERN,
+          UserRole.ADMIN,
+          UserRole.KOORDINATOR,
+          UserRole.ERZIEHER,
+        ],
+      },
+    },
+    select: { id: true, role: true, familyId: true },
+  });
+}
+
+async function lockChild(
+  tx: Prisma.TransactionClient,
+  childId: string,
+  kitaId: string,
+) {
+  // Serializes overlapping create/edit/delete operations for this child.
+  await tx.$queryRaw`SELECT "id" FROM "children" WHERE "id" = ${childId} AND "kitaId" = ${kitaId} FOR UPDATE`;
+}
+
+export async function reportAbsence(
+  rawPayload: unknown,
+): Promise<MutationResult> {
+  const session = await requireKitaSession();
+  const parsed = reportSchema.safeParse(rawPayload);
+  if (!parsed.success)
+    return {
+      error:
+        "Bitte gültige Daten und einen Grund angeben. Die Bemerkung darf höchstens 500 Zeichen haben.",
+    };
+  const { childId, startDate, endDate, reason, note } = parsed.data;
+  if (endDate < startDate)
+    return { error: "Das Enddatum darf nicht vor dem Startdatum liegen." };
+  const result = await prisma.$transaction(async (tx) => {
+    const actor = await currentActor(tx, session.user.id, session.user.kitaId);
+    if (!actor?.familyId)
+      return { error: "Dein Account ist keinem Haushalt zugeordnet." };
+    if (!canManageKitaAbsences(actor.role) && startDate < absenceToday())
+      return {
+        error:
+          "Vergangene Tage kann nur die Kita nachtragen. Bitte melde dich dort.",
+      };
+    await lockChild(tx, childId, session.user.kitaId);
+    const child = await tx.child.findFirst({
+      where: {
+        id: childId,
         kitaId: session.user.kitaId,
-      familyId: session.user.familyId,
+        familyId: actor.familyId,
         active: true,
       },
       select: { id: true },
     });
-
-  if (!child) {
-    return { error: "Dieses Kind gehört nicht zu deinem Haushalt." };
-  }
-
-  const overlappingAbsence = await prisma.absence.findFirst({
+    if (!child)
+      return {
+        error:
+          "Dieses Kind gehört nicht zu deinem Haushalt oder ist nicht mehr aktiv.",
+      };
+    const start = absenceDate(startDate),
+      end = absenceDate(endDate);
+    const overlap = await tx.absence.findFirst({
       where: {
         kitaId: session.user.kitaId,
-      childId: child.id,
+        childId,
+        startDate: { lte: end },
+        endDate: { gte: start },
+      },
+      select: { id: true },
+    });
+    if (overlap)
+      return { error: "Für diesen Zeitraum existiert bereits eine Abmeldung." };
+    await tx.absence.create({
+      data: {
+        kitaId: session.user.kitaId,
+        childId,
+        startDate: start,
+        endDate: end,
+        reason,
+        note: note || null,
+      },
+    });
+    return { success: true };
+  });
+  if (result.success) refreshAbsences();
+  return result;
+}
+
+async function changeAbsence(
+  rawPayload: unknown,
+  remove: boolean,
+): Promise<MutationResult> {
+  const session = await requireKitaSession();
+  const parsed = remove
+    ? identitySchema.safeParse(rawPayload)
+    : updateSchema.safeParse(rawPayload);
+  if (!parsed.success)
+    return {
+      error:
+        "Ungültige Eingabedaten. Bitte die Ansicht aktualisieren und gültige Daten angeben.",
+    };
+  const input = parsed.data;
+  const fields = remove ? null : updateSchema.parse(rawPayload);
+  if (fields && fields.endDate < fields.startDate)
+    return { error: "Das Enddatum darf nicht vor dem Startdatum liegen." };
+  const result = await prisma.$transaction(async (tx) => {
+    const actor = await currentActor(tx, session.user.id, session.user.kitaId);
+    if (!actor) return { error: "Keine Berechtigung für diese Meldung." };
+    const team = canManageKitaAbsences(actor.role);
+    if (!team && !actor.familyId)
+      return { error: "Dein Account ist keinem Haushalt zugeordnet." };
+    const where: Prisma.AbsenceWhereInput = {
+      id: input.id,
+      kitaId: session.user.kitaId,
+      child: {
+        kitaId: session.user.kitaId,
+        ...(team ? {} : { familyId: actor.familyId! }),
+      },
+    };
+    const candidate = await tx.absence.findFirst({
+      where,
+      select: { childId: true },
+    });
+    if (!candidate)
+      return {
+        error:
+          "Meldung wurde nicht gefunden oder gehört nicht zu deinem Haushalt.",
+      };
+    await lockChild(tx, candidate.childId, session.user.kitaId);
+    const absence = await tx.absence.findFirst({ where });
+    if (!absence)
+      return {
+        error:
+          "Die Meldung ist nicht mehr vorhanden. Bitte die Ansicht aktualisieren.",
+      };
+    if (
+      absence.updatedAt.toISOString() !==
+      new Date(input.updatedAt).toISOString()
+    )
+      return {
+        error:
+          "Die Meldung wurde inzwischen geändert. Bitte die Ansicht aktualisieren.",
+      };
+    const today = absenceToday();
+    if (
+      !team &&
+      (absence.startDate.toISOString().slice(0, 10) <= today ||
+        (fields && fields.startDate <= today))
+    )
+      return {
+        error:
+          "Bereits begonnene Meldungen und laufende Tage verwaltet die Kita. Bitte melde dich dort.",
+      };
+    if (remove) await tx.absence.delete({ where: { id: absence.id } });
+    else if (fields) {
+      const startDate = absenceDate(fields.startDate),
+        endDate = absenceDate(fields.endDate);
+      const overlap = await tx.absence.findFirst({
+        where: {
+          kitaId: session.user.kitaId,
+          childId: absence.childId,
+          id: { not: absence.id },
           startDate: { lte: endDate },
           endDate: { gte: startDate },
         },
         select: { id: true },
       });
-
-  if (overlappingAbsence) {
-    return { error: "Für diesen Zeitraum existiert bereits eine Abmeldung." };
-  }
-
-  await prisma.absence.create({
+      if (overlap)
+        return {
+          error: "Für diesen Zeitraum existiert bereits eine andere Abmeldung.",
+        };
+      await tx.absence.update({
+        where: { id: absence.id },
         data: {
-      kitaId: session.user.kitaId,
-      childId: child.id,
           startDate,
           endDate,
-      reason: parsed.data.reason,
-      note: parsed.data.note || null,
+          reason: fields.reason,
+          note: fields.note || null,
         },
       });
-
-  revalidatePath("/dashboard");
-  revalidatePath("/dashboard/admin/abwesenheiten");
+    }
     return { success: true };
+  });
+  if (result.success) refreshAbsences();
+  return result;
 }
 
-export async function deleteAbsence(id: string) {
-  const session = await requireKitaSession();
-
-  if (!session.user.familyId) {
-    return { error: "Dein Account ist noch keinem Haushalt zugeordnet." };
-  }
-
-  const absence = await prisma.absence.findFirst({
-    where: {
-      id,
-      kitaId: session.user.kitaId,
-      child: {
-        familyId: session.user.familyId,
-      },
-    },
-    select: { id: true },
-  });
-
-  if (!absence) {
-    return { error: "Diese Abmeldung gehört nicht zu deinem Haushalt." };
-  }
-
-  await prisma.absence.delete({
-    where: { id: absence.id },
-  });
-
-  revalidatePath("/dashboard");
-  revalidatePath("/dashboard/admin/abwesenheiten");
-  return { success: true };
+export async function updateAbsence(rawPayload: unknown) {
+  return changeAbsence(rawPayload, false);
+}
+export async function deleteAbsence(rawPayload: unknown) {
+  return changeAbsence(rawPayload, true);
 }
 
 export async function getDailyAbsences(
@@ -144,17 +257,10 @@ export async function getDailyAbsences(
     UserRole.KOORDINATOR,
     UserRole.ERZIEHER,
   ]);
-
-  if (!session.user.kitaId) {
-    return { error: "Kein Mandant zugeordnet." };
-  }
-
-  const parsed = dailyAbsenceSchema.safeParse(rawPayload);
-  if (!parsed.success) {
-    return { error: "Ungültiges Datum." };
-  }
-
-  const date = parseDateOnly(parsed.data.date);
+  if (!session.user.kitaId) return { error: "Kein Mandant zugeordnet." };
+  const parsed = z.object({ date: dateSchema }).safeParse(rawPayload);
+  if (!parsed.success) return { error: "Ungültiges Datum." };
+  const date = absenceDate(parsed.data.date);
   const rows = await prisma.absence.findMany({
     where: {
       kitaId: session.user.kitaId,
@@ -167,24 +273,17 @@ export async function getDailyAbsences(
       note: true,
       startDate: true,
       endDate: true,
+      updatedAt: true,
       child: {
         select: {
           firstName: true,
           lastName: true,
-          family: {
-            select: {
-              name: true,
+          family: { select: { name: true } },
         },
       },
     },
-      },
-    },
-    orderBy: [
-      { child: { lastName: "asc" } },
-      { child: { firstName: "asc" } },
-    ],
+    orderBy: [{ child: { lastName: "asc" } }, { child: { firstName: "asc" } }],
   });
-
   return {
     absences: rows.map((absence) => ({
       id: absence.id,
@@ -192,8 +291,9 @@ export async function getDailyAbsences(
       familyName: absence.child.family.name,
       reason: absence.reason,
       note: absence.note,
-      startDate: toDateKey(absence.startDate),
-      endDate: toDateKey(absence.endDate),
+      startDate: absence.startDate.toISOString().slice(0, 10),
+      endDate: absence.endDate.toISOString().slice(0, 10),
+      updatedAt: absence.updatedAt.toISOString(),
     })),
   };
 }

src/app/api/jobs/notdienstalarme/route.ts

@@ -1,6 +1,8 @@
 import { revalidatePath } from "next/cache";
 import { authorizeAlarmJob, runAlarmJob } from "@/lib/alarms/job";
 
+import { runNotdienstNotificationJob } from "@/lib/notdienst-notifications";
+
 export const runtime = "nodejs";
 export const dynamic = "force-dynamic";
 export async function POST(request: Request) {
@@ -16,9 +18,12 @@ export async function POST(request: Request) {
       { status },
     );
   try {
-    const result = await runAlarmJob();
+    const [alarm, planning] = await Promise.allSettled([runAlarmJob(), runNotdienstNotificationJob()]);
+    if (alarm.status === "rejected" || planning.status === "rejected") throw new Error("Ein Hintergrundlauf ist fehlgeschlagen.");
+    const result = { ...alarm.value, planning: planning.value };
     revalidatePath("/dashboard");
     revalidatePath("/dashboard/notdienst/alarm");
+    revalidatePath("/dashboard/notdienst/plan");
     return Response.json(result);
   } catch {
     return Response.json(

src/app/dashboard/absence-card.tsx

@@ -1,13 +1,14 @@
 "use client";
 
 import Link from "next/link";
-import { useMemo, useTransition } from "react";
+import { useMemo, useState, useTransition } from "react";
 import { AbsenceReason } from "@prisma/client";
 import { Baby, CalendarX2, Check, ChevronRight, Loader2 } from "lucide-react";
 import { reasonColor, reasonLabel } from "@/lib/absence-utils";
 import { toast } from "sonner";
 
 import { reportAbsence } from "@/actions/absences";
+import { AbsenceManagementActions } from "@/components/absence-management-actions";
 import { Badge } from "@/components/ui/badge";
 import { Button } from "@/components/ui/button";
 import {
@@ -40,6 +41,7 @@ type AbsenceListItem = {
   note: string | null;
   startDate: string;
   endDate: string;
+  updatedAt: string;
 };
 
 export function AbsenceCard({
@@ -47,10 +49,11 @@ export function AbsenceCard({
   today,
 }: {
   childOptions: ChildOption[];
-  absences: AbsenceListItem[];
   today: string;
 }) {
   const [isPending, startTransition] = useTransition();
+  const [startDate, setStartDate] = useState(today);
+  const [endDate, setEndDate] = useState(today);
   const defaultChildId = childOptions[0]?.id;
   const hasChildren = childOptions.length > 0;
 
@@ -92,7 +95,17 @@ export function AbsenceCard({
 
       <CardContent>
         {hasChildren ? (
-          <form action={handleSubmit}>
+          <form
+            onReset={() => {
+              setStartDate(today);
+              setEndDate(today);
+            }}
+            onSubmit={(event) => {
+              event.preventDefault();
+              handleSubmit(new FormData(event.currentTarget));
+            }}
+          >
+            <fieldset disabled={isPending}>
               <div className="grid gap-4 md:grid-cols-2">
                 <FieldLabel label="Welches Kind?">
                   <Select name="childId" defaultValue={defaultChildId} required>
@@ -119,7 +132,9 @@ export function AbsenceCard({
                       <SelectValue placeholder="Grund auswählen" />
                     </SelectTrigger>
                     <SelectContent>
-                    <SelectItem value={AbsenceReason.ILLNESS}>Krank</SelectItem>
+                      <SelectItem value={AbsenceReason.ILLNESS}>
+                        Krank
+                      </SelectItem>
                       <SelectItem value={AbsenceReason.VACATION}>
                         Urlaub
                       </SelectItem>
@@ -135,7 +150,13 @@ export function AbsenceCard({
                     id="absence-startDate"
                     name="startDate"
                     type="date"
-                  defaultValue={today}
+                    value={startDate}
+                    min={today}
+                    onChange={(event) => {
+                      const date = event.target.value;
+                      setStartDate(date);
+                      if (date > endDate) setEndDate(date);
+                    }}
                     required
                   />
                 </FieldLabel>
@@ -145,7 +166,9 @@ export function AbsenceCard({
                     id="absence-endDate"
                     name="endDate"
                     type="date"
-                  defaultValue={today}
+                    value={endDate}
+                    min={startDate}
+                    onChange={(event) => setEndDate(event.target.value)}
                     required
                   />
                 </FieldLabel>
@@ -178,6 +201,7 @@ export function AbsenceCard({
                   Abwesenheit melden
                 </Button>
               </div>
+            </fieldset>
           </form>
         ) : (
           <div className="flex min-h-72 flex-col items-center justify-center rounded-[14px] border border-dashed border-[var(--hairline)] bg-[var(--surface-2)] p-6 text-center">
@@ -201,8 +225,12 @@ export function AbsenceCard({
 
 export function UpcomingAbsencesCard({
   absences,
+  today,
+  team = false,
 }: {
   absences: AbsenceListItem[];
+  today: string;
+  team?: boolean;
 }) {
   return (
     <Card>
@@ -233,16 +261,21 @@ export function UpcomingAbsencesCard({
         ) : (
           <div className="divide-y divide-[var(--hairline-soft)]">
             {absences.map((absence) => (
-              <AbsenceRow key={absence.id} absence={absence} />
+              <AbsenceRow
+                key={`${absence.id}-${absence.updatedAt}`}
+                absence={absence}
+                today={today}
+                team={team}
+              />
             ))}
           </div>
         )}
 
         <Link
-          href="/dashboard/admin/abwesenheiten"
+          href="/dashboard/abwesenheiten"
           className="mt-4 inline-flex items-center gap-1 text-[13px] font-semibold text-[var(--accent-deep)] transition hover:gap-2 focus-visible:outline-none focus-visible:ring-[3px] focus-visible:ring-[var(--focus-ring)]"
         >
-          Alle Abwesenheiten
+          Meine Abwesenheiten
           <ChevronRight className="h-3.5 w-3.5" />
         </Link>
       </CardContent>
@@ -272,7 +305,15 @@ function FieldLabel({
   );
 }
 
-function AbsenceRow({ absence }: { absence: AbsenceListItem }) {
+function AbsenceRow({
+  absence,
+  today,
+  team,
+}: {
+  absence: AbsenceListItem;
+  today: string;
+  team: boolean;
+}) {
   const { day, month, detail } = useMemo(() => {
     const start = new Date(`${absence.startDate}T00:00:00`);
     const end = new Date(`${absence.endDate}T00:00:00`);
@@ -327,9 +368,8 @@ function AbsenceRow({ absence }: { absence: AbsenceListItem }) {
             {absence.note}
           </p>
         ) : null}
+        <AbsenceManagementActions absence={absence} today={today} team={team} />
       </div>
     </div>
   );
 }
-
-

src/app/dashboard/abwesenheiten/page.tsx

@@ -0,0 +1,203 @@
+import Link from "next/link";
+import { requireKitaSession } from "@/lib/auth-utils";
+import { prisma } from "@/lib/prisma";
+import {
+  absenceDate,
+  absenceToday,
+  canManageKitaAbsences,
+} from "@/lib/absence-policy";
+import { reasonLabel } from "@/lib/absence-utils";
+import { AbsenceManagementActions } from "@/components/absence-management-actions";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent } from "@/components/ui/card";
+import { Badge } from "@/components/ui/badge";
+
+export const metadata = { title: "Meine Abwesenheiten · Kita-Planer" };
+
+export default async function OwnAbsencesPage({
+  searchParams,
+}: {
+  searchParams: Promise<{ view?: string; page?: string }>;
+}) {
+  const session = await requireKitaSession();
+  const actor = await prisma.user.findFirstOrThrow({
+    where: { id: session.user.id, kitaId: session.user.kitaId },
+    select: { familyId: true, role: true },
+  });
+  const query = await searchParams;
+  const past = query.view === "past";
+  const parsedPage = Number(query.page ?? 1);
+  const requestedPage =
+    Number.isSafeInteger(parsedPage) && parsedPage > 0 ? parsedPage : 1;
+  const today = absenceToday();
+  const where = {
+    kitaId: session.user.kitaId,
+    child: { kitaId: session.user.kitaId, familyId: actor.familyId ?? "" },
+    endDate: past ? { lt: absenceDate(today) } : { gte: absenceDate(today) },
+  };
+  const count = actor.familyId ? await prisma.absence.count({ where }) : 0;
+  const pages = Math.max(1, Math.ceil(count / 20));
+  const page = Math.min(requestedPage, pages);
+  const absences = actor.familyId
+    ? await prisma.absence.findMany({
+        where,
+        select: {
+          id: true,
+          startDate: true,
+          endDate: true,
+          reason: true,
+          note: true,
+          updatedAt: true,
+          child: { select: { firstName: true, lastName: true } },
+        },
+        orderBy: [{ startDate: past ? "desc" : "asc" }, { id: "asc" }],
+        take: 20,
+        skip: (page - 1) * 20,
+      })
+    : [];
+  const href = (nextPage: number) =>
+    `/dashboard/abwesenheiten?view=${past ? "past" : "current"}&page=${nextPage}`;
+  const dateLabel = (date: Date) =>
+    new Intl.DateTimeFormat("de-DE", {
+      dateStyle: "medium",
+      timeZone: "UTC",
+    }).format(date);
+  return (
+    <div className="mx-auto max-w-[1100px] px-11 py-9 max-[760px]:px-5">
+      <header className="mb-7">
+        <p className="text-[11px] font-semibold uppercase tracking-widest text-[var(--accent-deep)]">
+          MEIN HAUSHALT
+        </p>
+        <h1 className="mt-2 text-4xl tracking-tight">
+          Meine{" "}
+          <em className="font-normal text-[var(--accent-deep)]">
+            Abwesenheiten
+          </em>
+        </h1>
+        <p className="mt-3 max-w-2xl text-sm leading-6 text-[var(--ink-soft)]">
+          Zukünftige Meldungen deiner Kinder kannst du ändern oder zurücknehmen.
+          Sobald eine Meldung begonnen hat, übernimmt die Kita die gesamte
+          Meldung.
+        </p>
+        <div className="mt-4 flex flex-wrap gap-2">
+          <Button asChild variant="outline" size="sm">
+            <Link href="/dashboard">Kind abmelden</Link>
+          </Button>
+          {canManageKitaAbsences(actor.role) && (
+            <Button asChild variant="outline" size="sm">
+              <Link href="/dashboard/admin/abwesenheiten">
+                Kita-Tagesübersicht
+              </Link>
+            </Button>
+          )}
+        </div>
+      </header>
+      {!actor.familyId ? (
+        <Card>
+          <CardContent className="py-6">
+            <p className="mb-3">
+              Deinem Konto ist noch kein Haushalt zugeordnet.
+            </p>
+            <Button asChild variant="outline">
+              <Link href="/dashboard/profil">Profil öffnen</Link>
+            </Button>
+          </CardContent>
+        </Card>
+      ) : (
+        <>
+          <nav aria-label="Abwesenheitszeitraum" className="mb-5 flex gap-2">
+            <Button asChild size="sm" variant={!past ? "default" : "outline"}>
+              <Link href="/dashboard/abwesenheiten">Aktuell & zukünftig</Link>
+            </Button>
+            <Button asChild size="sm" variant={past ? "default" : "outline"}>
+              <Link href="/dashboard/abwesenheiten?view=past">Vergangen</Link>
+            </Button>
+          </nav>
+          <p className="mb-3 text-sm text-[var(--ink-muted)]">
+            {count} Meldung{count === 1 ? "" : "en"}
+          </p>
+          <div className="grid gap-4">
+            {absences.length === 0 && (
+              <Card>
+                <CardContent className="py-8 text-sm text-[var(--ink-soft)]">
+                  Für diesen Zeitraum sind keine Abwesenheiten gemeldet.
+                </CardContent>
+              </Card>
+            )}
+            {absences.map((absence) => {
+              const startDate = absence.startDate.toISOString().slice(0, 10);
+              return (
+                <Card key={absence.id}>
+                  <CardContent className="py-5">
+                    <div className="flex flex-wrap items-start justify-between gap-3">
+                      <div>
+                        <h2 className="font-semibold">
+                          {absence.child.firstName} {absence.child.lastName}
+                        </h2>
+                        <p className="mt-1 text-sm text-[var(--ink-soft)]">
+                          {dateLabel(absence.startDate)}
+                          {absence.endDate.getTime() !==
+                          absence.startDate.getTime()
+                            ? ` – ${dateLabel(absence.endDate)}`
+                            : ""}{" "}
+                          · {reasonLabel(absence.reason)}
+                        </p>
+                      </div>
+                      <Badge variant="secondary">
+                        {past
+                          ? "Vergangen"
+                          : startDate <= today
+                            ? "Laufend"
+                            : "Zukünftig"}
+                      </Badge>
+                    </div>
+                    {absence.note && (
+                      <p className="mt-3 whitespace-pre-wrap break-words text-sm text-[var(--ink-soft)]">
+                        {absence.note}
+                      </p>
+                    )}
+                    <AbsenceManagementActions
+                      key={`${absence.id}-${absence.updatedAt.toISOString()}`}
+                      today={today}
+                      team={canManageKitaAbsences(actor.role)}
+                      absence={{
+                        id: absence.id,
+                        reason: absence.reason,
+                        note: absence.note,
+                        childName: `${absence.child.firstName} ${absence.child.lastName}`,
+                        startDate,
+                        endDate: absence.endDate.toISOString().slice(0, 10),
+                        updatedAt: absence.updatedAt.toISOString(),
+                      }}
+                    />
+                  </CardContent>
+                </Card>
+              );
+            })}
+          </div>
+          {pages > 1 && (
+            <div className="mt-5 flex items-center justify-between gap-3">
+              {page > 1 ? (
+                <Button asChild variant="outline">
+                  <Link href={href(page - 1)}>Zurück</Link>
+                </Button>
+              ) : (
+                <span />
+              )}
+              <span className="text-sm text-[var(--ink-muted)]">
+                Seite {page} von {pages}
+              </span>
+              {page < pages ? (
+                <Button asChild variant="outline">
+                  <Link href={href(page + 1)}>Weiter</Link>
+                </Button>
+              ) : (
+                <span />
+              )}
+            </div>
+          )}
+        </>
+      )}
+    </div>
+  );
+}

src/app/dashboard/admin/abwesenheiten/_components/absences-client.tsx

@@ -3,7 +3,7 @@
 import { useState, useMemo } from "react";
 import Link from "next/link";
 import { useRouter } from "next/navigation";
-import { addDays, format, isWeekend, parseISO } from "date-fns";
+import { addDays, format, parseISO } from "date-fns";
 import { de } from "date-fns/locale";
 import {
   ArrowLeft,
@@ -55,34 +55,23 @@ export function AbsencesClient({
   const today = parseISO(todayStr);
 
   // Filters State
-  const [selectedGroup, setSelectedGroup] = useState<"all" | "Krippe" | "Elementar">("all");
   const [selectedReason, setSelectedReason] = useState<"all" | AbsenceReason>("all");
 
   // Dropdown UI state
-  const [isGroupOpen, setIsGroupOpen] = useState(false);
   const [isReasonOpen, setIsReasonOpen] = useState(false);
 
   // Date input state
   const [inputDate, setInputDate] = useState(dateKey);
 
-  // Group resolver function
-  const mockGroup = (childName: string) => {
-    const charCode = childName.charCodeAt(0);
-    return charCode % 2 === 0 ? "Krippe" : "Elementar";
-  };
-
   // Filter computation
   const filteredAbsences = useMemo(() => {
     return initialAbsences.filter((item) => {
-      if (selectedGroup !== "all" && mockGroup(item.childName) !== selectedGroup) {
-        return false;
-      }
       if (selectedReason !== "all" && item.reason !== selectedReason) {
         return false;
       }
       return true;
     });
-  }, [initialAbsences, selectedGroup, selectedReason]);
+  }, [initialAbsences, selectedReason]);
 
   // Recalculate reasons count based on filtered absences
   const countsByReason = useMemo(() => {
@@ -113,9 +102,9 @@ export function AbsencesClient({
             TAGESÜBERSICHT
           </p>
           <h1 className="mt-2 text-[36px] font-normal leading-tight tracking-[-0.025em] text-[var(--ink)]">
-            Heute fehlen{" "}
+            {isToday ? "Heute" : "An diesem Tag"}{filteredAbsences.length === 1 ? " fehlt " : " fehlen "}
             <em className="font-normal italic text-[var(--accent-deep)]">
-              {filteredAbsences.length} Kinder
+              {filteredAbsences.length} {filteredAbsences.length === 1 ? "Kind" : "Kinder"}
             </em>
           </h1>
           <p className="mt-2 text-[15px] leading-6 text-[var(--ink-soft)]">
@@ -126,7 +115,7 @@ export function AbsencesClient({
         <div className="flex flex-wrap items-center justify-end gap-3">
           <span className="inline-flex h-9 items-center gap-2 rounded-full border border-[var(--hairline)] bg-[var(--surface)] px-3 text-[13px] font-semibold text-[var(--ink-soft)]">
             <Stethoscope className="h-4 w-4 text-[var(--accent-deep)] [stroke-width:1.7]" />
-            {childCount - filteredAbsences.length} anwesend
+            {Math.max(0, childCount - initialAbsences.length)} anwesend
           </span>
           <div className="inline-flex overflow-hidden rounded-full border border-[var(--hairline)] bg-[var(--surface)]">
             <button
@@ -167,71 +156,6 @@ export function AbsencesClient({
 
       <div className="mt-5 flex flex-wrap items-center justify-between gap-3">
         <div className="flex flex-wrap gap-2">
-          {/* Group Dropdown Filter */}
-          <div className="relative">
-            <button
-              type="button"
-              onClick={() => setIsGroupOpen(!isGroupOpen)}
-              className={`inline-flex h-9 items-center gap-2 rounded-full border px-4 text-[13px] font-semibold transition focus-visible:outline-none focus-visible:ring-[3px] focus-visible:ring-[var(--focus-ring)] ${
-                selectedGroup !== "all"
-                  ? "border-[var(--accent-mid)] bg-[var(--accent-soft)] text-[var(--accent-deep)]"
-                  : "border-[var(--hairline)] bg-transparent text-[var(--ink-soft)] hover:bg-[var(--surface-2)]"
-              }`}
-            >
-              {selectedGroup === "all" ? "Alle Gruppen" : selectedGroup}
-              <ChevronDown className="h-3.5 w-3.5" />
-            </button>
-            {isGroupOpen && (
-              <>
-                <div className="fixed inset-0 z-10" onClick={() => setIsGroupOpen(false)} />
-                <div className="absolute left-0 mt-1.5 w-44 rounded-lg border border-[var(--hairline)] bg-[var(--surface)] py-1.5 shadow-lg z-20">
-                  <button
-                    type="button"
-                    onClick={() => {
-                      setSelectedGroup("all");
-                      setIsGroupOpen(false);
-                    }}
-                    className={`w-full text-left px-4 py-2 text-[13px] transition-colors ${
-                      selectedGroup === "all"
-                        ? "bg-[var(--accent-soft)] text-[var(--accent-deep)] font-semibold"
-                        : "text-[var(--ink-soft)] hover:bg-[var(--surface-2)]"
-                    }`}
-                  >
-                    Alle Gruppen
-                  </button>
-                  <button
-                    type="button"
-                    onClick={() => {
-                      setSelectedGroup("Krippe");
-                      setIsGroupOpen(false);
-                    }}
-                    className={`w-full text-left px-4 py-2 text-[13px] transition-colors ${
-                      selectedGroup === "Krippe"
-                        ? "bg-[var(--accent-soft)] text-[var(--accent-deep)] font-semibold"
-                        : "text-[var(--ink-soft)] hover:bg-[var(--surface-2)]"
-                    }`}
-                  >
-                    Krippe (Mock)
-                  </button>
-                  <button
-                    type="button"
-                    onClick={() => {
-                      setSelectedGroup("Elementar");
-                      setIsGroupOpen(false);
-                    }}
-                    className={`w-full text-left px-4 py-2 text-[13px] transition-colors ${
-                      selectedGroup === "Elementar"
-                        ? "bg-[var(--accent-soft)] text-[var(--accent-deep)] font-semibold"
-                        : "text-[var(--ink-soft)] hover:bg-[var(--surface-2)]"
-                    }`}
-                  >
-                    Elementar (Mock)
-                  </button>
-                </div>
-              </>
-            )}
-          </div>
-
           {/* Reason Dropdown Filter */}
           <div className="relative">
             <button
@@ -361,7 +285,7 @@ export function AbsencesClient({
               </div>
             </CardHeader>
             <CardContent>
-              <AbsenceTable absences={filteredAbsences} />
+              <AbsenceTable absences={filteredAbsences} today={todayStr} />
             </CardContent>
           </Card>
         ) : isTooFarFuture ? (

src/app/dashboard/admin/abwesenheiten/absence-table.tsx

@@ -4,6 +4,8 @@ import { useState } from "react";
 import { AbsenceReason } from "@prisma/client";
 import { CalendarDays, Circle, MessageSquareText, UserRound } from "lucide-react";
 import { reasonColor, reasonLabel } from "@/lib/absence-utils";
+import { AbsenceManagementActions } from "@/components/absence-management-actions";
+import { Button } from "@/components/ui/button";
 
 import { Badge } from "@/components/ui/badge";
 import {
@@ -30,12 +32,12 @@ export type AbsenceTableItem = {
   note: string | null;
   startDate: string;
   endDate: string;
+  updatedAt: string;
 };
 
-export function AbsenceTable({ absences }: { absences: AbsenceTableItem[] }) {
-  const [activeAbsence, setActiveAbsence] = useState<AbsenceTableItem | null>(
-    null,
-  );
+export function AbsenceTable({ absences, today }: { absences: AbsenceTableItem[]; today: string }) {
+  const [activeId, setActiveId] = useState<string | null>(null);
+  const activeAbsence = absences.find((absence) => absence.id === activeId) ?? null;
 
   return (
     <>
@@ -47,6 +49,7 @@ export function AbsenceTable({ absences }: { absences: AbsenceTableItem[] }) {
             <TableHead>Grund</TableHead>
             <TableHead>Bemerkung</TableHead>
             <TableHead>Status</TableHead>
+            <TableHead><span className="sr-only">Aktionen</span></TableHead>
           </TableRow>
         </TableHeader>
         <TableBody>
@@ -54,7 +57,7 @@ export function AbsenceTable({ absences }: { absences: AbsenceTableItem[] }) {
             <TableRow
               key={absence.id}
               className="cursor-pointer border-[var(--hairline-soft)] hover:bg-[var(--surface-2)]"
-              onClick={() => setActiveAbsence(absence)}
+              onClick={() => setActiveId(absence.id)}
             >
               <TableCell>
                 <div className="flex items-center gap-3">
@@ -89,6 +92,9 @@ export function AbsenceTable({ absences }: { absences: AbsenceTableItem[] }) {
               <TableCell>
                 <Badge variant="success">Bestätigt</Badge>
               </TableCell>
+              <TableCell>
+                <Button type="button" variant="ghost" size="sm" onClick={(event) => { event.stopPropagation(); setActiveId(absence.id); }} aria-label={`Abwesenheit öffnen: ${absence.childName}`}>Details & bearbeiten</Button>
+              </TableCell>
             </TableRow>
           ))}
         </TableBody>
@@ -96,9 +102,9 @@ export function AbsenceTable({ absences }: { absences: AbsenceTableItem[] }) {
 
       <Dialog
         open={!!activeAbsence}
-        onOpenChange={(open) => !open && setActiveAbsence(null)}
+        onOpenChange={(open) => !open && setActiveId(null)}
       >
-        <DialogContent className="left-auto right-0 top-0 h-full max-w-md translate-x-0 translate-y-0 rounded-none border-y-0 border-r-0 border-[var(--hairline)] bg-[var(--surface)] data-[state=closed]:slide-out-to-right data-[state=open]:slide-in-from-right">
+        <DialogContent className="left-auto right-0 top-0 h-full max-w-md overflow-y-auto translate-x-0 translate-y-0 rounded-none border-y-0 border-r-0 border-[var(--hairline)] bg-[var(--surface)] data-[state=closed]:slide-out-to-right data-[state=open]:slide-in-from-right">
           {activeAbsence ? (
             <>
               <DialogHeader>
@@ -129,6 +135,7 @@ export function AbsenceTable({ absences }: { absences: AbsenceTableItem[] }) {
                   value={activeAbsence.note || "Keine Bemerkung hinterlegt."}
                 />
                 <DetailLine icon={UserRound} label="Status" value="Bestätigt" />
+                <AbsenceManagementActions key={activeAbsence.updatedAt} absence={activeAbsence} today={today} team onChanged={() => setActiveId(null)} />
               </div>
             </>
           ) : null}

src/app/dashboard/admin/abwesenheiten/page.tsx

@@ -1,9 +1,9 @@
-import { differenceInCalendarDays, format, isWeekend } from "date-fns";
 import { TerminStatus, TerminType, UserRole } from "@prisma/client";
 
 import { getDailyAbsences } from "@/actions/absences";
 import { requireRole } from "@/lib/auth-utils";
 import { prisma } from "@/lib/prisma";
+import { absenceDate, absenceToday, isAbsenceDate } from "@/lib/absence-policy";
 import { AbsencesClient } from "./_components/absences-client";
 import { type AbsenceTableItem } from "./absence-table";
 
@@ -21,9 +21,10 @@ export default async function AdminAbwesenheitenPage({
   ]);
   const resolvedSearchParams = await searchParams;
   const kitaId = session.user.kitaId!;
-  const today = startOfLocalDay(new Date());
+  const todayKey = absenceToday();
+  const today = absenceDate(todayKey);
   const selectedDate = parseDateParam(resolvedSearchParams.date, today);
-  const dateKey = format(selectedDate, "yyyy-MM-dd");
+  const dateKey = selectedDate.toISOString().slice(0, 10);
   const result = await getDailyAbsences({ date: dateKey });
   const absences = result.absences ?? [];
   const childCount = await prisma.child.count({
@@ -46,9 +47,9 @@ export default async function AdminAbwesenheitenPage({
     select: { title: true, type: true },
     orderBy: { startDate: "asc" },
   });
-  const isToday = dateKey === format(today, "yyyy-MM-dd");
-  const isTooFarFuture = differenceInCalendarDays(selectedDate, today) > 30;
-  const isClosedDay = isWeekend(selectedDate) || !!closure;
+  const isToday = dateKey === todayKey;
+  const isTooFarFuture = (selectedDate.getTime() - today.getTime()) / 86_400_000 > 30;
+  const isClosedDay = [0, 6].includes(selectedDate.getUTCDay()) || !!closure;
   const tableItems: AbsenceTableItem[] = absences.map((absence) => ({
     id: absence.id,
     childName: absence.childName,
@@ -57,6 +58,7 @@ export default async function AdminAbwesenheitenPage({
     note: absence.note,
     startDate: absence.startDate,
     endDate: absence.endDate,
+    updatedAt: absence.updatedAt,
   }));
 
   return (
@@ -67,11 +69,11 @@ export default async function AdminAbwesenheitenPage({
         upcomingAbsenceCount={upcomingAbsenceCount}
         closure={closure}
         dateKey={dateKey}
-        selectedDateStr={selectedDate.toISOString()}
+        selectedDateStr={dateKey}
         isToday={isToday}
         isTooFarFuture={isTooFarFuture}
         isClosedDay={isClosedDay}
-        todayStr={today.toISOString()}
+        todayStr={todayKey}
         error={result.error ?? null}
       />
     </div>
@@ -79,13 +81,5 @@ export default async function AdminAbwesenheitenPage({
 }
 
 function parseDateParam(value: string | undefined, fallback: Date) {
-  if (!value) return fallback;
-  const parsed = new Date(`${value}T00:00:00`);
-  return Number.isNaN(parsed.getTime()) ? fallback : parsed;
-}
-
-function startOfLocalDay(date: Date) {
-  const nextDate = new Date(date);
-  nextDate.setHours(0, 0, 0, 0);
-  return nextDate;
+  return value && isAbsenceDate(value) ? absenceDate(value) : fallback;
 }

src/app/dashboard/families/_components/families-list-client.tsx

@@ -19,6 +19,8 @@ import {
 import { AddFamilyDialog } from "../add-family-dialog";
 import { DutyManager } from "../duty-manager";
 import { EditFamilyDialog } from "../edit-family-dialog";
+import { InvitationStatus } from "../invitation-status";
+import type { FamilyInvitationView } from "@/lib/family-invitation-view";
 
 interface FamilyUser {
   id: string;
@@ -26,6 +28,7 @@ interface FamilyUser {
   lastName: string;
   email: string;
   emailVerifiedAt: Date | null;
+  invitation: FamilyInvitationView;
   dutyAssignments: {
     id: string;
     dutyId: string;
@@ -250,6 +253,7 @@ export function FamiliesListClient({
                                   {!parent.emailVerifiedAt && <ResendInviteButton userId={parent.id} />}
                                 </span>
                               </div>
+                              <InvitationStatus userId={parent.id} name={`${parent.firstName} ${parent.lastName}`} invitation={parent.invitation} />
                             </div>
                           ))}
                         </div>
@@ -288,6 +292,7 @@ export function FamiliesListClient({
                                 firstName: parent.firstName,
                                 lastName: parent.lastName,
                                 email: parent.email,
+                                invitation: parent.invitation,
                               })),
                               children: family.children,
                             }}
@@ -357,6 +362,7 @@ export function FamiliesListClient({
                                 {!parent.emailVerifiedAt && <ResendInviteButton userId={parent.id} />}
                               </span>
                             </div>
+                            <InvitationStatus userId={parent.id} name={`${parent.firstName} ${parent.lastName}`} invitation={parent.invitation} />
                           </div>
                         ))}
                       </div>
@@ -393,6 +399,7 @@ export function FamiliesListClient({
                           firstName: parent.firstName,
                           lastName: parent.lastName,
                           email: parent.email,
+                          invitation: parent.invitation,
                         })),
                         children: family.children,
                       }}

src/app/dashboard/families/actions.ts

@@ -1,45 +1,56 @@
 "use server";
 
-import { hashToken, newToken } from "@/lib/tokens";
-import { createElement } from "react";
 import { revalidatePath } from "next/cache";
 import { Prisma, UserRole } from "@prisma/client";
 import { z } from "zod";
 
-import { InviteEmail } from "@/emails/InviteEmail";
 import { requireRole } from "@/lib/auth-utils";
-import { getAppEmailConfigError, sendAppEmail } from "@/lib/mail";
 import { rateLimit } from "@/lib/rate-limit";
+import {
+  deliverFamilyInvitations,
+  queueFamilyInvitation,
+  resendFamilyInvitation,
+} from "@/lib/family-invitations";
 import { prisma } from "@/lib/prisma";
-
-const INVITE_TOKEN_TTL_DAYS = 7;
-const BASE_URL =
-  process.env.NEXTAUTH_URL ?? process.env.AUTH_URL ?? "http://localhost:3000";
+import { assertChildrenRemovable } from "@/lib/notdienst-planning";
+import { UserFacingError, publicActionError } from "@/lib/action-error";
 
 const childSchema = z.object({
-  firstName: z.string().min(1, "Vorname des Kindes fehlt.").max(100).trim(),
-  lastName: z.string().min(1, "Nachname des Kindes fehlt.").max(100).trim(),
+  firstName: z.string().trim().min(1, "Vorname des Kindes fehlt.").max(100),
+  lastName: z.string().trim().min(1, "Nachname des Kindes fehlt.").max(100),
 });
 
 const parentInputSchema = z.object({
-  firstName: z.string().min(1, "Vorname ist erforderlich.").max(100).trim(),
-  lastName: z.string().min(1, "Nachname ist erforderlich.").max(100).trim(),
+  firstName: z.string().trim().min(1, "Vorname ist erforderlich.").max(100),
+  lastName: z.string().trim().min(1, "Nachname ist erforderlich.").max(100),
   email: z
     .string()
-    .email("Bitte eine gültige E-Mail-Adresse angeben.")
+    .trim()
     .toLowerCase()
-    .trim(),
+    .email("Bitte eine gültige E-Mail-Adresse angeben."),
 });
 
 const addFamilySchema = z.object({
-  familyName: z.string().min(1, "Familienname ist erforderlich.").max(120).trim(),
-  parent1FirstName: z.string().min(1, "Vorname ist erforderlich.").max(100).trim(),
-  parent1LastName: z.string().min(1, "Nachname ist erforderlich.").max(100).trim(),
+  familyName: z
+    .string()
+    .trim()
+    .min(1, "Familienname ist erforderlich.")
+    .max(120),
+  parent1FirstName: z
+    .string()
+    .trim()
+    .min(1, "Vorname ist erforderlich.")
+    .max(100),
+  parent1LastName: z
+    .string()
+    .trim()
+    .min(1, "Nachname ist erforderlich.")
+    .max(100),
   parent1Email: z
     .string()
-    .email("Bitte eine gültige E-Mail-Adresse angeben.")
+    .trim()
     .toLowerCase()
-    .trim(),
+    .email("Bitte eine gültige E-Mail-Adresse angeben."),
   parent2FirstName: z.string().max(100).trim().optional(),
   parent2LastName: z.string().max(100).trim().optional(),
   parent2Email: z.string().trim().optional(),
@@ -52,12 +63,19 @@ const addFamilySchema = z.object({
 
 const updateFamilySchema = z.object({
   familyId: z.string().min(1),
-  familyName: z.string().min(1, "Familienname ist erforderlich.").max(120).trim(),
-  parents: z.array(
+  familyName: z
+    .string()
+    .trim()
+    .min(1, "Familienname ist erforderlich.")
+    .max(120),
+  parents: z
+    .array(
       parentInputSchema.extend({
         id: z.string().min(1),
       }),
-  ).min(1).max(2),
+    )
+    .min(1)
+    .max(2),
   newParents: z.array(parentInputSchema).max(1).default([]),
   children: z
     .array(
@@ -83,12 +101,7 @@ export type AddFamilyState = {
     _form?: string[];
   };
   success?: boolean;
-};
-
-type InviteJob = {
-  to: string;
-  parentName: string;
-  inviteUrl: string;
+  warning?: string;
 };
 
 function optionalParentFromForm(data: z.infer<typeof addFamilySchema>) {
@@ -115,32 +128,14 @@ function optionalParentFromForm(data: z.infer<typeof addFamilySchema>) {
   return { ok: true as const, parent: parsed.data };
 }
 
-function createInviteToken() {
-  const token = newToken();
-  const expires = new Date(
-    Date.now() + INVITE_TOKEN_TTL_DAYS * 24 * 60 * 60_000,
-  );
-  return { token, expires, inviteUrl: `${BASE_URL}/invite/${token}` };
-}
-
-async function sendInviteJobs(kitaName: string, jobs: InviteJob[]) {
-  for (const job of jobs) {
-    const result = await sendAppEmail({
-      to: job.to,
-      subject: `Einladung zu ${kitaName} im Kita-Planer`,
-      react: createElement(InviteEmail, {
-        parentName: job.parentName,
-        kitaName,
-        inviteLink: job.inviteUrl,
-      }),
-    });
-
-    if (!result.success) {
-      return result.error;
+async function sendInviteJobs(ids: string[]) {
+  try {
+    const result = await deliverFamilyInvitations(ids);
+    if (!result.failed) return undefined;
+  } catch {
+    // A committed family remains successful even if delivery/status storage fails.
   }
-  }
-
-  return null;
+  return "Familie gespeichert. Mindestens eine Einladung konnte nicht versendet werden. Den Versand kannst du beim jeweiligen Elternteil erneut versuchen.";
 }
 
 export async function addFamilyAction(
@@ -185,11 +180,6 @@ export async function addFamilyAction(
     childrenRaw.push(parsed.data);
   }
 
-  const mailConfigError = getAppEmailConfigError();
-  if (mailConfigError) {
-    return { errors: { _form: [mailConfigError] } };
-  }
-
   const kita = await prisma.kita.findUnique({
     where: { id: kitaId },
     select: { name: true },
@@ -211,12 +201,14 @@ export async function addFamilyAction(
   if (emailSet.size !== parents.length) {
     return {
       errors: {
-        _form: ["Die E-Mail-Adressen der Elternteile müssen unterschiedlich sein."],
+        _form: [
+          "Die E-Mail-Adressen der Elternteile müssen unterschiedlich sein.",
+        ],
       },
     };
   }
 
-  const inviteJobs: InviteJob[] = [];
+  const inviteJobs: string[] = [];
 
   try {
     await prisma.$transaction(async (tx) => {
@@ -239,19 +231,12 @@ export async function addFamilyAction(
             role: UserRole.ELTERN,
           },
         });
-        const invite = createInviteToken();
-        inviteJobs.push({
-          to: parent.email,
-          parentName: `${parent.firstName} ${parent.lastName}`,
-          inviteUrl: invite.inviteUrl,
-        });
-        await tx.verificationToken.create({
-          data: {
-            identifier: createdParent.id,
-            token: hashToken(invite.token),
-            expires: invite.expires,
-          },
-        });
+        const invite = await queueFamilyInvitation(
+          tx,
+          createdParent.id,
+          session.user.id,
+        );
+        inviteJobs.push(invite.id);
       }
 
       await tx.child.createMany({
@@ -274,26 +259,25 @@ export async function addFamilyAction(
         },
       };
     }
-    throw err;
-  }
-
-  const emailError = await sendInviteJobs(kita.name, inviteJobs);
-  if (emailError) {
+    console.error("Familie konnte nicht angelegt werden:", err);
     return {
       errors: {
         _form: [
-          `Familie wurde angelegt, aber mindestens eine Einladung konnte nicht versendet werden: ${emailError}`,
+          "Familie konnte nicht angelegt werden. Bitte erneut versuchen.",
         ],
       },
     };
   }
 
+  const warning = await sendInviteJobs(inviteJobs);
   revalidatePath("/dashboard/families");
   revalidatePath("/dashboard");
-  return { success: true };
+  return { success: true, warning };
 }
 
-export async function updateFamilyAction(rawPayload: unknown) {
+export async function updateFamilyAction(
+  rawPayload: unknown,
+): Promise<{ success?: boolean; error?: string; warning?: string }> {
   const session = await requireRole([UserRole.ADMIN]);
   const kitaId = session.user.kitaId;
 
@@ -316,9 +300,13 @@ export async function updateFamilyAction(rawPayload: unknown) {
     removedChildIds,
   } = parsed.data;
 
-  const parentEmails = [...parents, ...newParents].map((parent) => parent.email);
+  const parentEmails = [...parents, ...newParents].map(
+    (parent) => parent.email,
+  );
   if (new Set(parentEmails).size !== parentEmails.length) {
-    return { error: "Die E-Mail-Adressen der Elternteile müssen unterschiedlich sein." };
+    return {
+      error: "Die E-Mail-Adressen der Elternteile müssen unterschiedlich sein.",
+    };
   }
 
   const removedChildIdSet = new Set(removedChildIds);
@@ -328,13 +316,6 @@ export async function updateFamilyAction(rawPayload: unknown) {
     return { error: "Eine Familie benötigt mindestens ein Kind." };
   }
 
-  if (newParents.length > 0) {
-    const mailConfigError = getAppEmailConfigError();
-    if (mailConfigError) {
-      return { error: mailConfigError };
-    }
-  }
-
   const kita = await prisma.kita.findUnique({
     where: { id: kitaId },
     select: { name: true },
@@ -344,7 +325,7 @@ export async function updateFamilyAction(rawPayload: unknown) {
     return { error: "Kita wurde nicht gefunden." };
   }
 
-  const inviteJobs: InviteJob[] = [];
+  const inviteJobs: string[] = [];
 
   try {
     const existingFamily = await prisma.family.findFirst({
@@ -362,8 +343,6 @@ export async function updateFamilyAction(rawPayload: unknown) {
 
     const needsEmail = newParents.length > 0 || parents.some(parent => existingFamily.users.find(user => user.id === parent.id)?.email !== parent.email);
     if (needsEmail) {
-      const configError = getAppEmailConfigError();
-      if (configError) return { error: configError };
       if (!(await rateLimit(`family-invites:${kitaId}`, 30, 3600)).allowed) return { error: "Zu viele Einladungen. Bitte versuche es später erneut." };
     }
 
@@ -371,7 +350,9 @@ export async function updateFamilyAction(rawPayload: unknown) {
     const existingChildIds = new Set(existingFamily.children.map((child) => child.id));
 
     if (!parents.every((parent) => existingParentIds.has(parent.id))) {
-      return { error: "Mindestens ein Elternteil gehört nicht zu dieser Familie." };
+      return {
+        error: "Mindestens ein Elternteil gehört nicht zu dieser Familie.",
+      };
     }
 
     if (!children.every((child) => existingChildIds.has(child.id))) {
@@ -387,6 +368,9 @@ export async function updateFamilyAction(rawPayload: unknown) {
     }
 
     await prisma.$transaction(async (tx) => {
+      await assertChildrenRemovable(tx, kitaId, familyId, removedChildIds);
+      const removed = await tx.child.count({ where: { kitaId, familyId, id: { in: removedChildIds } } });
+      if (removed !== removedChildIds.length) throw new UserFacingError("Mindestens ein Kind gehört nicht zu dieser Familie.");
       await tx.family.update({
         where: { id: familyId },
         data: { name: familyName },
@@ -402,10 +386,12 @@ export async function updateFamilyAction(rawPayload: unknown) {
             ...(emailChanged ? { passwordHash: "", emailVerifiedAt: null, sessionVersion: { increment: 1 } } : {}) },
         });
         if (emailChanged) {
-          const invite = createInviteToken();
-          await tx.verificationToken.deleteMany({ where: { identifier: parent.id } });
-          await tx.verificationToken.create({ data: { identifier: parent.id, token: hashToken(invite.token), expires: invite.expires } });
-          inviteJobs.push({ to: parent.email, parentName: `${parent.firstName} ${parent.lastName}`, inviteUrl: invite.inviteUrl });
+          const invite = await queueFamilyInvitation(
+            tx,
+            parent.id,
+            session.user.id,
+          );
+          inviteJobs.push(invite.id);
         }
       }
 
@@ -421,19 +407,12 @@ export async function updateFamilyAction(rawPayload: unknown) {
             role: UserRole.ELTERN,
           },
         });
-        const invite = createInviteToken();
-        inviteJobs.push({
-          to: parent.email,
-          parentName: `${parent.firstName} ${parent.lastName}`,
-          inviteUrl: invite.inviteUrl,
-        });
-        await tx.verificationToken.create({
-          data: {
-            identifier: createdParent.id,
-            token: hashToken(invite.token),
-            expires: invite.expires,
-          },
-        });
+        const invite = await queueFamilyInvitation(
+          tx,
+          createdParent.id,
+          session.user.id,
+        );
+        inviteJobs.push(invite.id);
       }
 
       for (const child of activeChildren) {
@@ -460,7 +439,7 @@ export async function updateFamilyAction(rawPayload: unknown) {
           },
         });
       }
-    });
+    }, { isolationLevel: Prisma.TransactionIsolationLevel.Serializable });
   } catch (error) {
     if (
       error instanceof Prisma.PrismaClientKnownRequestError &&
@@ -469,45 +448,52 @@ export async function updateFamilyAction(rawPayload: unknown) {
       return { error: "Mindestens eine E-Mail-Adresse existiert bereits." };
     }
 
-    console.error("Fehler beim Aktualisieren der Familie:", error);
-    return { error: "Familie konnte nicht aktualisiert werden." };
-  }
-
-  const emailError = await sendInviteJobs(kita.name, inviteJobs);
-  if (emailError) {
-    return {
-      error: `Familie wurde aktualisiert, aber mindestens eine Einladung konnte nicht versendet werden: ${emailError}`,
-    };
+    if (!(error instanceof UserFacingError)) console.error("Fehler beim Aktualisieren der Familie:", error);
+    return { error: publicActionError(error, "Familie konnte nicht aktualisiert werden.") };
   }
 
+  const warning = await sendInviteJobs(inviteJobs);
   revalidatePath("/dashboard/families");
   revalidatePath("/dashboard/profil");
   revalidatePath("/dashboard/notdienst");
   revalidatePath("/dashboard");
-  return { success: true };
+  return { success: true, warning };
+}
+
+export async function resendFamilyInvitationAction(
+  userId: string,
+): Promise<{ success?: boolean; error?: string; warning?: string }> {
+  const session = await requireRole([UserRole.ADMIN]);
+  if (!session.user.kitaId || typeof userId !== "string" || !userId || userId.length > 64)
+    return { error: "Ungültiges Elternkonto." };
+  if (!(await rateLimit(`family-invites:${session.user.kitaId}`, 30, 3600)).allowed)
+    return { error: "Bitte versuche es später erneut." };
+  if (!(await rateLimit(`resend-invite:${session.user.kitaId}:${userId}`, 3, 3600)).allowed)
+    return { error: "Bitte versuche es später erneut." };
+  const recipient = await prisma.user.findFirst({
+    where: { id: userId, kitaId: session.user.kitaId, familyId: { not: null },
+      emailVerifiedAt: null, passwordHash: "", disabledAt: null },
+    select: { email: true },
+  });
+  if (!recipient) return { error: "Keine offene Einladung gefunden." };
+  let result;
+  try {
+    result = await resendFamilyInvitation(
+      session.user.kitaId,
+      userId,
+      session.user.id,
+      recipient.email,
+    );
+  } catch {
+    result = {
+      error:
+        "Einladung konnte nicht erneut versendet werden. Bitte den Status prüfen und erneut versuchen.",
+    };
+  }
+  revalidatePath("/dashboard/families");
+  return result;
 }
 
 export async function resendParentInvite(userId: string) {
-  const session = await requireRole([UserRole.ADMIN]);
-  if (typeof userId !== "string" || !userId || userId.length > 64) return { error: "Ungültige Eingabedaten." };
-  if (!(await rateLimit(`family-invites:${session.user.kitaId}`, 30, 3600)).allowed) return { error: "Bitte versuche es später erneut." };
-  if (!(await rateLimit(`resend-invite:${session.user.kitaId}:${userId}`, 3, 3600)).allowed) return { error: "Bitte versuche es später erneut." };
-  const user = await prisma.user.findFirst({ where: { id: userId, kitaId: session.user.kitaId, emailVerifiedAt: null, passwordHash: "", disabledAt: null },
-    select: { id: true, email: true, firstName: true, lastName: true, kita: { select: { name: true } } } });
-  if (!user?.kita) return { error: "Keine offene Einladung gefunden." };
-  const configError = getAppEmailConfigError(); if (configError) return { error: configError };
-  const invite = createInviteToken();
-  const renewed = await prisma.$transaction(async tx => {
-    // Lock and re-check the account before issuing a link for the selected mailbox.
-    // A concurrent address change/activation must invalidate this resend.
-    const eligible = await tx.user.updateMany({ where: { id: user.id, email: user.email, kitaId: session.user.kitaId,
-      emailVerifiedAt: null, passwordHash: "", disabledAt: null }, data: { sessionVersion: { increment: 1 } } });
-    if (eligible.count !== 1) return false;
-    await tx.verificationToken.deleteMany({ where: { identifier: user.id } });
-    await tx.verificationToken.create({ data: { identifier: user.id, token: hashToken(invite.token), expires: invite.expires } });
-    return true;
-  });
-  if (!renewed) return { error: "Die Einladung hat sich geändert. Bitte lade die Seite neu." };
-  const error = await sendInviteJobs(user.kita.name, [{ to: user.email, parentName: `${user.firstName} ${user.lastName}`, inviteUrl: invite.inviteUrl }]);
-  return error ? { error } : { success: true };
+  return resendFamilyInvitationAction(userId);
 }

src/app/dashboard/families/add-family-dialog.tsx

@@ -1,7 +1,8 @@
 "use client";
 
-import { useActionState, useState } from "react";
+import { useState, useTransition } from "react";
 import { Plus, Trash2 } from "lucide-react";
+import { toast } from "sonner";
 
 import { Button } from "@/components/ui/button";
 import { Input } from "@/components/ui/input";
@@ -26,28 +27,24 @@ const initialState: AddFamilyState = {};
 //   • Dialog-Open/Close-State
 //   • Dynamische Kinderliste (min. 1, max. 10)
 //   • Ein oder zwei Elternteile pro Haushalt
-//   • useActionState → Server-Action-Fehler anzeigen
-//   • Bei Erfolg (state.success) Dialog automatisch schließen
+//   • Eingaben bei Validierungsfehlern behalten
+//   • Nach erfolgreichem Speichern schließen, auch bei einer Versandwarnung
 // =====================================================================
 
 export function AddFamilyDialog() {
   const [open, setOpen] = useState(false);
-  const [childCount, setChildCount] = useState(1);
-  const [state, formAction, pending] = useActionState(
-    addFamilyAction,
-    initialState,
-  );
-
-  // Dialog schließen, wenn die Action erfolgreich war
-  if (state.success && open) {
-    setOpen(false);
-  }
+  const [childIds, setChildIds] = useState(["initial"]);
+  const childCount = childIds.length;
+  const [state, setState] = useState<AddFamilyState>(initialState);
+  const [pending, startTransition] = useTransition();
 
   function handleOpenChange(nextOpen: boolean) {
+    if (pending) return;
+    if (nextOpen) {
+      setState(initialState);
+      setChildIds([crypto.randomUUID()]);
+    }
     setOpen(nextOpen);
-    // State beim Schließen zurücksetzen würde useActionState erfordern —
-    // stattdessen schließen wir einfach und der State bleibt bis zur nächsten
-    // Aktion erhalten (unkritisch).
   }
 
   return (
@@ -63,12 +60,28 @@ export function AddFamilyDialog() {
         <DialogHeader>
           <DialogTitle>Familie hinzufügen</DialogTitle>
           <DialogDescription>
-            Lege einen Haushalt mit Elternteilen und Kindern an. Die
-            Elternteile erhalten Einladungslinks per E-Mail.
+            Lege einen Haushalt mit Elternteilen und Kindern an. Die Elternteile
+            erhalten Einladungslinks per E-Mail.
           </DialogDescription>
         </DialogHeader>
 
-        <form action={formAction} className="space-y-6">
+        <form
+          onSubmit={(event) => {
+            event.preventDefault();
+            const data = new FormData(event.currentTarget);
+            startTransition(async () => {
+              const result = await addFamilyAction(initialState, data);
+              setState(result);
+              if (result.success) {
+                if (result.warning) toast.warning(result.warning);
+                else toast.success("Familie angelegt. Einladungen versendet.");
+                setOpen(false);
+              }
+            });
+          }}
+          className="space-y-6"
+        >
+          <fieldset disabled={pending} className="space-y-6">
             {/* Anzahl Kinder als verstecktes Feld für die Server Action */}
             <input type="hidden" name="childCount" value={childCount} />
 
@@ -164,7 +177,9 @@ export function AddFamilyDialog() {
                     type="button"
                     variant="ghost"
                     size="sm"
-                  onClick={() => setChildCount((c) => c + 1)}
+                    onClick={() =>
+                      setChildIds((ids) => [...ids, crypto.randomUUID()])
+                    }
                   >
                     <Plus className="mr-1.5 h-3.5 w-3.5" />
                     Kind hinzufügen
@@ -172,18 +187,18 @@ export function AddFamilyDialog() {
                 )}
               </div>
 
-            {Array.from({ length: childCount }).map((_, i) => (
+              {childIds.map((childId, i) => (
                 <div
-                key={i}
+                  key={childId}
                   className="relative rounded-lg border border-[var(--hairline)] bg-[var(--surface-2)] p-4"
                 >
                   {childCount > 1 && (
                     <button
                       type="button"
                       onClick={() => {
-                      // Kind entfernen — childCount reduzieren reicht, da die
-                      // Felder nach Index benannt sind und der letzte entfernt wird.
-                      setChildCount((c) => c - 1);
+                        setChildIds((ids) =>
+                          ids.filter((id) => id !== childId),
+                        );
                       }}
                       className="absolute right-3 top-3 rounded-md p-1 text-[var(--ink-muted)] transition-colors hover:bg-[var(--danger-soft)] hover:text-[var(--danger)] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--accent)] focus-visible:ring-offset-2 focus-visible:ring-offset-[var(--surface-2)]"
                       aria-label={`Kind ${i + 1} entfernen`}
@@ -222,6 +237,7 @@ export function AddFamilyDialog() {
                 {state.errors._form[0]}
               </p>
             )}
+          </fieldset>
 
           <DialogFooter>
             <Button

src/app/dashboard/families/edit-family-dialog.tsx

@@ -1,6 +1,11 @@
 "use client";
 
-import { useMemo, useState, useTransition } from "react";
+import {
+  useMemo,
+  useState,
+  useTransition,
+  type ChangeEventHandler,
+} from "react";
 import { Pencil, Plus, Trash2 } from "lucide-react";
 import { toast } from "sonner";
 
@@ -17,12 +22,15 @@ import {
 import { Input } from "@/components/ui/input";
 import { Label } from "@/components/ui/label";
 import { updateFamilyAction } from "./actions";
+import { InvitationStatus } from "./invitation-status";
+import type { FamilyInvitationView } from "@/lib/family-invitation-view";
 
 type EditableParent = {
   id: string;
   firstName: string;
   lastName: string;
   email: string;
+  invitation?: FamilyInvitationView;
 };
 
 type EditableChild = {
@@ -47,6 +55,7 @@ type EditableFamily = {
 };
 
 export function EditFamilyDialog({ family }: { family: EditableFamily }) {
+  const [open, setOpen] = useState(false);
   const [isPending, startTransition] = useTransition();
   const initialParents = useMemo(
     () =>
@@ -154,13 +163,22 @@ export function EditFamilyDialog({ family }: { family: EditableFamily }) {
         return;
       }
 
-      toast.success("Familie aktualisiert. Geänderte E-Mail-Adressen müssen über einen neuen Einladungslink bestätigt werden.");
+      if (result.warning) toast.warning(result.warning);
+      else toast.success("Familie aktualisiert. Geänderte E-Mail-Adressen müssen über einen neuen Einladungslink bestätigt werden.");
+      setOpen(false);
       setRemovedChildIds([]);
     });
   }
 
   return (
-    <Dialog onOpenChange={(open) => !open && resetState()}>
+    <Dialog
+      open={open}
+      onOpenChange={(nextOpen) => {
+        if (isPending) return;
+        resetState();
+        setOpen(nextOpen);
+      }}
+    >
       <DialogTrigger asChild>
         <Button variant="ghost" size="sm" className="h-8 gap-1">
           <Pencil className="h-3.5 w-3.5" />
@@ -168,7 +186,12 @@ export function EditFamilyDialog({ family }: { family: EditableFamily }) {
         </Button>
       </DialogTrigger>
       <DialogContent className="max-h-[90vh] overflow-y-auto sm:max-w-2xl">
-        <form action={handleSubmit}>
+        <form
+          onSubmit={(event) => {
+            event.preventDefault();
+            handleSubmit(new FormData(event.currentTarget));
+          }}
+        >
           <DialogHeader>
             <DialogTitle>Familie bearbeiten</DialogTitle>
             <DialogDescription>
@@ -176,7 +199,7 @@ export function EditFamilyDialog({ family }: { family: EditableFamily }) {
             </DialogDescription>
           </DialogHeader>
 
-          <div className="grid gap-6 py-4">
+          <fieldset disabled={isPending} className="grid gap-6 py-4">
             <div className="grid gap-2">
               <Label htmlFor={`familyName-${family.id}`}>Familienname</Label>
               <Input
@@ -251,8 +274,38 @@ export function EditFamilyDialog({ family }: { family: EditableFamily }) {
                       label="E-Mail-Adresse"
                       type="email"
                       defaultValue={parent.email}
+                      onChange={(event) => {
+                        const email = event.target.value;
+                        setParents((current) =>
+                          current.map((item) =>
+                            item.id === parent.id ? { ...item, email } : item,
+                          ),
+                        );
+                      }}
                     />
                   </div>
+                  {parent.kind === "existing" && parent.invitation && (
+                    <InvitationStatus
+                      userId={parent.id}
+                      name={`${parent.firstName} ${parent.lastName}`}
+                      invitation={parent.invitation}
+                      blocked={
+                        parent.email !==
+                        family.parents.find((item) => item.id === parent.id)
+                          ?.email
+                      }
+                    />
+                  )}
+                  {parent.kind === "existing" &&
+                    parent.invitation?.status !== "active" &&
+                    parent.email !==
+                      family.parents.find((item) => item.id === parent.id)
+                        ?.email && (
+                      <p className="mt-2 text-xs text-[var(--ink-soft)]">
+                        Beim Speichern wird eine neue Einladung an die geänderte
+                        Adresse versendet.
+                      </p>
+                    )}
                 </div>
               ))}
             </fieldset>
@@ -319,7 +372,7 @@ export function EditFamilyDialog({ family }: { family: EditableFamily }) {
                 ))
               )}
             </fieldset>
-          </div>
+          </fieldset>
 
           <DialogFooter>
             <Button type="submit" disabled={isPending}>
@@ -338,12 +391,14 @@ function Field({
   label,
   type = "text",
   defaultValue,
+  onChange,
 }: {
   id: string;
   name: string;
   label: string;
   type?: string;
   defaultValue: string;
+  onChange?: ChangeEventHandler<HTMLInputElement>;
 }) {
   return (
     <div className="grid gap-2">
@@ -353,6 +408,7 @@ function Field({
         name={name}
         type={type}
         defaultValue={defaultValue}
+        onChange={onChange}
         required
       />
     </div>

src/app/dashboard/families/invitation-status.tsx

@@ -0,0 +1,73 @@
+"use client";
+
+import { useTransition } from "react";
+import { Mail } from "lucide-react";
+import { toast } from "sonner";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import type { FamilyInvitationView } from "@/lib/family-invitation-view";
+import { resendFamilyInvitationAction } from "./actions";
+
+const labels = {
+  active: "Konto aktiviert",
+  open: "Aktivierung offen",
+  sending: "Versand läuft",
+  sent: "Einladung versendet",
+  failed: "Versand fehlgeschlagen",
+  expired: "Einladung abgelaufen",
+};
+
+export function InvitationStatus({
+  userId,
+  name,
+  invitation,
+  blocked = false,
+}: {
+  userId: string;
+  name: string;
+  invitation: FamilyInvitationView;
+  blocked?: boolean;
+}) {
+  const [pending, startTransition] = useTransition();
+  return (
+    <div className="mt-2 flex flex-wrap items-center gap-2 text-xs">
+      <Badge variant={invitation.status === "active" ? "success" : "warning"}>
+        {labels[invitation.status]}
+      </Badge>
+      {invitation.status !== "active" && (
+        <>
+          {invitation.expiresAt && (
+            <span className="text-[var(--ink-muted)]">
+              {invitation.status === "expired"
+                ? "Gültig gewesen bis"
+                : "Link gültig bis"}{" "}
+              {new Intl.DateTimeFormat("de-DE", {
+                dateStyle: "short",
+                timeZone: "Europe/Berlin",
+              }).format(new Date(invitation.expiresAt))}
+            </span>
+          )}
+          <Button
+            type="button"
+            variant="outline"
+            size="sm"
+            className="h-7 text-xs"
+            disabled={blocked || pending || invitation.status === "sending"}
+            aria-label={`Einladung erneut senden an ${name}`}
+            onClick={() =>
+              startTransition(async () => {
+                const result = await resendFamilyInvitationAction(userId);
+                if (result.error) toast.error(result.error);
+                else if (result.warning) toast.warning(result.warning);
+                else toast.success("Einladung versendet.");
+              })
+            }
+          >
+            <Mail className="h-3 w-3" />
+            {pending ? "Wird versendet…" : "Einladung erneut senden"}
+          </Button>
+        </>
+      )}
+    </div>
+  );
+}

src/app/dashboard/families/page.tsx

@@ -2,6 +2,7 @@ import { UserRole } from "@prisma/client";
 
 import { requireRole } from "@/lib/auth-utils";
 import { prisma } from "@/lib/prisma";
+import { familyInvitationView } from "@/lib/family-invitation-view";
 import { FamiliesListClient } from "./_components/families-list-client";
 
 export const metadata = { title: "Familienverwaltung · Kita-Planer" };
@@ -32,6 +33,9 @@ export default async function FamiliesPage() {
           lastName: true,
           email: true,
           emailVerifiedAt: true,
+          familyInvitation: {
+            select: { expiresAt: true, sentAt: true, failed: true, leaseUntil: true, status: true },
+          },
           dutyAssignments: {
             select: {
               id: true,
@@ -73,7 +77,13 @@ export default async function FamiliesPage() {
   return (
     <div className="mx-auto max-w-[1280px] px-11 py-9 pb-16 max-[760px]:px-5">
       <FamiliesListClient
-        initialFamilies={families}
+        initialFamilies={families.map((family) => ({
+          ...family,
+          users: family.users.map(({ familyInvitation, ...parent }) => ({
+            ...parent,
+            invitation: familyInvitationView(parent.emailVerifiedAt, familyInvitation),
+          })),
+        }))}
         allDuties={allDuties}
         canManageDuties={canManageDuties}
       />

src/app/dashboard/kalender/_components/calendar-overview-client.tsx

@@ -207,7 +207,7 @@ export function CalendarOverviewClient({
 
   return (
     <div className="space-y-5">
-      {!isAdmin && pendingSwapRequests.length > 0 && (
+      {pendingSwapRequests.length > 0 && (
         <NotdienstSwapRequestsPanel requests={pendingSwapRequests} />
       )}
 
@@ -469,7 +469,7 @@ export function CalendarOverviewClient({
                             </a>
                           </div>
                         )}
-                        {!isAdmin && item.canRequestSwap && (
+                        {item.canRequestSwap && (
                           <div className="mt-3 flex gap-2">
                             <NotdienstSwapDialog
                               target={item}

src/app/dashboard/kalender/_components/mitbringsel-list.tsx

@@ -1,12 +1,16 @@
 "use client";
 
 import { useState, useTransition } from "react";
-import { Trash2, Plus, Utensils } from "lucide-react";
+import { Trash2, Plus, Utensils, Pencil } from "lucide-react";
 import { toast } from "sonner";
 
 import { Button } from "@/components/ui/button";
 import { Input } from "@/components/ui/input";
-import { addMitbringsel, deleteMitbringsel } from "../actions";
+import {
+  addMitbringsel,
+  deleteMitbringsel,
+  updateMitbringsel,
+} from "../actions";
 
 type MitbringselItemDto = {
   id: string;
@@ -27,30 +31,42 @@ export function MitbringselList({
   isAdmin: boolean;
 }) {
   const [content, setContent] = useState("");
+  const [editingId, setEditingId] = useState<string | null>(null);
+  const [editContent, setEditContent] = useState("");
   const [isPending, startTransition] = useTransition();
 
   const handleAdd = () => {
-    if (!content.trim()) return;
-
+    if (isPending || !content.trim()) return;
     startTransition(async () => {
       const res = await addMitbringsel({ terminId, content });
-      if (res.error) {
-        toast.error(res.error);
-      } else {
+      if (res.error) toast.error(res.error);
+      else {
         toast.success("Eintrag hinzugefügt.");
         setContent("");
       }
     });
   };
 
+  const handleSave = () => {
+    if (isPending || !editingId || !editContent.trim()) return;
+    startTransition(async () => {
+      const res = await updateMitbringsel({
+        itemId: editingId,
+        content: editContent,
+      });
+      if (res.error) toast.error(res.error);
+      else {
+        toast.success("Beitrag gespeichert.");
+        setEditingId(null);
+      }
+    });
+  };
+
   const handleDelete = (id: string) => {
     startTransition(async () => {
       const res = await deleteMitbringsel(id);
-      if (res.error) {
-        toast.error(res.error);
-      } else {
-        toast.success("Eintrag gelöscht.");
-      }
+      if (res.error) toast.error(res.error);
+      else toast.success("Eintrag gelöscht.");
     });
   };
 
@@ -60,8 +76,7 @@ export function MitbringselList({
         <Utensils className="h-4 w-4 text-[var(--ink-muted)] [stroke-width:1.7]" />
         Mitbring-Liste
       </div>
-
-      <div className="flex flex-col gap-2 max-h-40 overflow-y-auto">
+      <div className="flex max-h-60 flex-col gap-2 overflow-y-auto">
         {items.length === 0 ? (
           <p className="text-xs italic text-[var(--ink-faint)]">
             Noch keine Einträge vorhanden.
@@ -70,54 +85,118 @@ export function MitbringselList({
           items.map((item) => (
             <div
               key={item.id}
-              className="flex items-center justify-between gap-2 rounded-md border border-[var(--hairline-soft)] bg-[var(--surface)] p-2 text-sm text-[var(--ink)]"
+              className="rounded-md border border-[var(--hairline-soft)] bg-[var(--surface)] p-2 text-sm text-[var(--ink)]"
             >
-              <div className="flex flex-col">
+              <div className="flex items-start justify-between gap-2">
+                <div className="min-w-0 flex-1">
                   <span className="text-xs font-medium text-[var(--accent-deep)]">
                     {item.user.firstName} {item.user.lastName}
                   </span>
-                <span>{item.content}</span>
+                  {editingId !== item.id ? (
+                    <p className="break-words">{item.content}</p>
+                  ) : null}
                 </div>
-              {(isAdmin || item.userId === currentUserId) && (
+                {editingId !== item.id ? (
+                  <div className="flex shrink-0 gap-1">
+                    {item.userId === currentUserId ? (
                       <Button
+                        type="button"
                         variant="ghost"
                         size="icon"
-                  className="h-6 w-6 shrink-0 text-[var(--ink-muted)] hover:bg-[var(--danger-soft)] hover:text-[var(--danger)]"
+                        className="h-8 w-8"
+                        aria-label={`Beitrag bearbeiten: ${item.content}`}
+                        onClick={() => {
+                          setEditingId(item.id);
+                          setEditContent(item.content);
+                        }}
+                        disabled={isPending}
+                      >
+                        <Pencil className="h-4 w-4" />
+                      </Button>
+                    ) : null}
+                    {isAdmin || item.userId === currentUserId ? (
+                      <Button
+                        type="button"
+                        variant="ghost"
+                        size="icon"
+                        className="h-8 w-8 text-[var(--ink-muted)] hover:bg-[var(--danger-soft)] hover:text-[var(--danger)]"
+                        aria-label={`Beitrag löschen: ${item.content}`}
                         onClick={() => handleDelete(item.id)}
                         disabled={isPending}
                       >
-                  <Trash2 className="h-4 w-4 [stroke-width:1.7]" />
+                        <Trash2 className="h-4 w-4" />
                       </Button>
-              )}
+                    ) : null}
+                  </div>
+                ) : null}
+              </div>
+              {editingId === item.id ? (
+                <form
+                  className="mt-2 flex flex-wrap gap-2"
+                  onSubmit={(event) => {
+                    event.preventDefault();
+                    handleSave();
+                  }}
+                >
+                  <Input
+                    autoFocus
+                    aria-label="Mitbringbeitrag bearbeiten"
+                    value={editContent}
+                    onChange={(event) => setEditContent(event.target.value)}
+                    maxLength={500}
+                    disabled={isPending}
+                    className="h-8 min-w-0 flex-[1_1_180px] text-sm"
+                  />
+                  <Button
+                    type="submit"
+                    size="sm"
+                    className="h-8"
+                    disabled={isPending || !editContent.trim()}
+                  >
+                    Speichern
+                  </Button>
+                  <Button
+                    type="button"
+                    variant="ghost"
+                    size="sm"
+                    className="h-8"
+                    disabled={isPending}
+                    onClick={() => setEditingId(null)}
+                  >
+                    Abbrechen
+                  </Button>
+                </form>
+              ) : null}
             </div>
           ))
         )}
       </div>
-
-      <div className="flex gap-2 mt-1">
+      <form
+        className="mt-1 flex gap-2"
+        onSubmit={(event) => {
+          event.preventDefault();
+          handleAdd();
+        }}
+      >
         <Input
+          aria-label="Neuer Mitbringbeitrag"
           placeholder="Was bringst du mit?"
           value={content}
-          onChange={(e) => setContent(e.target.value)}
-          onKeyDown={(e) => {
-            if (e.key === "Enter") {
-              e.preventDefault();
-              handleAdd();
-            }
-          }}
+          onChange={(event) => setContent(event.target.value)}
+          maxLength={500}
           disabled={isPending}
-          className="h-8 text-sm"
+          className="h-8 min-w-0 text-sm"
         />
         <Button
+          type="submit"
           size="sm"
           className="h-8 shrink-0"
-          onClick={handleAdd}
           disabled={!content.trim() || isPending}
         >
-          <Plus className="mr-1 h-4 w-4 [stroke-width:1.7]" />
+          <Plus className="mr-1 h-4 w-4" />
           Hinzufügen
         </Button>
-      </div>
+      </form>
     </div>
   );
 }

src/app/dashboard/kalender/_components/termin-list.tsx

@@ -760,23 +760,18 @@ function NotdienstRow({
               </>
             )}
           </div>
-        ) : notdienst.canRequestSwap ? (
+        ) : null}
+        {notdienst.canRequestSwap ? (
           <NotdienstSwapDialog
             target={notdienst}
             options={notdienstSwapOptions}
             trigger={
-              <Button
-                size="sm"
-                variant="outline"
-                className="h-8 px-2.5 text-xs"
-              >
+              <Button size="sm" variant="outline" className="h-8 px-2.5 text-xs">
                 Tausch anfragen
               </Button>
             }
           />
-        ) : (
-          <div className="w-9 h-9" />
-        )}
+        ) : !isAdmin ? <div className="w-9 h-9" /> : null}
       </div>
     </div>
   );

src/app/dashboard/kalender/actions.ts

@@ -24,6 +24,7 @@ import { serializableTransaction } from "@/lib/transaction";
 import { rateLimit } from "@/lib/rate-limit";
 import { prisma } from "@/lib/prisma";
 import { lockEvent } from "@/lib/event-lock";
+import { canRequestNotdienstSwap } from "@/lib/notdienst-swaps";
 
 // =====================================================================
 // /dashboard/kalender · Server Actions
@@ -127,7 +128,7 @@ async function getSwapAssignment(
             select: {
               name: true,
               users: {
-                where: { role: UserRole.ELTERN, emailVerifiedAt: { not: null }, disabledAt: null, privacyPolicyAcceptedAt: { not: null } },
+                where: { role: { in: [UserRole.ELTERN, UserRole.ADMIN, UserRole.KOORDINATOR] }, emailVerifiedAt: { not: null }, disabledAt: null, privacyPolicyAcceptedAt: { not: null } },
                 select: {
                   email: true,
                   firstName: true,
@@ -335,11 +336,8 @@ function buildTerminData(
 export async function createNotdienstSwapRequest(rawPayload: unknown) {
   const session = await requireKitaSession();
   if (!(await rateLimit(`createNotdienstSwapRequest:${session.user.kitaId}:${session.user.id}`, 30, 3600)).allowed) return { error: "Zu viele Anfragen. Bitte versuche es später erneut." };
-  if (session.user.role !== UserRole.ELTERN) {
-    return { error: "Nur Eltern können Notdienst-Tausche anfragen." };
-  }
-  if (!session.user.familyId) {
-    return { error: "Dein Account ist noch keinem Haushalt zugeordnet." };
+  if (!canRequestNotdienstSwap(session.user.role, session.user.familyId)) {
+    return { error: "Nur Eltern mit einem eigenen Haushalt können Notdienst-Tausche anfragen." };
   }
 
   const parsed = swapRequestSchema.safeParse(rawPayload);
@@ -467,7 +465,7 @@ export async function acceptNotdienstSwapRequest(requestIdRaw: unknown) {
                     select: {
                       name: true,
                       users: {
-                        where: { role: UserRole.ELTERN, emailVerifiedAt: { not: null }, disabledAt: null, privacyPolicyAcceptedAt: { not: null } },
+                        where: { role: { in: [UserRole.ELTERN, UserRole.ADMIN, UserRole.KOORDINATOR] }, emailVerifiedAt: { not: null }, disabledAt: null, privacyPolicyAcceptedAt: { not: null } },
                         select: { email: true, firstName: true, lastName: true },
                       },
                     },
@@ -493,7 +491,7 @@ export async function acceptNotdienstSwapRequest(requestIdRaw: unknown) {
                     select: {
                       name: true,
                       users: {
-                        where: { role: UserRole.ELTERN, emailVerifiedAt: { not: null }, disabledAt: null, privacyPolicyAcceptedAt: { not: null } },
+                        where: { role: { in: [UserRole.ELTERN, UserRole.ADMIN, UserRole.KOORDINATOR] }, emailVerifiedAt: { not: null }, disabledAt: null, privacyPolicyAcceptedAt: { not: null } },
                         select: { email: true, firstName: true, lastName: true },
                       },
                     },
@@ -636,7 +634,7 @@ export async function declineNotdienstSwapRequest(requestIdRaw: unknown) {
                   select: {
                     name: true,
                     users: {
-                      where: { role: UserRole.ELTERN, emailVerifiedAt: { not: null }, disabledAt: null, privacyPolicyAcceptedAt: { not: null } },
+                      where: { role: { in: [UserRole.ELTERN, UserRole.ADMIN, UserRole.KOORDINATOR] }, emailVerifiedAt: { not: null }, disabledAt: null, privacyPolicyAcceptedAt: { not: null } },
                       select: { email: true, firstName: true, lastName: true },
                     },
                   },
@@ -654,7 +652,7 @@ export async function declineNotdienstSwapRequest(requestIdRaw: unknown) {
                   select: {
                     name: true,
                     users: {
-                      where: { role: UserRole.ELTERN, emailVerifiedAt: { not: null }, disabledAt: null, privacyPolicyAcceptedAt: { not: null } },
+                      where: { role: { in: [UserRole.ELTERN, UserRole.ADMIN, UserRole.KOORDINATOR] }, emailVerifiedAt: { not: null }, disabledAt: null, privacyPolicyAcceptedAt: { not: null } },
                       select: { email: true, firstName: true, lastName: true },
                     },
                   },
@@ -1059,6 +1057,44 @@ export async function addMitbringsel(rawPayload: unknown) {
   }
 }
 
+const updateMitbringselSchema = z.object({
+  itemId: z.string().min(1).max(100),
+  content: mitbringselSchema.shape.content,
+});
+
+export async function updateMitbringsel(rawPayload: unknown) {
+  const session = await requireKitaSession();
+  const parsed = updateMitbringselSchema.safeParse(rawPayload);
+  if (!parsed.success) return { error: "Bitte einen Beitrag mit 1 bis 500 Zeichen eingeben." };
+  if (!(await rateLimit(`updateMitbringsel:${session.user.kitaId}:${session.user.id}`, 30, 3600)).allowed) {
+    return { error: "Zu viele Änderungen. Bitte versuche es später erneut." };
+  }
+
+  try {
+    await serializableTransaction(async (tx) => {
+      const item = await tx.mitbringselItem.findFirst({
+        where: { id: parsed.data.itemId, kitaId: session.user.kitaId, userId: session.user.id },
+        select: { terminId: true },
+      });
+      if (!item) throw new UserFacingError("Du kannst nur eigene Mitbringbeiträge bearbeiten.");
+      await lockEvent(tx, item.terminId, session.user.kitaId);
+      const termin = await tx.termin.findFirst({
+        where: { id: item.terminId, kitaId: session.user.kitaId, status: TerminStatus.CONFIRMED, mitbringselListEnabled: true },
+        select: { id: true },
+      });
+      if (!termin) throw new UserFacingError("Die Mitbring-Liste ist für diesen Termin nicht mehr aktiv.");
+      await tx.mitbringselItem.update({
+        where: { id: parsed.data.itemId, kitaId: session.user.kitaId, userId: session.user.id },
+        data: { content: parsed.data.content },
+      });
+    });
+    revalidatePath("/dashboard/kalender");
+    return { success: true };
+  } catch (error) {
+    return { error: publicActionError(error, "Der Beitrag konnte nicht gespeichert werden.") };
+  }
+}
+
 export async function deleteMitbringsel(itemId: string) {
   const session = await requireKitaSession();
 

src/app/dashboard/kalender/page.tsx

@@ -9,6 +9,7 @@ import { HelpCircle } from "lucide-react";
 
 import { requireKitaSession } from "@/lib/auth-utils";
 import { prisma } from "@/lib/prisma";
+import { canRequestNotdienstSwap } from "@/lib/notdienst-swaps";
 import { getRsvpEvents } from "@/lib/rsvp-events";
 import { AdminTerminModal } from "./_components/admin-termin-modal";
 import {
@@ -213,7 +214,7 @@ export default async function KalenderPage({
   });
 
   const pendingSwapRows =
-    !isAdmin && session.user.familyId
+    session.user.familyId && canRequestNotdienstSwap(session.user.role, session.user.familyId)
       ? await prisma.notdienstSwapRequest.findMany({
           where: {
             kitaId: session.user.kitaId,
@@ -306,9 +307,8 @@ export default async function KalenderPage({
     ...notdienstAssignmentRows.map((assignment) => {
       const isOwn = assignment.child.familyId === familyIdForParticipation;
       const canRequestSwap =
-        !isAdmin &&
+        canRequestNotdienstSwap(session.user.role, session.user.familyId) &&
         !isOwn &&
-        !!session.user.familyId &&
         assignment.date >= today;
       return {
         kind: "notdienst" as const,

src/app/dashboard/notdienst/actions.ts

@@ -5,8 +5,10 @@ import { UserRole } from "@prisma/client";
 import { z } from "zod";
 
 import { requireRole } from "@/lib/auth-utils";
-import { prisma } from "@/lib/prisma";
-import { getTargetMonthData } from "@/lib/date-utils";
+import { formatUtcDateKey, getTargetMonthData } from "@/lib/date-utils";
+import { serializableTransaction } from "@/lib/transaction";
+import { UserFacingError, publicActionError } from "@/lib/action-error";
+import { loadNotdienstDays } from "@/lib/notdienst-planning";
 
 // =====================================================================
 // /dashboard/notdienst · Server Actions
@@ -64,90 +66,60 @@ export async function saveNotdienstAvailabilities(payloadRaw: {
     return { error: "Dein Account ist noch keinem Haushalt zugeordnet." };
   }
 
-  // ── 2. Validierung (Soll-Tage) ─────────────────────────────────────
-  const kita = await prisma.kita.findUniqueOrThrow({
+  try {
+    await serializableTransaction(async (tx) => {
+      const [kita, children, workingDays] = await Promise.all([
+        tx.kita.findUniqueOrThrow({
           where: { id: kitaId },
           select: { notdienstMinPerChildPerMonth: true },
-  });
-
-  const requiredTotal = childrenIds.length * kita.notdienstMinPerChildPerMonth;
-  if (dates.length < requiredTotal) {
-    return {
-      error: `Bitte wähle mindestens ${requiredTotal} Tage aus.`,
-    };
-  }
-
-  // Sicherstellen, dass alle Kinder zum Haushalt des angemeldeten Users gehören.
-  const validChildren = await prisma.child.findMany({
-    where: {
-      id: { in: childrenIds },
-      kitaId,
-      familyId: session.user.familyId,
-    },
+        }),
+        tx.child.findMany({
+          where: { kitaId, familyId: session.user.familyId!, active: true },
           select: { id: true },
-  });
-
-  if (validChildren.length !== childrenIds.length) {
-    return { error: "Ungültige Kinder-Zuordnung erkannt." };
+          orderBy: { id: "asc" },
+        }),
+        loadNotdienstDays(tx, kitaId, targetYear, targetMonth),
+      ]);
+      const suppliedIds = new Set(childrenIds);
+      if (!children.length || suppliedIds.size !== childrenIds.length ||
+          suppliedIds.size !== children.length || !children.every((child) => suppliedIds.has(child.id))) {
+        throw new UserFacingError("Bitte lade die Seite neu und wähle die Termine für alle aktiven Kinder deines Haushalts aus.");
       }
-
-  // Termine in Date-Objekte wandeln und sortieren
-  const parsedDates = dates.map(dateKeyToUtcDate);
-  const hasOutsideTargetMonth = parsedDates.some(
-    (date) =>
-      date.getUTCFullYear() !== targetYear ||
-      date.getUTCMonth() !== targetMonth - 1,
-  );
-  if (hasOutsideTargetMonth) {
-    return { error: "Bitte wähle Termine im Zielmonat aus." };
+      const validDates = new Set(workingDays.map(formatUtcDateKey));
+      if (dates.some((date) => !validDates.has(date))) {
+        throw new UserFacingError("Bitte wähle nur geöffnete Werktage im Zielmonat aus. Wochenenden und Schließtage sind nicht möglich.");
       }
-
-  // Round-Robin Zuweisung
-  const inserts: {
-    kitaId: string;
-    childId: string;
-    userId: string;
-    date: Date;
-  }[] = [];
-
-  for (let i = 0; i < parsedDates.length; i++) {
-    const childId = validChildren[i % validChildren.length].id;
-    inserts.push({
-      kitaId,
-      childId,
-      userId: session.user.id,
-      date: parsedDates[i],
-    });
+      const requiredTotal = children.length * kita.notdienstMinPerChildPerMonth;
+      if (dates.length < requiredTotal) {
+        throw new UserFacingError(`Bitte wähle mindestens ${requiredTotal} Tage aus.`);
       }
-
-  // ── 3. Datenbank-Transaktion ───────────────────────────────────────
-  try {
-    await prisma.$transaction(async (tx) => {
-      // a) Alle bestehenden Haushaltseinträge im Zielmonat für diese Kinder löschen
+      const activeIds = children.map((child) => child.id);
       await tx.notdienstAvailability.deleteMany({
         where: {
           kitaId,
-          childId: { in: childrenIds },
+          child: { kitaId, familyId: session.user.familyId! },
           date: {
             gte: new Date(Date.UTC(targetYear, targetMonth - 1, 1)),
             lt: new Date(Date.UTC(targetYear, targetMonth, 1)),
           },
         },
       });
-
-      // b) Neue Einträge setzen
-      if (inserts.length > 0) {
       await tx.notdienstAvailability.createMany({
-          data: inserts,
-          skipDuplicates: true,
+        data: dates.map((date, index) => ({
+          kitaId,
+          childId: activeIds[index % activeIds.length],
+          userId: session.user.id,
+          date: dateKeyToUtcDate(date),
+        })),
       });
-      }
     });
 
     revalidatePath("/dashboard/notdienst");
+    revalidatePath("/dashboard/notdienst/plan");
+    revalidatePath("/dashboard");
     return { success: true, dates };
   } catch (error) {
-    console.error("Fehler beim Speichern der Notdienste:", error);
-    return { error: "Ein Fehler ist aufgetreten beim Speichern der Termine." };
+    if (!(error instanceof UserFacingError)) console.error("Fehler beim Speichern der Notdienste:", error);
+    return { error: publicActionError(error, "Ein Fehler ist aufgetreten beim Speichern der Termine.") };
   }
 }

src/app/dashboard/notdienst/notdienst-form.tsx

@@ -26,7 +26,8 @@ import { de } from "date-fns/locale";
 import { toast } from "sonner";
 
 import { cn } from "@/lib/utils";
-import { formatDateKey, getWorkingDaysOfMonth } from "@/lib/date-utils";
+import { formatDateKey, formatUtcDateKey } from "@/lib/date-utils";
+import { getNotdienstDays } from "@/lib/notdienst-days";
 import { saveNotdienstAvailabilities } from "./actions";
 
 export const notdienstEventCategories = {
@@ -100,23 +101,21 @@ export function NotdienstForm({
 }: NotdienstFormProps) {
   const router = useRouter();
   // Lokaler State für die Auswahl. Ein Datum liegt als stabiler yyyy-MM-dd-Schlüssel vor.
-  const [selectedDates, setSelectedDates] = useState<Set<string>>(
+  const [selection, setSelectedDates] = useState<Set<string>>(
     new Set(initialSelectedDates),
   );
   const [isPending, startTransition] = useTransition();
 
-  const closureDateKeys = useMemo(
-    () => getClosureDateKeys(calendarItems),
-    [calendarItems],
+  const selectableDateKeys = useMemo(
+    () => new Set(getNotdienstDays(targetYear, targetMonth,
+      calendarItems.filter((item) => item.category === "closure" || item.category === "team"),
+    ).map(formatUtcDateKey)),
+    [calendarItems, targetMonth, targetYear],
   );
-  const selectableDateKeys = useMemo(() => {
-    const workingDays = getWorkingDaysOfMonth(targetYear, targetMonth);
-    return new Set(
-      workingDays
-        .map(formatDateKey)
-        .filter((dateKey) => !closureDateKeys.has(dateKey)),
+  const selectedDates = useMemo(
+    () => new Set(Array.from(selection).filter((key) => selectableDateKeys.has(key))),
+    [selection, selectableDateKeys],
   );
-  }, [closureDateKeys, targetMonth, targetYear]);
   const monthStart = startOfMonth(new Date(targetYear, targetMonth - 1));
   const selectedCount = selectedDates.size;
   const hasMinimumRequirement = requiredDaysTotal > 0;
@@ -375,12 +374,9 @@ export function NotdienstCalendar({
           const isInTargetMonth = isSameMonth(day, visibleMonthStart);
           const isSelected = selected.has(dateKey);
           const dayEvents = getCalendarItemsForDay(events, day);
-          const hasClosure = dayEvents.some(
-            (event) => event.category === "closure",
-          );
-          const isSelectable =
-            isInTargetMonth && selectableDateKeys.has(dateKey) && !hasClosure;
           const isWeekend = day.getDay() === 0 || day.getDay() === 6;
+          const hasClosure = isInTargetMonth && !isWeekend && !selectableDateKeys.has(dateKey);
+          const isSelectable = isInTargetMonth && selectableDateKeys.has(dateKey);
 
           return (
             <CalendarTile
@@ -603,25 +599,6 @@ function getCalendarItemsForDay(
   });
 }
 
-function getClosureDateKeys(items: NotdienstCalendarItem[]) {
-  const closureKeys = new Set<string>();
-
-  for (const item of items) {
-    if (item.category !== "closure") continue;
-
-    const days = eachDayOfInterval({
-      start: startOfDay(item.startDate),
-      end: startOfDay(item.endDate),
-    });
-
-    for (const day of days) {
-      closureKeys.add(formatDateKey(day));
-    }
-  }
-
-  return closureKeys;
-}
-
 function formatEventDate(event: NotdienstCalendarItem) {
   const date = format(event.startDate, "EEEE, d. MMMM yyyy", { locale: de });
   return event.allDay

src/app/dashboard/notdienst/page.tsx

@@ -5,7 +5,8 @@ import { Manrope } from "next/font/google";
 
 import { requireRole } from "@/lib/auth-utils";
 import { prisma } from "@/lib/prisma";
-import { formatDateKey, getTargetMonthData } from "@/lib/date-utils";
+import { formatUtcDateKey, getTargetMonthData } from "@/lib/date-utils";
+import { getNotdienstDays } from "@/lib/notdienst-days";
 import { Button } from "@/components/ui/button";
 import { NotdienstEntry } from "./notdienst-entry";
 
@@ -77,7 +78,7 @@ export default async function NotdienstPage() {
               kitaId,
               status: TerminStatus.CONFIRMED,
               startDate: { lt: targetMonthEnd },
-              endDate: { gte: targetMonthStart },
+              endDate: { gte: new Date(targetMonthStart.getTime() - 86400000) },
             },
             select: {
               id: true,
@@ -93,7 +94,10 @@ export default async function NotdienstPage() {
         ])
       : [[], []];
 
-  const selectedDates = availabilities.map((a) => formatDateKey(a.date));
+  const validDateKeys = new Set(getNotdienstDays(targetYear, targetMonth,
+    termine.filter((termin) => termin.type === TerminType.SCHLIESSTAG || termin.type === TerminType.TEAMTAG),
+  ).map(formatUtcDateKey));
+  const selectedDates = availabilities.map((a) => formatUtcDateKey(a.date)).filter((key) => validDateKeys.has(key));
 
   return (
     <div className={`${manrope.className} mx-auto max-w-7xl px-4 py-8 sm:px-8`}>

src/app/dashboard/notdienst/plan/_components/email-status-card.tsx

@@ -0,0 +1,149 @@
+"use client";
+import { useTransition } from "react";
+import { useRouter } from "next/navigation";
+import { toast } from "sonner";
+import { Button } from "@/components/ui/button";
+import { Card } from "@/components/ui/card";
+import type { NotdienstEmailStatus } from "@/lib/notdienst-notifications";
+import {
+  retryNotdienstEmailsAction,
+  sendNotdienstRemindersAction,
+} from "../actions";
+
+export function EmailStatusCard({
+  status,
+  year,
+  month,
+  remindersOpen,
+  daysBefore,
+  jobConfigured,
+}: {
+  status: NotdienstEmailStatus;
+  year: number;
+  month: number;
+  remindersOpen: boolean;
+  daysBefore: number;
+  jobConfigured: boolean;
+}) {
+  const router = useRouter();
+  const [pending, startTransition] = useTransition();
+  const run = (retry: boolean) =>
+    startTransition(async () => {
+      const result = retry
+        ? await retryNotdienstEmailsAction(year, month)
+        : await sendNotdienstRemindersAction(year, month);
+      if (result.error) toast.error(result.error);
+      else if ("failed" in result && result.failed)
+        toast.warning(
+          "Einige E-Mails sind noch nicht versendet. Der nächste Versuch erfolgt automatisch oder über diesen Button.",
+        );
+      else if ("sent" in result)
+        toast.success(`${result.sent} E-Mails versendet.`);
+      router.refresh();
+    });
+  const labels = {
+    sent: "Versendet",
+    pending: "Wartet auf Versand",
+    failed: "Versand fehlgeschlagen",
+    skipped: "Nicht mehr erforderlich",
+  };
+  return (
+    <Card className="mb-5 print:hidden p-5">
+      <div className="flex flex-wrap items-start justify-between gap-3">
+        <div>
+          <h2 className="text-base font-medium text-[var(--ink)]">
+            E-Mail-Versand
+          </h2>
+          <p className="mt-1 text-sm text-[var(--ink-soft)]">
+            {daysBefore
+              ? `Automatische Erinnerung ab dem ${Math.max(1, 26 - daysBefore)}. um 9 Uhr. Eintragsfrist: der 26.`
+              : "Automatische Erinnerungen sind ausgeschaltet."}
+          </p>
+          {!jobConfigured ? (
+            <p className="mt-1 text-xs text-[var(--warn)]">
+              Der Hintergrundversand ist noch nicht konfiguriert. Offene E-Mails
+              können hier manuell gesendet werden.
+            </p>
+          ) : null}
+        </div>
+        <div className="flex flex-wrap gap-2">
+          {remindersOpen ? (
+            <Button
+              variant="ghost"
+              size="sm"
+              disabled={pending}
+              onClick={() => run(false)}
+            >
+              An fehlende Verfügbarkeiten erinnern
+            </Button>
+          ) : null}
+          {status.failed + status.pending > 0 ? (
+            <Button size="sm" disabled={pending} onClick={() => run(true)}>
+              Offene E-Mails erneut senden
+            </Button>
+          ) : null}
+          <Button
+            variant="ghost"
+            size="sm"
+            disabled={pending}
+            onClick={() => router.refresh()}
+          >
+            Aktualisieren
+          </Button>
+        </div>
+      </div>
+      <p className="mt-3 text-sm text-[var(--ink-soft)]">
+        {status.sent} versendet · {status.pending} ausstehend · {status.failed}{" "}
+        fehlgeschlagen · {status.skipped} nicht mehr erforderlich
+      </p>
+      {status.entries.length ? (
+        <details className="mt-3 text-sm">
+          <summary className="cursor-pointer font-medium text-[var(--accent-deep)]">
+            Versanddetails ansehen
+          </summary>
+          <ul className="mt-3 max-h-64 overflow-y-auto divide-y divide-[var(--hairline-soft)]">
+            {status.entries.map((entry) => (
+              <li
+                key={entry.id}
+                className="flex flex-wrap justify-between gap-2 py-2"
+              >
+                <div>
+                  <p>
+                    {entry.name} · {entry.familyName}
+                  </p>
+                  <p className="text-xs text-[var(--ink-muted)]">
+                    {entry.kind === "REMINDER"
+                      ? "Verfügbarkeitserinnerung"
+                      : "Planveröffentlichung"}
+                  </p>
+                  {entry.error ? (
+                    <p className="mt-1 text-xs text-[var(--danger)]">
+                      {entry.error}
+                    </p>
+                  ) : null}
+                </div>
+                <span
+                  className={
+                    entry.status === "failed"
+                      ? "text-[var(--danger)]"
+                      : "text-[var(--ink-soft)]"
+                  }
+                >
+                  {labels[entry.status]}
+                </span>
+              </li>
+            ))}
+          </ul>
+        </details>
+      ) : (
+        <p className="mt-2 text-xs text-[var(--ink-muted)]">
+          Für diesen Monat wurden noch keine E-Mails vorbereitet.
+        </p>
+      )}
+      <p className="mt-3 text-xs text-[var(--ink-muted)]">
+        Versendet bedeutet: vom Maildienst angenommen. Die tatsächliche
+        Zustellung ins Postfach kann hier nicht bestätigt werden.
+      </p>
+    </Card>
+  );
+}

src/app/dashboard/notdienst/plan/_components/settings-modal.tsx

@@ -35,8 +35,8 @@ export function SettingsModal({
   const handleSubmit = (event: FormEvent<HTMLFormElement>) => {
     event.preventDefault();
 
-    if (minPerChild < 0 || reminderDays < 0) {
-      toast.error("Werte dürfen nicht negativ sein.");
+    if (!Number.isInteger(minPerChild) || minPerChild < 1 || minPerChild > 31 || !Number.isInteger(reminderDays) || reminderDays < 0 || reminderDays > 31) {
+      toast.error("Bitte ein Soll von 1 bis 31 und eine Erinnerungsfrist von 0 bis 31 Tagen eingeben.");
       return;
     }
 
@@ -74,25 +74,26 @@ export function SettingsModal({
           <div className="grid gap-4 py-4">
             <div className="grid gap-2">
               <Label htmlFor="minPerChild">
-                Mindesteinteilungen pro Kind/Monat
+                Verfügbarkeitstage pro Kind/Monat
               </Label>
               <Input
                 id="minPerChild"
                 name="minPerChild"
                 type="number"
-                min="0"
+                min="1"
+                max="31"
                 required
                 value={minPerChild}
                 onChange={(e) => setMinPerChild(parseInt(e.target.value, 10))}
               />
               <p className="text-xs text-[var(--ink-muted)]">
-                Bestimmt das Richtmaß der automatischen Verteilung für Kinder im jeweiligen Monat.
+                So viele unterschiedliche Tage müssen Eltern je aktivem Kind als Verfügbarkeit eintragen.
               </p>
             </div>
 
             <div className="grid gap-2">
               <Label htmlFor="reminderDays">
-                Erinnerungsfrist (Tage vor Monatsende)
+                Erinnerung (Tage vor Eintragsfrist)
               </Label>
               <Input
                 id="reminderDays"
@@ -100,11 +101,12 @@ export function SettingsModal({
                 type="number"
                 min="0"
                 required
+                max="31"
                 value={reminderDays}
                 onChange={(e) => setReminderDays(parseInt(e.target.value, 10))}
               />
               <p className="text-xs text-[var(--ink-muted)]">
-                Frist, nach der Eltern automatisch per Mail an offene Verfügbarkeiten erinnert werden.
+                Die Eintragsfrist endet am 26. Bei 7 Tagen erfolgt die Erinnerung ab dem 19. um 9 Uhr. 0 deaktiviert automatische Erinnerungen.
               </p>
             </div>
           </div>

src/app/dashboard/notdienst/plan/actions.ts

@@ -11,9 +11,12 @@ import { de } from "date-fns/locale";
 
 import { requireRole } from "@/lib/auth-utils";
 import { prisma } from "@/lib/prisma";
-import { getTargetMonthData, getWorkingDaysOfMonth } from "@/lib/date-utils";
-import { getAppEmailConfigError, sendAppEmail } from "@/lib/mail";
-import { NotdienstAvailabilityReminderEmail } from "@/emails/NotdienstAvailabilityReminderEmail";
+import { getTargetMonthData } from "@/lib/date-utils";
+import { loadNotdienstDays } from "@/lib/notdienst-planning";
+import { todayKey } from "@/lib/alarms/format";
+import { serializableTransaction } from "@/lib/transaction";
+import { queueNotdienstPublication, queueNotdienstReminders, deliverDueNotdienstEmails } from "@/lib/notdienst-notifications";
+import { sendAppEmail } from "@/lib/mail";
 import { NotdienstAssignmentChangeEmail } from "@/emails/NotdienstAssignmentChangeEmail";
 import { requireAlarmActor } from "@/lib/alarms/auth";
 import {
@@ -42,93 +45,44 @@ export async function generatePlanAction(year?: number, month?: number) {
 
   if (!validPlanMonth(targetYear, targetMonth)) return { error: "Ungültiger Planungsmonat." };
 
-  // Prüfen, ob schon ein Plan existiert
-  const existingPlan = await prisma.notdienstPlan.findUnique({
-    where: {
-      kitaId_year_month: { kitaId, year: targetYear, month: targetMonth },
-    },
+  try {
+    await serializableTransaction(async (tx) => {
+      const existingPlan = await tx.notdienstPlan.findUnique({
+        where: { kitaId_year_month: { kitaId, year: targetYear, month: targetMonth } },
       });
+      if (existingPlan) throw new UserFacingError("Ein Plan für diesen Monat existiert bereits.");
 
-  if (existingPlan) {
-    return { error: "Ein Plan für diesen Monat existiert bereits." };
-  }
-
-  // 1. Alle Verfügbarkeiten der Eltern für diesen Monat holen
-  const availabilities = await prisma.notdienstAvailability.findMany({
+      const [availabilities, workingDays] = await Promise.all([
+        tx.notdienstAvailability.findMany({
           where: {
             kitaId,
+            child: { kitaId, active: true },
             date: {
               gte: new Date(Date.UTC(targetYear, targetMonth - 1, 1)),
               lt: new Date(Date.UTC(targetYear, targetMonth, 1)),
             },
           },
           include: { child: { select: { familyId: true } } },
-  });
-
-  // 2. Werktage holen
-  const workingDays = getWorkingDaysOfMonth(targetYear, targetMonth);
-
-  // 3. Algorithmus: Wir verteilen die Slots
-  // Counter für "Gerechtigkeit": wie oft wurde diese Familie schon eingeteilt?
-  const familyUsageCount: Record<string, number> = {};
-
-  const assignmentsToCreate: { childId: string; date: Date }[] = [];
-
+        }),
+        loadNotdienstDays(tx, kitaId, targetYear, targetMonth),
+      ]);
+      const familyUsageCount = new Map<string, number>();
+      const assignments: { childId: string; date: Date }[] = [];
       for (const day of workingDays) {
-    // Alle Verfügbarkeiten für diesen spezifischen Tag
-    const availForDay = availabilities.filter(
-      (a) => a.date.getTime() === day.getTime(),
-    );
-
-    if (availForDay.length === 0) {
-      // Niemand verfügbar -> Bleibt leer ("Unbesetzt")
-      continue;
+        const candidates = availabilities.filter((a) => a.date.getTime() === day.getTime());
+        if (!candidates.length) continue;
+        const minUsage = Math.min(...candidates.map((a) => familyUsageCount.get(a.child.familyId) ?? 0));
+        const leastUsed = candidates.filter((a) => (familyUsageCount.get(a.child.familyId) ?? 0) === minUsage);
+        const selected = leastUsed[Math.floor(Math.random() * leastUsed.length)];
+        assignments.push({ childId: selected.childId, date: day });
+        familyUsageCount.set(selected.child.familyId, minUsage + 1);
       }
-
-    // Finde die Familie, die am wenigsten oft dran war
-    // Zufall einbauen bei Gleichstand
-    const sorted = availForDay.sort((a, b) => {
-      const countA = familyUsageCount[a.child.familyId] || 0;
-      const countB = familyUsageCount[b.child.familyId] || 0;
-      if (countA === countB) {
-        return Math.random() - 0.5; // Zufallsmischung
-      }
-      return countA - countB;
-    });
-
-    const selected = sorted[0];
-
-    assignmentsToCreate.push({
-      childId: selected.childId,
-      date: day,
-    });
-
-    // Usage-Counter erhöhen
-    familyUsageCount[selected.child.familyId] =
-      (familyUsageCount[selected.child.familyId] || 0) + 1;
-  }
-
-  // 4. In der DB speichern
-  try {
-    await prisma.$transaction(async (tx) => {
       const plan = await tx.notdienstPlan.create({
-        data: {
-          kitaId,
-          year: targetYear,
-          month: targetMonth,
-          status: NotdienstPlanStatus.DRAFT,
-          createdById: session.user.id,
-        },
+        data: { kitaId, year: targetYear, month: targetMonth, status: NotdienstPlanStatus.DRAFT, createdById: session.user.id },
       });
-
-      if (assignmentsToCreate.length > 0) {
+      if (assignments.length) {
         await tx.notdienstAssignment.createMany({
-          data: assignmentsToCreate.map((a) => ({
-            kitaId,
-            planId: plan.id,
-            childId: a.childId,
-            date: a.date,
-          })),
+          data: assignments.map((a) => ({ ...a, kitaId, planId: plan.id })),
         });
       }
     });
@@ -137,7 +91,7 @@ export async function generatePlanAction(year?: number, month?: number) {
     return { success: true };
   } catch (error) {
     console.error(error);
-    return { error: "Fehler bei der Generierung des Plans." };
+    return { error: publicActionError(error, "Fehler bei der Generierung des Plans.") };
   }
 }
 
@@ -145,17 +99,35 @@ export async function publishPlanAction(planId: string) {
   const session = await requireRole([UserRole.ADMIN, UserRole.KOORDINATOR]);
   const kitaId = session.user.kitaId!;
 
-  await prisma.notdienstPlan.update({
+  try {
+    await serializableTransaction(async (tx) => {
+      const plan = await tx.notdienstPlan.findUnique({
         where: { id: planId, kitaId },
-    data: {
-      status: NotdienstPlanStatus.PUBLISHED,
-      publishedAt: new Date(),
-    },
+        include: { assignments: { include: { child: { select: { active: true } } } } },
+      });
+      if (!plan) throw new UserFacingError("Plan nicht gefunden.");
+      if (plan.status === NotdienstPlanStatus.PUBLISHED) return;
+      if (plan.status !== NotdienstPlanStatus.DRAFT) throw new UserFacingError("Nur Entwürfe können veröffentlicht werden.");
+      const days = await loadNotdienstDays(tx, kitaId, plan.year, plan.month);
+      const validDates = new Set(days.map((day) => day.getTime()));
+      if (plan.assignments.some((a) => !validDates.has(a.date.getTime()) || !a.child.active)) {
+        throw new UserFacingError("Der Entwurf enthält Einteilungen an geschlossenen Tagen, außerhalb des Planungsmonats oder für inaktive Kinder. Bitte zuerst korrigieren.");
+      }
+      await tx.notdienstPlan.update({
+        where: { id: planId, kitaId },
+        data: { status: NotdienstPlanStatus.PUBLISHED, publishedAt: new Date() },
+      });
+      await queueNotdienstPublication(tx, kitaId, planId, plan.year, plan.month);
     });
-
     revalidatePath("/dashboard/notdienst/plan");
     revalidatePath("/dashboard/notdienst");
-  return { success: true };
+    revalidatePath("/dashboard/kalender");
+    const delivery = await deliverDueNotdienstEmails({ kitaId, planId }).catch(() => ({ sent: 0, failed: 0, skipped: 0, deferred: true }));
+    revalidatePath("/dashboard/notdienst/plan");
+    return { success: true, ...delivery };
+  } catch (error) {
+    return { error: publicActionError(error, "Der Plan konnte nicht veröffentlicht werden.") };
+  }
 }
 
 export async function updateAssignmentAction(
@@ -189,11 +161,19 @@ export async function updateAssignmentAction(
           throw new UserFacingError("Plan kann nicht bearbeitet werden.");
         }
 
+        if (newChildId && (parsedDate.getUTCFullYear() !== plan.year || parsedDate.getUTCMonth() + 1 !== plan.month)) {
+          throw new UserFacingError("Das Datum gehört nicht zum Planungsmonat.");
+        }
+        // Clearing obsolete entries remains possible after a new closure.
+        if (newChildId) {
+          const days = await loadNotdienstDays(tx, kitaId, plan.year, plan.month);
+          if (!days.some((day) => day.getTime() === parsedDate.getTime())) {
+            throw new UserFacingError("An Wochenenden und Schließtagen kann kein Notdienst eingeteilt werden.");
+          }
+        }
+
         if (isPublished) {
-          const today = new Date();
-          const todayUtc = new Date(
-            Date.UTC(today.getFullYear(), today.getMonth(), today.getDate()),
-          );
+          const todayUtc = new Date(`${todayKey()}T00:00:00Z`);
           if (parsedDate < todayUtc) {
             throw new UserFacingError(
               "Vergangene Notdienste können nicht geändert werden.",
@@ -202,7 +182,7 @@ export async function updateAssignmentAction(
         }
 
         const existingAssignment = await tx.notdienstAssignment.findFirst({
-          where: { planId, date: parsedDate },
+          where: { kitaId, planId, date: parsedDate },
           include: {
             child: {
               include: {
@@ -431,118 +411,33 @@ export async function updateKitaNotdienstSettingsAction(
   }
 }
 
-export async function sendNotdienstRemindersAction(
-  year: number,
-  month: number,
-) {
+export async function sendNotdienstRemindersAction(year: number, month: number) {
   const session = await requireRole([UserRole.ADMIN, UserRole.KOORDINATOR]);
-  const kitaId = session.user.kitaId;
-  if (!kitaId) {
-    return { error: "Kein Mandant zugeordnet." };
-  }
-
+  const kitaId = session.user.kitaId!;
   if (!validPlanMonth(year, month)) return { error: "Ungültiger Planungsmonat." };
   if (!(await rateLimit(`notdienst-reminders:${kitaId}`, 3, 3600)).allowed) return { error: "Zu viele Erinnerungen. Bitte später erneut versuchen." };
-  const mailConfigError = getAppEmailConfigError();
-  if (mailConfigError) {
-    return { error: mailConfigError };
-  }
-
   try {
-    // 1. Get Kita Name
-    const kita = await prisma.kita.findUnique({
-      where: { id: kitaId },
-      select: { name: true },
-    });
-    if (!kita) {
-      return { error: "Kita nicht gefunden." };
-    }
-
-    // 2. Fetch all families in this Kita with at least one active child and retrieve parents
-    const families = await prisma.family.findMany({
-      where: {
-        kitaId,
-        children: { some: { active: true } },
-      },
-      include: {
-        users: {
-          where: { role: UserRole.ELTERN, emailVerifiedAt: { not: null }, disabledAt: null, privacyPolicyAcceptedAt: { not: null } },
-        },
-      },
-    });
-
-    // 3. For target month, find availability entries
-    const monthStart = new Date(year, month - 1, 1);
-    const monthEnd = new Date(year, month, 1);
-
-    const respondedFamilies = await prisma.notdienstAvailability.findMany({
-      where: {
-        kitaId,
-        date: {
-          gte: monthStart,
-          lt: monthEnd,
-        },
-      },
-      select: {
-        child: {
-          select: {
-            familyId: true,
-          },
-        },
-      },
-    });
-
-    const respondedFamilyIds = new Set(
-      respondedFamilies.map((a) => a.child.familyId),
-    );
-
-    // 4. Find open families (not responded yet)
-    const openFamilies = families.filter((f) => !respondedFamilyIds.has(f.id));
-
-    if (openFamilies.length === 0) {
-      return { success: true, count: 0 };
-    }
-
-    // 5. Build emails list and send
-    const monthDate = new Date(year, month - 1, 1);
-    const monthLabel = format(monthDate, "MMMM yyyy", { locale: de });
-    const BASE_URL =
-      process.env.NEXTAUTH_URL ??
-      process.env.AUTH_URL ??
-      "http://localhost:3000";
-    const link = `${BASE_URL}/dashboard/notdienst`;
-
-    let sentCount = 0;
-    for (const family of openFamilies) {
-      for (const parent of family.users) {
-        if (!parent.email) continue;
-
-        const result = await sendAppEmail({
-          to: parent.email,
-          subject: `Erinnerung: Bitte Verfügbarkeiten für den Notdienst ${monthLabel} eintragen`,
-          react: createElement(NotdienstAvailabilityReminderEmail, {
-            parentName: `${parent.firstName} ${parent.lastName}`,
-            kitaName: kita.name,
-            monthLabel,
-            link,
-          }),
-        });
-
-        if (result.success) {
-          sentCount++;
-        } else {
-          console.error(
-            `E-Mail konnte nicht an ${parent.email} gesendet werden:`,
-            result.error,
-          );
-        }
-      }
-    }
-
-    return { success: true, count: sentCount };
+    const queued = await queueNotdienstReminders(kitaId, year, month);
+    const delivery = await deliverDueNotdienstEmails({ kitaId, year, month }).catch(() => ({ sent: 0, failed: 0, skipped: 0, deferred: true }));
+    revalidatePath("/dashboard/notdienst/plan");
+    return { success: true, queued, count: delivery.sent, ...delivery };
   } catch (error) {
-    console.error("Fehler beim Versenden der Erinnerungen:", error);
-    return { error: "Fehler beim Versenden der Erinnerungen." };
+    return { error: publicActionError(error, "Die Erinnerungen konnten nicht vorbereitet werden.") };
+  }
+}
+
+export async function retryNotdienstEmailsAction(year: number, month: number) {
+  const session = await requireRole([UserRole.ADMIN, UserRole.KOORDINATOR]);
+  const kitaId = session.user.kitaId!;
+  if (!validPlanMonth(year, month)) return { error: "Ungültiger Planungsmonat." };
+  if (!(await rateLimit(`notdienst-mail-retry:${kitaId}`, 3, 3600)).allowed) return { error: "Bitte warte vor einem weiteren Versandversuch." };
+  try {
+    await prisma.notdienstEmail.updateMany({ where: { kitaId, year, month, failed: true, sentAt: null, skippedAt: null }, data: { nextAttemptAt: new Date() } });
+    const delivery = await deliverDueNotdienstEmails({ kitaId, year, month });
+    revalidatePath("/dashboard/notdienst/plan");
+    return { success: true, ...delivery };
+  } catch {
+    return { error: "Der Versand bleibt gespeichert und wird erneut versucht." };
   }
 }
 

src/app/dashboard/notdienst/plan/page.tsx

@@ -1,11 +1,13 @@
 import Link from "next/link";
 import { addMonths, getYear, getMonth, format } from "date-fns";
 import { de } from "date-fns/locale";
-import { TerminType } from "@prisma/client";
 import { ChevronLeft, ChevronRight } from "lucide-react";
 
 import { prisma } from "@/lib/prisma";
-import { getWorkingDaysOfMonth } from "@/lib/date-utils";
+import { formatUtcDateKey, getWorkingDaysOfMonth, getTargetMonthData } from "@/lib/date-utils";
+import { loadNotdienstDays } from "@/lib/notdienst-planning";
+import { getNotdienstEmailStatus } from "@/lib/notdienst-notifications";
+import { EmailStatusCard } from "./_components/email-status-card";
 import { PlanView } from "./plan-view";
 import { SettingsModal } from "./_components/settings-modal";
 import { requireAlarmActor } from "@/lib/alarms/auth";
@@ -23,22 +25,21 @@ export default async function PlanungsZentralePage({
 
   const resolvedSearchParams = await searchParams;
   const now = new Date();
-  const nextMonth = addMonths(now, 1);
+  const defaultTarget = getTargetMonthData(now);
   const targetYear = resolvedSearchParams.year
     ? parseInt(resolvedSearchParams.year, 10)
-    : getYear(nextMonth);
+    : defaultTarget.targetYear;
   const targetMonth = resolvedSearchParams.month
     ? parseInt(resolvedSearchParams.month, 10)
-    : getMonth(nextMonth) + 1;
+    : defaultTarget.targetMonth;
 
   const monthDate = new Date(targetYear, targetMonth - 1, 1);
   const monthName = format(monthDate, "MMMM", { locale: de });
 
-  const workingDays = getWorkingDaysOfMonth(targetYear, targetMonth);
-  const monthStart = new Date(targetYear, targetMonth - 1, 1);
-  const monthEnd = new Date(targetYear, targetMonth, 1);
+  const monthStart = new Date(Date.UTC(targetYear, targetMonth - 1, 1));
+  const monthEnd = new Date(Date.UTC(targetYear, targetMonth, 1));
 
-  const [plan, families, availabilities, closureCount, kita] =
+  const [plan, families, rawAvailabilities, workingDays, kita] =
     await Promise.all([
       prisma.notdienstPlan.findUnique({
         where: {
@@ -80,6 +81,7 @@ export default async function PlanungsZentralePage({
       prisma.notdienstAvailability.findMany({
         where: {
           kitaId,
+          child: { kitaId, active: true },
           date: {
             gte: monthStart,
             lt: monthEnd,
@@ -95,16 +97,7 @@ export default async function PlanungsZentralePage({
         },
         orderBy: { date: "asc" },
       }),
-      prisma.termin.count({
-        where: {
-          kitaId,
-          type: TerminType.SCHLIESSTAG,
-          startDate: {
-            gte: monthStart,
-            lt: monthEnd,
-          },
-        },
-      }),
+      loadNotdienstDays(prisma, kitaId, targetYear, targetMonth),
       prisma.kita.findUniqueOrThrow({
         where: { id: kitaId },
         select: {
@@ -152,6 +145,10 @@ export default async function PlanungsZentralePage({
     };
   });
 
+  const validDateKeys = new Set(workingDays.map(formatUtcDateKey));
+  const availabilities = rawAvailabilities.filter((a) => validDateKeys.has(formatUtcDateKey(a.date)));
+  const closureCount = getWorkingDaysOfMonth(targetYear, targetMonth).length - workingDays.length;
+
   const availabilityDatesByFamily = new Map<string, Set<string>>();
   availabilities.forEach((availability) => {
     const familyId = availability.child.familyId;
@@ -174,11 +171,12 @@ export default async function PlanungsZentralePage({
         }).format(new Date(date)),
       })),
       childCount: family.children.length,
+      requiredDays: family.children.length * kita.notdienstMinPerChildPerMonth,
     };
   });
 
   const respondedFamilies = familyStatuses.filter(
-    (family) => family.selectedDays.length > 0,
+    (family) => family.selectedDays.length >= family.requiredDays,
   ).length;
   const openFamilies = Math.max(familyStatuses.length - respondedFamilies, 0);
   const totalAvailabilitySlots = availabilities.length;
@@ -187,7 +185,13 @@ export default async function PlanungsZentralePage({
     requiredDays > 0 ? totalAvailabilitySlots / requiredDays : 0;
 
   // Wir mappen die Assignments auf die Werktage
-  const daysWithAssignments = workingDays.map((day) => {
+  // Keep obsolete assignments visible so the coordinator can remove them.
+  const displayedDays = new Map(workingDays.map((day) => [formatUtcDateKey(day), day]));
+  for (const assignment of plan?.assignments ?? []) {
+    displayedDays.set(formatUtcDateKey(assignment.date), assignment.date);
+  }
+  const activeChildIds = new Set(allChildren.map((child) => child.id));
+  const daysWithAssignments = Array.from(displayedDays.values()).sort((a, b) => a.getTime() - b.getTime()).map((day) => {
     const assignment = plan?.assignments.find(
       (a) => a.date.getTime() === day.getTime(),
     );
@@ -195,19 +199,25 @@ export default async function PlanungsZentralePage({
       !assignment ||
       (plan?.publishedAt && assignment.createdAt > plan.publishedAt);
 
+    const isInvalid = !validDateKeys.has(formatUtcDateKey(day)) || !!assignment && !activeChildIds.has(assignment.childId);
     return {
       date: day.toISOString(),
+      isInvalid,
       assignmentId: assignment?.id || null,
       childId: assignment?.childId || null,
       isOriginallyUnassigned: !!isOriginallyUnassigned,
       activeAlarmId: assignment?.alarms[0]?.id ?? null,
       canAlarm:
-        !!assignment &&
+        !!assignment && !isInvalid &&
         plan?.status === "PUBLISHED" &&
         day.toISOString().slice(0, 10) >= todayKey(),
     };
   });
 
+  const mailStatus = await getNotdienstEmailStatus(kitaId, targetYear, targetMonth);
+  const target = getTargetMonthData(now);
+  const remindersOpen = !target.isLocked && target.targetYear === targetYear && target.targetMonth === targetMonth && plan?.status !== "PUBLISHED";
+
   return (
     <div className="mx-auto max-w-[1280px] px-11 py-9 pb-16 max-[760px]:px-5">
       <header className="mb-7 flex items-end justify-between gap-8 max-[900px]:items-start max-[900px]:flex-col">
@@ -226,7 +236,7 @@ export default async function PlanungsZentralePage({
           </p>
         </div>
 
-        <div className="print:hidden flex shrink-0 items-center gap-2">
+        <div className="print:hidden flex flex-wrap items-center gap-2">
           <div className="inline-flex overflow-hidden rounded-full border border-[var(--hairline)] bg-[var(--surface)]">
             <Link
               href={`/dashboard/notdienst/plan?year=${getYear(addMonths(monthDate, -1))}&month=${getMonth(addMonths(monthDate, -1)) + 1}`}
@@ -251,8 +261,11 @@ export default async function PlanungsZentralePage({
         </div>
       </header>
 
+      <EmailStatusCard status={mailStatus} year={targetYear} month={targetMonth} remindersOpen={remindersOpen} daysBefore={kita.notdienstReminderDaysBefore} jobConfigured={(process.env.NOTDIENST_JOB_SECRET?.length ?? 0) >= 32} />
+
       <PlanView
         planId={plan?.id}
+        remindersOpen={remindersOpen}
         status={plan?.status}
         days={daysWithAssignments}
         allChildren={allChildren}

src/app/dashboard/notdienst/plan/plan-view.tsx

@@ -37,6 +37,7 @@ import {
 
 interface PlanViewProps {
   planId?: string;
+  remindersOpen: boolean;
   status?: NotdienstPlanStatus;
   days: {
     date: string;
@@ -45,6 +46,7 @@ interface PlanViewProps {
     canAlarm?: boolean;
     childId: string | null;
     isOriginallyUnassigned?: boolean;
+    isInvalid?: boolean;
   }[];
   allChildren: {
     id: string;
@@ -56,6 +58,7 @@ interface PlanViewProps {
     id: string;
     name: string;
     childCount: number;
+    requiredDays: number;
     selectedDays: {
       iso: string;
       label: string;
@@ -75,6 +78,7 @@ interface PlanViewProps {
 
 export function PlanView({
   planId,
+  remindersOpen,
   status,
   days,
   allChildren,
@@ -116,8 +120,9 @@ export function PlanView({
       const result = await publishPlanAction(planId);
       if ("error" in result && result.error) {
         toast.error(result.error as string);
-      } else {
-        toast.success("Plan veröffentlicht! Er ist nun fix.");
+      } else if ("success" in result && result.success) {
+        if (result.failed || ("deferred" in result && result.deferred)) toast.warning("Plan veröffentlicht. Einige E-Mails stehen noch aus – siehe Versandstatus.");
+        else toast.success("Plan veröffentlicht. Die Benachrichtigungen wurden vorbereitet.");
       }
     });
   };
@@ -127,10 +132,9 @@ export function PlanView({
       const result = await sendNotdienstRemindersAction(year, month);
       if ("error" in result && result.error) {
         toast.error(result.error as string);
-      } else if (result.success) {
-        toast.success(
-          `${result.count} Erinnerungs-E-Mail(s) erfolgreich versendet.`,
-        );
+      } else if ("success" in result && result.success) {
+        if (result.failed || ("deferred" in result && result.deferred)) toast.warning(`${result.count} E-Mails versendet. Offene Nachrichten bleiben gespeichert – siehe Versandstatus.`);
+        else toast.success(`${result.count} E-Mails versendet. Bereits heute erinnerte Haushalte erhalten keine zweite Erinnerung.`);
       }
     });
   };
@@ -153,7 +157,7 @@ export function PlanView({
     const valueToSet = newChildId === "empty" ? null : newChildId;
 
     startTransition(async () => {
-      const result = await updateAssignmentAction(planId, date, valueToSet);
+      const result = await updateAssignmentAction(planId, date.slice(0, 10), valueToSet);
       if ("error" in result && result.error) {
         toast.error(result.error as string);
       } else {
@@ -162,7 +166,7 @@ export function PlanView({
     });
   };
 
-  if (!planId && respondedFamilies === 0) {
+  if (!planId && totalAvailabilitySlots === 0) {
     return (
       <Card className="border-dashed">
         <div className="flex min-h-[280px] flex-col items-center justify-center p-8 text-center">
@@ -183,7 +187,7 @@ export function PlanView({
             <Button
               variant="ghost"
               onClick={handleSendReminders}
-              disabled={isPending}
+              disabled={isPending || !remindersOpen}
             >
               {isPending ? (
                 <Loader2 className="h-4 w-4 animate-spin [stroke-width:1.7]" />
@@ -211,7 +215,7 @@ export function PlanView({
                   </h2>
                   <p className="mt-1 text-[13.5px] leading-5 text-[var(--ink-soft)]">
                     {respondedFamilies} von {totalFamilies} Familien haben
-                    geantwortet · noch {openFamilies} offen
+                    vollständig geantwortet · noch {openFamilies} offen
                   </p>
                 </div>
                 <span className="text-sm font-semibold tabular-nums text-[var(--ink-soft)]">
@@ -244,7 +248,7 @@ export function PlanView({
                       {family.childCount === 1 ? "" : "er"}
                     </p>
                   </div>
-                  <FamilyStatusPill selectedDays={family.selectedDays.length} />
+                  <FamilyStatusPill selectedDays={family.selectedDays.length} requiredDays={family.requiredDays} />
                   <div className="pointer-events-none absolute right-6 top-10 z-20 hidden max-w-xs rounded-lg bg-[oklch(0.22_0.015_45)] px-3 py-2 text-xs leading-5 text-white shadow-lg group-hover:block">
                     {family.selectedDays.length > 0
                       ? family.selectedDays.map((day) => day.label).join(" · ")
@@ -258,7 +262,7 @@ export function PlanView({
               <Button
                 variant="ghost"
                 onClick={handleSendReminders}
-                disabled={isPending || openFamilies === 0}
+                disabled={isPending || openFamilies === 0 || !remindersOpen}
               >
                 {isPending ? (
                   <Loader2 className="h-4 w-4 animate-spin [stroke-width:1.7]" />
@@ -315,7 +319,7 @@ export function PlanView({
                 </h3>
                 <p className="mt-1 text-[13.5px] text-[var(--ink-soft)]">
                   Verteilt {requiredDays} Notdiensttage fair auf{" "}
-                  {respondedFamilies} Familien.
+                  die verfügbaren Familien.
                 </p>
                 <details className="mt-3 text-xs text-[var(--ink-soft)]">
                   <summary className="cursor-pointer font-semibold text-[var(--accent-deep)]">
@@ -447,7 +451,7 @@ export function PlanView({
   );
 }
 
-function FamilyStatusPill({ selectedDays }: { selectedDays: number }) {
+function FamilyStatusPill({ selectedDays, requiredDays }: { selectedDays: number; requiredDays: number }) {
   if (selectedDays === 0) {
     return (
       <span className="rounded-full border border-[var(--warn)] bg-[var(--warn-soft)] px-2.5 py-1 text-[11px] font-semibold text-[var(--warn)]">
@@ -457,8 +461,8 @@ function FamilyStatusPill({ selectedDays }: { selectedDays: number }) {
   }
 
   return (
-    <span className="rounded-full border border-[var(--good)] bg-[var(--good-soft)] px-2.5 py-1 text-[11px] font-semibold text-[var(--good)]">
-      {selectedDays} Tage
+    <span className={selectedDays >= requiredDays ? "rounded-full border border-[var(--good)] bg-[var(--good-soft)] px-2.5 py-1 text-[11px] font-semibold text-[var(--good)]" : "rounded-full border border-[var(--warn)] bg-[var(--warn-soft)] px-2.5 py-1 text-[11px] font-semibold text-[var(--warn)]"}>
+      {selectedDays} / {requiredDays} Tage
     </span>
   );
 }
@@ -548,7 +552,7 @@ function PlanPreviewTable({
                 {format(dateObj, "EEEE", { locale: de })}
               </div>
               <div className="text-[var(--ink)]">
-                {assignedChild ? assignedChild.parentName : "Unbesetzt"}
+                {assignedChild ? assignedChild.parentName : day.childId ? "Inaktives Kind" : "Unbesetzt"}
                 {assignedChild && (
                   <span className="ml-1 text-[var(--ink-muted)]">
                     ({assignedChild.name})
@@ -572,8 +576,8 @@ function PlanPreviewTable({
               </div>
               <div className="italic text-[var(--ink-faint)]">Noch offen</div>
               <div>
-                <Badge variant={assignedChild ? "success" : "destructive"}>
-                  {assignedChild ? "Besetzt" : "Offen"}
+                <Badge variant={day.isInvalid ? "warning" : assignedChild ? "success" : "destructive"}>
+                  {day.isInvalid ? "Bitte korrigieren" : assignedChild ? "Besetzt" : "Offen"}
                 </Badge>
               </div>
             </div>
@@ -649,18 +653,24 @@ function ManualAssignmentTable({
                   }
                 >
                   <option value="empty">-- Unbesetzt --</option>
+                  {day.childId && !allChildren.some((child) => child.id === day.childId) ? (
+                    <option value={day.childId} disabled>Inaktives Kind – bitte Einteilung entfernen</option>
+                  ) : null}
                   {allChildren.map((child) => {
                     const famId = child.familyId;
                     const count = famId
                       ? (familyAssignmentCounts.get(famId) ?? 0)
                       : 0;
                     return (
-                      <option key={child.id} value={child.id}>
+                      <option key={child.id} value={child.id} disabled={day.isInvalid}>
                         {child.parentName} ({child.name}) — {count}x
                       </option>
                     );
                   })}
                 </select>
+                {day.isInvalid ? (
+                  <span className="text-xs text-[var(--danger)]">Einteilung nicht mehr gültig – bitte entfernen.</span>
+                ) : null}
                 {!isDraft && (
                   <span className="text-[11px] font-semibold text-[oklch(0.60_0.18_45)] bg-[oklch(0.95_0.02_45)] border border-[oklch(0.85_0.05_45)] px-2 py-0.5 rounded-md shrink-0">
                     Veröffentlicht

src/app/dashboard/page.tsx

@@ -16,6 +16,7 @@ import { UserRole } from "@prisma/client";
 import { requireKitaSession } from "@/lib/auth-utils";
 import { getTargetMonthData } from "@/lib/date-utils";
 import { prisma } from "@/lib/prisma";
+import { absenceDate, absenceToday, canManageKitaAbsences } from "@/lib/absence-policy";
 import { Stat } from "@/components/ui/stat";
 import { OnboardingDialog } from "@/components/OnboardingDialog";
 import { NewsTicker } from "./news-ticker";
@@ -30,8 +31,8 @@ export const metadata = { title: "Übersicht · Kita-Planer" };
 export default async function DashboardPage() {
   const session = await requireKitaSession();
   const now = new Date();
-  const today = new Date(now);
-  today.setHours(0, 0, 0, 0);
+  const todayKey = absenceToday(now);
+  const today = absenceDate(todayKey);
 
   const targetData = getTargetMonthData();
   const targetMonthStart = new Date(
@@ -138,6 +139,7 @@ export default async function DashboardPage() {
             note: true,
             startDate: true,
             endDate: true,
+            updatedAt: true,
             child: {
               select: {
                 firstName: true,
@@ -225,32 +227,27 @@ export default async function DashboardPage() {
           )}
           {canReportAbsences ? (
             <AbsenceCard
-              today={format(today, "yyyy-MM-dd")}
+              today={todayKey}
               childOptions={absenceChildren.map((child) => ({
                 id: child.id,
                 name: `${child.firstName} ${child.lastName}`,
               }))}
-              absences={upcomingAbsences.map((absence) => ({
-                id: absence.id,
-                childName: `${absence.child.firstName} ${absence.child.lastName}`,
-                reason: absence.reason,
-                note: absence.note,
-                startDate: format(absence.startDate, "yyyy-MM-dd"),
-                endDate: format(absence.endDate, "yyyy-MM-dd"),
-              }))}
             />
           ) : null}
         </div>
 
         <aside>
           <UpcomingAbsencesCard
+            today={todayKey}
+            team={canManageKitaAbsences(session.user.role)}
             absences={upcomingAbsences.map((absence) => ({
               id: absence.id,
               childName: `${absence.child.firstName} ${absence.child.lastName}`,
               reason: absence.reason,
               note: absence.note,
-              startDate: format(absence.startDate, "yyyy-MM-dd"),
-              endDate: format(absence.endDate, "yyyy-MM-dd"),
+              startDate: absence.startDate.toISOString().slice(0, 10),
+              endDate: absence.endDate.toISOString().slice(0, 10),
+              updatedAt: absence.updatedAt.toISOString(),
             }))}
           />
         </aside>

src/app/dashboard/profil/actions.ts

@@ -12,6 +12,8 @@ import {
 } from "@/lib/child-birthdate";
 import { serializableTransaction } from "@/lib/transaction";
 import { prisma } from "@/lib/prisma";
+import { assertChildrenRemovable } from "@/lib/notdienst-planning";
+import { UserFacingError, publicActionError } from "@/lib/action-error";
 
 // Telefonnummern: führendes "+" optional, dann Ziffern, Leerzeichen, Bindestriche,
 // Klammern oder Schrägstriche. Mindestens 6 Ziffern damit es plausibel ist.
@@ -268,26 +270,25 @@ export async function deleteMyChild(childId: string) {
   const session = await requireKitaSession();
 
   try {
-    const child = await requireOwnFamilyChild(
-      childId,
-      session.user.familyId,
-      session.user.kitaId,
-    );
-
-    if (!child) {
-      return { error: "Dieses Kind gehört nicht zu deinem Haushalt." };
-    }
-
-    await prisma.child.delete({
-      where: { id: childId, kitaId: session.user.kitaId, familyId: session.user.familyId! },
+    await serializableTransaction(async (tx) => {
+      if (!session.user.familyId) throw new UserFacingError("Dieses Kind gehört nicht zu deinem Haushalt.");
+      const child = await tx.child.findFirst({
+        where: { id: childId, kitaId: session.user.kitaId, familyId: session.user.familyId },
+        select: { id: true },
+      });
+      if (!child) throw new UserFacingError("Dieses Kind gehört nicht zu deinem Haushalt.");
+      await assertChildrenRemovable(tx, session.user.kitaId, session.user.familyId, [childId]);
+      await tx.child.delete({
+        where: { id: childId, kitaId: session.user.kitaId, familyId: session.user.familyId },
+      });
     });
 
     revalidatePath("/dashboard/profil");
     revalidatePath("/dashboard/families");
     return { success: true };
   } catch (error) {
-    console.error("Fehler beim Entfernen des Kindes:", error);
-    return { error: "Das Kind konnte nicht entfernt werden." };
+    if (!(error instanceof UserFacingError)) console.error("Fehler beim Entfernen des Kindes:", error);
+    return { error: publicActionError(error, "Das Kind konnte nicht entfernt werden.") };
   }
 }
 

src/app/invite/[token]/actions.ts

@@ -153,6 +153,10 @@ export async function acceptInviteAction(
           sessionVersion: { increment: 1 } },
       });
       if (activated.count !== 1) throw new Error("INVITE_USED");
+      await tx.invitation.updateMany({
+        where: { token, userId },
+        data: { status: "ACCEPTED", acceptedAt: now, leaseUntil: null },
+      });
     });
   } catch (error) {
     if (error instanceof Error && error.message === "INVITE_USED") return { attempt, values, errors: { _form: ["Dieser Link kann nicht mehr verwendet werden."] } };

src/components/absence-management-actions.tsx

@@ -0,0 +1,252 @@
+"use client";
+
+import { useState, useTransition } from "react";
+import { useRouter } from "next/navigation";
+import { Pencil, Undo2 } from "lucide-react";
+import { AbsenceReason } from "@prisma/client";
+import { toast } from "sonner";
+import { deleteAbsence, updateAbsence } from "@/actions/absences";
+import { absenceDate, canEditOwnAbsence } from "@/lib/absence-policy";
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { Textarea } from "@/components/ui/textarea";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/components/ui/dialog";
+
+export type ManagedAbsence = {
+  id: string;
+  childName: string;
+  startDate: string;
+  endDate: string;
+  reason: AbsenceReason;
+  note: string | null;
+  updatedAt: string;
+};
+
+export function AbsenceManagementActions({
+  absence,
+  today,
+  team = false,
+  onChanged,
+}: {
+  absence: ManagedAbsence;
+  today: string;
+  team?: boolean;
+  onChanged?: () => void;
+}) {
+  const [mode, setMode] = useState<"edit" | "withdraw" | null>(null);
+  const [pending, startTransition] = useTransition();
+  const [error, setError] = useState<string | null>(null);
+  const [startDate, setStartDate] = useState(absence.startDate);
+  const [endDate, setEndDate] = useState(absence.endDate);
+  const router = useRouter();
+  if (!team && !canEditOwnAbsence(absence.startDate, today))
+    return (
+      <p className="mt-2 text-xs text-[var(--ink-muted)]">
+        Bereits begonnene Meldung: Änderungen über die Kita.
+      </p>
+    );
+  const tomorrow = new Date(absenceDate(today).getTime() + 86_400_000)
+    .toISOString()
+    .slice(0, 10);
+  function open(next: "edit" | "withdraw") {
+    setStartDate(absence.startDate);
+    setEndDate(absence.endDate);
+    setError(null);
+    setMode(next);
+  }
+  function submit(data?: FormData) {
+    startTransition(async () => {
+      try {
+        const identity = { id: absence.id, updatedAt: absence.updatedAt };
+        const result =
+          mode === "withdraw"
+            ? await deleteAbsence(identity)
+            : await updateAbsence({
+                ...identity,
+                startDate,
+                endDate,
+                reason: String(data?.get("reason") ?? ""),
+                note: String(data?.get("note") ?? ""),
+              });
+        if (result.error) {
+          setError(result.error);
+          return;
+        }
+        toast.success(
+          mode === "withdraw"
+            ? "Abwesenheitsmeldung zurückgenommen."
+            : "Abwesenheitsmeldung aktualisiert.",
+        );
+        setMode(null);
+        onChanged?.();
+      } catch {
+        setError(
+          "Die Meldung konnte nicht gespeichert werden. Bitte erneut versuchen.",
+        );
+      }
+    });
+  }
+  return (
+    <div className="mt-2 flex flex-wrap gap-2">
+      <Button
+        type="button"
+        variant="outline"
+        size="sm"
+        onClick={() => open("edit")}
+        aria-label={`Abwesenheit bearbeiten: ${absence.childName}`}
+      >
+        <Pencil className="h-3.5 w-3.5" /> Bearbeiten
+      </Button>
+      <Button
+        type="button"
+        variant="ghost"
+        size="sm"
+        onClick={() => open("withdraw")}
+        aria-label={`Abwesenheit zurücknehmen: ${absence.childName}`}
+      >
+        <Undo2 className="h-3.5 w-3.5" /> Zurücknehmen
+      </Button>
+      <Dialog
+        open={mode !== null}
+        onOpenChange={(isOpen) => {
+          if (!isOpen && !pending) setMode(null);
+        }}
+      >
+        <DialogContent>
+          <DialogHeader>
+            <DialogTitle>
+              {mode === "withdraw"
+                ? "Abwesenheit zurücknehmen"
+                : "Abwesenheit bearbeiten"}
+            </DialogTitle>
+            <DialogDescription>
+              {absence.childName}
+              {mode === "withdraw"
+                ? ": Diese Meldung wird aus der Abwesenheitsübersicht entfernt."
+                : ": Passe den Zeitraum, den Grund oder die Bemerkung an."}
+              {!team && mode === "edit"
+                ? " Änderungen sind nur für zukünftige Tage möglich."
+                : ""}
+            </DialogDescription>
+          </DialogHeader>
+          <form
+            onSubmit={(event) => {
+              event.preventDefault();
+              submit(new FormData(event.currentTarget));
+            }}
+          >
+            {mode === "edit" && (
+              <fieldset disabled={pending} className="grid gap-4 py-4">
+                <div className="grid grid-cols-2 gap-4">
+                  <div className="grid gap-2">
+                    <Label htmlFor={`absence-start-${absence.id}`}>Von</Label>
+                    <Input
+                      id={`absence-start-${absence.id}`}
+                      type="date"
+                      required
+                      min={team ? undefined : tomorrow}
+                      value={startDate}
+                      onChange={(event) => {
+                        const value = event.target.value;
+                        setStartDate(value);
+                        if (value > endDate) setEndDate(value);
+                      }}
+                    />
+                  </div>
+                  <div className="grid gap-2">
+                    <Label htmlFor={`absence-end-${absence.id}`}>Bis</Label>
+                    <Input
+                      id={`absence-end-${absence.id}`}
+                      type="date"
+                      required
+                      min={startDate}
+                      value={endDate}
+                      onChange={(event) => setEndDate(event.target.value)}
+                    />
+                  </div>
+                </div>
+                <div className="grid gap-2">
+                  <Label htmlFor={`absence-reason-${absence.id}`}>Grund</Label>
+                  <select
+                    id={`absence-reason-${absence.id}`}
+                    name="reason"
+                    defaultValue={absence.reason}
+                    className="h-10 rounded-lg border border-[var(--hairline)] bg-[var(--surface)] px-3 text-sm"
+                    required
+                  >
+                    <option value={AbsenceReason.ILLNESS}>Krank</option>
+                    <option value={AbsenceReason.VACATION}>Urlaub</option>
+                    <option value={AbsenceReason.OTHER}>Sonstiges</option>
+                  </select>
+                </div>
+                <div className="grid gap-2">
+                  <Label htmlFor={`absence-note-${absence.id}`}>
+                    Bemerkung (optional)
+                  </Label>
+                  <Textarea
+                    id={`absence-note-${absence.id}`}
+                    name="note"
+                    maxLength={500}
+                    defaultValue={absence.note ?? ""}
+                    rows={3}
+                  />
+                </div>
+              </fieldset>
+            )}
+            {error && (
+              <div
+                role="alert"
+                className="my-4 rounded-lg bg-[var(--danger-soft)] p-3 text-sm text-[var(--danger)]"
+              >
+                {error}
+                {error.includes("aktualisieren") && (
+                  <Button
+                    type="button"
+                    variant="ghost"
+                    size="sm"
+                    onClick={() => {
+                      setMode(null);
+                      onChanged?.();
+                      router.refresh();
+                    }}
+                  >
+                    Ansicht aktualisieren
+                  </Button>
+                )}
+              </div>
+            )}
+            <DialogFooter className="mt-4">
+              <Button
+                type="button"
+                variant="ghost"
+                disabled={pending}
+                onClick={() => setMode(null)}
+              >
+                Abbrechen
+              </Button>
+              <Button
+                type="submit"
+                disabled={pending}
+                variant={mode === "withdraw" ? "destructive" : "default"}
+              >
+                {pending
+                  ? "Wird gespeichert…"
+                  : mode === "withdraw"
+                    ? "Meldung zurücknehmen"
+                    : "Änderungen speichern"}
+              </Button>
+            </DialogFooter>
+          </form>
+        </DialogContent>
+      </Dialog>
+    </div>
+  );
+}

src/components/dashboard/sidebar-nav.tsx

@@ -51,13 +51,20 @@ const navItems = [
     icon: Megaphone,
     exact: false,
   },
+  {
+    section: "Heute",
+    href: "/dashboard/abwesenheiten",
+    label: "Meine Abwesenheiten",
+    icon: Stethoscope,
+    exact: true,
+    allowedRoles: [UserRole.ELTERN, UserRole.ADMIN, UserRole.KOORDINATOR],
+  },
   {
     section: "Heute",
     href: "/dashboard/notdienst",
     label: "Notdienst (Eltern)",
     icon: CalendarCheck2,
     exact: true,
-    badge: "4",
     allowedRoles: [UserRole.ADMIN, UserRole.KOORDINATOR, UserRole.ELTERN],
   },
   {
@@ -157,7 +164,7 @@ export function SidebarNav({ role }: { role: UserRole }) {
           <div className="flex flex-col gap-1">
             {visibleItems
               .filter((item) => item.section === section)
-              .map(({ href, label, icon, exact, badge }) => {
+              .map(({ href, label, icon, exact }) => {
                 const isActive = exact
                   ? pathname === href
                   : pathname.startsWith(href);
@@ -168,7 +175,6 @@ export function SidebarNav({ role }: { role: UserRole }) {
                     label={label}
                     icon={icon}
                     active={isActive}
-                    badge={badge}
                   />
                 );
               })}

src/emails/NotdienstAvailabilityReminderEmail.tsx

@@ -17,6 +17,9 @@ type NotdienstAvailabilityReminderEmailProps = {
   kitaName: string;
   monthLabel: string;
   link: string;
+  selectedDays?: number;
+  requiredDays?: number;
+  deadlineLabel?: string;
 };
 
 export function NotdienstAvailabilityReminderEmail({
@@ -24,6 +27,9 @@ export function NotdienstAvailabilityReminderEmail({
   kitaName,
   monthLabel,
   link,
+  selectedDays,
+  requiredDays,
+  deadlineLabel,
 }: NotdienstAvailabilityReminderEmailProps) {
   return (
     <Html lang="de">
@@ -46,6 +52,8 @@ export function NotdienstAvailabilityReminderEmail({
               Bitte trage deine Verfügbarkeiten im Planer ein, damit wir die Tage fair verteilen können.
             </Text>
 
+            {requiredDays !== undefined ? <Text style={styles.text}>Euer Haushalt hat bisher {selectedDays ?? 0} von {requiredDays} benötigten Tagen eingetragen. Bitte ergänzt die Auswahl{deadlineLabel ? ` bis einschließlich ${deadlineLabel}` : ""}.</Text> : null}
+
             <Button href={link} style={styles.button}>
               Verfügbarkeiten eintragen
             </Button>

src/emails/NotdienstPlanPublishedEmail.tsx

@@ -0,0 +1,98 @@
+import {
+  Body,
+  Button,
+  Container,
+  Head,
+  Heading,
+  Html,
+  Preview,
+  Section,
+  Text,
+} from "@react-email/components";
+import { baseBodyStyle, colors, fontStack } from "./_styles";
+
+export function NotdienstPlanPublishedEmail({
+  parentName,
+  kitaName,
+  monthLabel,
+  dateLabels,
+  link,
+}: {
+  parentName: string;
+  kitaName: string;
+  monthLabel: string;
+  dateLabels: string[];
+  link: string;
+}) {
+  return (
+    <Html lang="de">
+      <Head />
+      <Preview>Deine Notdienste für {monthLabel}</Preview>
+      <Body style={baseBodyStyle}>
+        <Container
+          style={{
+            maxWidth: "600px",
+            padding: "32px 20px",
+            fontFamily: fontStack,
+          }}
+        >
+          <Section
+            style={{
+              backgroundColor: colors.cardBg,
+              padding: "28px",
+              borderRadius: "10px",
+              border: `1px solid ${colors.border}`,
+            }}
+          >
+            <Heading style={{ color: colors.textPrimary, fontSize: "26px" }}>
+              Notdienstplan {monthLabel}
+            </Heading>
+            <Text>Hallo {parentName},</Text>
+            <Text>
+              der Notdienstplan von <strong>{kitaName}</strong> ist
+              veröffentlicht. Euer Haushalt ist an folgenden Tagen eingeteilt:
+            </Text>
+            {dateLabels.map((date) => (
+              <Text
+                key={date}
+                style={{
+                  padding: "10px 14px",
+                  backgroundColor: "#f7f5ef",
+                  borderLeft: `4px solid ${colors.brandGreen}`,
+                  fontWeight: 700,
+                }}
+              >
+                {date}
+              </Text>
+            ))}
+            <Text>
+              Bitte merkt euch diese Termine vor. Den aktuellen Plan und
+              mögliche Änderungen findet ihr im Kalender.
+            </Text>
+            <Button
+              href={link}
+              style={{
+                backgroundColor: colors.brandGreen,
+                color: "#ffffff",
+                borderRadius: "6px",
+                padding: "14px 20px",
+                textDecoration: "none",
+              }}
+            >
+              Zum Kalender
+            </Button>
+            <Text
+              style={{
+                color: colors.textMuted,
+                fontSize: "12px",
+                wordBreak: "break-all",
+              }}
+            >
+              {link}
+            </Text>
+          </Section>
+        </Container>
+      </Body>
+    </Html>
+  );
+}

src/lib/absence-policy.ts

@@ -0,0 +1,37 @@
+// Absences are calendar dates stored as UTC dates, independent of the server timezone.
+export function absenceDate(value: string) {
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) throw new Error("Ungültiges Datum.");
+  const date = new Date(`${value}T00:00:00.000Z`);
+  if (Number.isNaN(date.getTime()) || date.toISOString().slice(0, 10) !== value)
+    throw new Error("Ungültiges Datum.");
+  return date;
+}
+
+export function isAbsenceDate(value: string) {
+  try {
+    absenceDate(value);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export function absenceToday(now = new Date()) {
+  const parts = new Intl.DateTimeFormat("en-CA", {
+    timeZone: "Europe/Berlin",
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+  }).formatToParts(now);
+  const part = (type: string) =>
+    parts.find((item) => item.type === type)!.value;
+  return `${part("year")}-${part("month")}-${part("day")}`;
+}
+
+export function canManageKitaAbsences(role: string) {
+  return ["ADMIN", "KOORDINATOR", "ERZIEHER"].includes(role);
+}
+
+export function canEditOwnAbsence(startDate: string, today: string) {
+  return startDate > today;
+}

src/lib/date-utils.ts

@@ -1,35 +1,52 @@
-import {
-  addMonths,
-  getDate,
-  getYear,
-  getMonth,
-  format,
-} from "date-fns";
-import { de } from "date-fns/locale";
+import { format } from "date-fns";
 
 /**
  * Der Notdienst-Plan wird immer für den nächsten Monat erstellt.
  * Nach dem 26. des aktuellen Monats ist der Plan gesperrt.
  */
-const LOCK_DAY = 26;
+export const NOTDIENST_LOCK_DAY = 26;
+export function berlinDateKey(now = new Date()) {
+  return new Intl.DateTimeFormat("sv-SE", {
+    timeZone: "Europe/Berlin",
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+  }).format(now);
+}
 
 export function getTargetMonthData(now = new Date()) {
-  const currentDay = getDate(now);
-  const nextMonthDate = addMonths(now, 1);
-  const targetYear = getYear(nextMonthDate);
-  const targetMonth = getMonth(nextMonthDate) + 1; // 1-12
-
-  // Sperre aktiv, sobald der aktuelle Tag (im aktuellen Monat) > LOCK_DAY ist.
-  const isLocked = currentDay > LOCK_DAY;
-
+  const [year, month, currentDay] = berlinDateKey(now).split("-").map(Number);
+  const targetYear = month === 12 ? year + 1 : year;
+  const targetMonth = month === 12 ? 1 : month + 1;
   return {
     targetYear,
     targetMonth,
-    isLocked,
-    monthName: format(nextMonthDate, "MMMM yyyy", { locale: de }),
+    isLocked: currentDay > NOTDIENST_LOCK_DAY,
+    monthName: new Intl.DateTimeFormat("de-DE", {
+      timeZone: "UTC",
+      year: "numeric",
+      month: "long",
+    }).format(new Date(Date.UTC(targetYear, targetMonth - 1, 1))),
   };
 }
 
+export function isNotdienstReminderDue(daysBefore: number, now = new Date()) {
+  const parts = new Intl.DateTimeFormat("en-GB", {
+    timeZone: "Europe/Berlin",
+    day: "2-digit",
+    hour: "2-digit",
+    hourCycle: "h23",
+  }).formatToParts(now);
+  const day = Number(parts.find((part) => part.type === "day")?.value);
+  const hour = Number(parts.find((part) => part.type === "hour")?.value);
+  return (
+    daysBefore > 0 &&
+    day >= Math.max(1, NOTDIENST_LOCK_DAY - daysBefore) &&
+    day <= NOTDIENST_LOCK_DAY &&
+    hour >= 9
+  );
+}
+
 export function getWorkingDaysOfMonth(year: number, month: number) {
   const start = new Date(Date.UTC(year, month - 1, 1));
   const end = new Date(Date.UTC(year, month, 0)); // last day of month

src/lib/family-invitation-view.ts

@@ -0,0 +1,36 @@
+export type FamilyInvitationView = {
+  status: "active" | "open" | "sending" | "sent" | "failed" | "expired";
+  expiresAt: string | null;
+  sentAt: string | null;
+};
+
+export function familyInvitationView(
+  emailVerifiedAt: Date | null,
+  invitation: {
+    expiresAt: Date;
+    sentAt: Date | null;
+    failed: boolean;
+    leaseUntil: Date | null;
+    status: string;
+  } | null,
+  now = new Date(),
+): FamilyInvitationView {
+  let status: FamilyInvitationView["status"] = "open";
+  if (emailVerifiedAt) status = "active";
+  else if (invitation) {
+    if (
+      invitation.expiresAt <= now ||
+      ["EXPIRED", "REVOKED"].includes(invitation.status)
+    )
+      status = "expired";
+    else if (invitation.leaseUntil && invitation.leaseUntil > now)
+      status = "sending";
+    else if (invitation.failed) status = "failed";
+    else if (invitation.sentAt) status = "sent";
+  }
+  return {
+    status,
+    expiresAt: invitation?.expiresAt.toISOString() ?? null,
+    sentAt: invitation?.sentAt?.toISOString() ?? null,
+  };
+}

src/lib/family-invitations.ts

@@ -0,0 +1,224 @@
+import { hashToken, newToken } from "@/lib/tokens";
+import { createElement } from "react";
+import { InvitationStatus, Prisma } from "@prisma/client";
+
+import { InviteEmail } from "@/emails/InviteEmail";
+import { sendAppEmail } from "@/lib/mail";
+import { prisma } from "@/lib/prisma";
+
+const INVITE_LIFETIME_MS = 7 * 24 * 60 * 60_000;
+
+// The account, activation token and delivery status commit together.
+export async function queueFamilyInvitation(
+  tx: Prisma.TransactionClient,
+  userId: string,
+  invitedById: string,
+) {
+  const user = await tx.user.findUniqueOrThrow({ where: { id: userId } });
+  if (!user.kitaId || !user.familyId || user.emailVerifiedAt || user.passwordHash || user.disabledAt)
+    throw new Error("Dieses Konto benötigt keine Familieneinladung.");
+  const existing = await tx.invitation.findFirst({
+    where: {
+      OR: [{ userId }, { kitaId: user.kitaId, email: user.email }],
+    },
+  });
+  if (existing?.userId && existing.userId !== userId)
+    throw new Error("Die Einladung gehört zu einem anderen Konto.");
+  if (existing?.leaseUntil && existing.leaseUntil > new Date())
+    throw new Error("Eine Einladung wird gerade versendet. Bitte kurz warten.");
+  const token = newToken();
+  const expiresAt = new Date(Date.now() + INVITE_LIFETIME_MS);
+  await tx.verificationToken.deleteMany({ where: { identifier: userId } });
+  await tx.verificationToken.create({
+    data: { identifier: userId, token: hashToken(token), expires: expiresAt },
+  });
+  const data = {
+    userId,
+    kitaId: user.kitaId,
+    email: user.email,
+    role: user.role,
+    token,
+    expiresAt,
+    invitedById,
+    status: InvitationStatus.PENDING,
+    acceptedAt: null,
+    sentAt: null,
+    lastAttemptAt: null,
+    leaseUntil: null,
+    attempts: 0,
+    failed: false,
+  };
+  return existing
+    ? tx.invitation.update({ where: { id: existing.id }, data })
+    : tx.invitation.create({ data });
+}
+
+// Tests inject a transport. Every recipient is attempted despite individual failures.
+export async function deliverFamilyInvitations(
+  ids: string[],
+  send = sendAppEmail,
+) {
+  let sent = 0;
+  let failed = 0;
+  for (const id of new Set(ids)) {
+    const now = new Date();
+    const leaseUntil = new Date(now.getTime() + 5 * 60_000);
+    const claim = await prisma.invitation.updateMany({
+      where: {
+        id,
+        userId: { not: null },
+        status: InvitationStatus.PENDING,
+        sentAt: null,
+        expiresAt: { gt: now },
+        OR: [{ leaseUntil: null }, { leaseUntil: { lte: now } }],
+      },
+      data: { leaseUntil, lastAttemptAt: now, attempts: { increment: 1 } },
+    });
+    if (!claim.count) continue;
+    const finish = (data: Prisma.InvitationUpdateManyMutationInput) =>
+      prisma.invitation.updateMany({
+        where: { id, token: jobToken, leaseUntil },
+        data: { ...data, leaseUntil: null },
+      });
+    let jobToken: string | undefined;
+    try {
+      const job = await prisma.invitation.findUniqueOrThrow({
+        where: { id },
+        include: { user: true, kita: { select: { name: true } } },
+      });
+      jobToken = job.token;
+      const token = await prisma.verificationToken.findUnique({
+        where: { token: hashToken(job.token) },
+      });
+      const user = job.user;
+      if (
+        !user ||
+        user.kitaId !== job.kitaId ||
+        !user.familyId ||
+        user.email !== job.email ||
+        user.emailVerifiedAt ||
+        user.disabledAt ||
+        user.passwordHash !== "" ||
+        !token ||
+        token.identifier !== user.id ||
+        token.expires <= now
+      ) {
+        await finish({
+          status: user?.emailVerifiedAt
+            ? InvitationStatus.ACCEPTED
+            : InvitationStatus.REVOKED,
+          failed: false,
+        });
+        continue;
+      }
+      const base =
+        process.env.NEXT_PUBLIC_SITE_URL ||
+        process.env.AUTH_URL ||
+        process.env.NEXTAUTH_URL;
+      if (!base) throw new Error("App-Adresse für Einladungen fehlt.");
+      const site = new URL(base);
+      if (
+        !["https:", "http:"].includes(site.protocol) ||
+        site.username ||
+        site.password
+      )
+        throw new Error("App-Adresse für Einladungen ist ungültig.");
+      const result = await send({
+        to: job.email,
+        subject: `Einladung zu ${job.kita.name} im Kita-Planer`,
+        idempotencyKey: `family-invitation/${job.token}`,
+        react: createElement(InviteEmail, {
+          parentName: `${user.firstName} ${user.lastName}`,
+          kitaName: job.kita.name,
+          inviteLink: new URL(`/invite/${job.token}`, site.origin).toString(),
+        }),
+      });
+      if (result.success) {
+        await finish({ sentAt: new Date(), failed: false });
+        sent++;
+      } else {
+        await finish({ failed: true });
+        failed++;
+      }
+    } catch {
+      await finish({ failed: true });
+      failed++;
+    }
+  }
+  return { sent, failed };
+}
+
+export async function resendFamilyInvitation(
+  kitaId: string,
+  userId: string,
+  actorId: string,
+  expectedEmail?: string,
+) {
+  const outcome = await prisma.$transaction(async (tx) => {
+    const actor = await tx.user.findFirst({
+      where: { id: actorId, kitaId, role: "ADMIN", disabledAt: null },
+      select: { id: true },
+    });
+    if (!actor)
+      return {
+        error: "Nur Kita-Admins dürfen Familieneinladungen erneut senden.",
+      };
+    // Serializes renewal with other renewals for this account.
+    await tx.$queryRaw`SELECT "id" FROM "users" WHERE "id" = ${userId} AND "kitaId" = ${kitaId} FOR UPDATE`;
+    const user = await tx.user.findFirst({
+      where: { id: userId, kitaId, familyId: { not: null } },
+    });
+    if (!user) return { error: "Elternkonto wurde nicht gefunden." };
+    if (user.emailVerifiedAt || user.passwordHash || user.disabledAt)
+      return { error: "Keine offene Einladung gefunden." };
+    if (expectedEmail && user.email !== expectedEmail)
+      return { error: "Die Einladung hat sich geändert. Bitte lade die Seite neu." };
+    const existing = await tx.invitation.findUnique({ where: { userId } });
+    const now = new Date();
+    if (existing?.leaseUntil && existing.leaseUntil > now)
+      return {
+        error: "Die Einladung wird gerade versendet. Bitte kurz warten.",
+      };
+    if (existing?.sentAt && now.getTime() - existing.sentAt.getTime() < 60_000)
+      return {
+        error:
+          "Die Einladung wurde gerade versendet. Bitte nach einer Minute erneut versuchen.",
+      };
+    const token = existing
+      ? await tx.verificationToken.findUnique({
+          where: { token: hashToken(existing.token) },
+        })
+      : null;
+    if (
+      existing &&
+      existing.status === InvitationStatus.PENDING &&
+      !existing.sentAt &&
+      existing.email === user.email &&
+      existing.expiresAt > now &&
+      token?.identifier === user.id &&
+      token.expires > now
+    )
+      return { id: existing.id };
+    const invitation = await queueFamilyInvitation(tx, userId, actorId);
+    return { id: invitation.id };
+  });
+  if (outcome.error || !outcome.id)
+    return {
+      error: outcome.error ?? "Einladung konnte nicht erstellt werden.",
+    };
+  const result = await deliverFamilyInvitations([outcome.id]);
+  return {
+    success: true,
+    ...(result.failed
+      ? {
+          warning:
+            "Einladung ist gespeichert, konnte aber nicht versendet werden. Du kannst den Versand erneut versuchen.",
+        }
+      : !result.sent
+        ? {
+            warning:
+              "Die Einladung ist vorbereitet. Bitte prüfe den aktuellen Versandstatus.",
+          }
+        : {}),
+  };
+}

src/lib/mail.ts

@@ -1,4 +1,6 @@
-import type { ReactNode } from "react";
+import { createHash } from "node:crypto";
+import type { ReactNode, ReactElement } from "react";
+import { render } from "@react-email/render";
 import { Resend } from "resend";
 
 let resendClient: Resend | null = null;
@@ -10,6 +12,7 @@ type SendAppEmailInput = {
   from?: string;
   replyTo?: string | string[];
   idempotencyKey?: string;
+  timeoutMs?: number;
 };
 
 type SendAppEmailResult =
@@ -38,11 +41,12 @@ export async function sendAppEmail({
   from = process.env.EMAIL_FROM,
   replyTo,
   idempotencyKey,
+  timeoutMs = 10000,
 }: SendAppEmailInput): Promise<SendAppEmailResult> {
   if (Array.isArray(to)) {
     let id: string | undefined;
     for (const recipient of new Set(to)) {
-      const result = await sendAppEmail({ to: recipient, subject, react, from, replyTo });
+      const result = await sendAppEmail({ to: recipient, subject, react, from, replyTo, idempotencyKey: idempotencyKey ? `${idempotencyKey}/${createHash("sha256").update(recipient).digest("hex").slice(0, 16)}` : undefined, timeoutMs });
       if (!result.success) return result;
       id = result.id;
     }
@@ -74,15 +78,23 @@ export async function sendAppEmail({
 
   try {
     resendClient ??= new Resend(process.env.RESEND_API_KEY);
+    const html = await render(react as ReactElement);
+    // Retries keep the same key for identical payloads, while corrected messages get a new version.
+    const payloadKey = idempotencyKey ? `${idempotencyKey}/${createHash("sha256").update(JSON.stringify({ to, subject, from, replyTo, html })).digest("hex")}` : undefined;
+    // The installed SDK forwards request options to fetch; its types omit signal.
+    const requestOptions: NonNullable<Parameters<typeof resendClient.emails.send>[1]> & { signal: AbortSignal } = {
+      idempotencyKey: payloadKey,
+      signal: AbortSignal.timeout(timeoutMs),
+    };
     const { data, error } = await resendClient.emails.send(
       {
         from: from!,
         to,
         subject,
-        react,
+        html,
         replyTo,
       },
-      { idempotencyKey },
+      requestOptions,
     );
 
     if (error) {

src/lib/notdienst-days.ts

@@ -0,0 +1,26 @@
+import { formatUtcDateKey, getWorkingDaysOfMonth } from "./date-utils";
+
+export type NotdienstClosure = { startDate: Date; endDate: Date };
+const berlinDate = new Intl.DateTimeFormat("sv-SE", {
+  timeZone: "Europe/Berlin",
+  year: "numeric",
+  month: "2-digit",
+  day: "2-digit",
+});
+
+// Calendar events are instants; assignments are UTC-midnight date values.
+// A closure excludes every Berlin calendar day from start through end, inclusive.
+export function getNotdienstDays(
+  year: number,
+  month: number,
+  closures: NotdienstClosure[],
+) {
+  const ranges = closures.map((closure) => ({
+    start: berlinDate.format(closure.startDate),
+    end: berlinDate.format(closure.endDate),
+  }));
+  return getWorkingDaysOfMonth(year, month).filter((day) => {
+    const key = formatUtcDateKey(day);
+    return !ranges.some((range) => range.start <= key && key <= range.end);
+  });
+}

src/lib/notdienst-notifications.ts

@@ -0,0 +1,529 @@
+import { randomUUID } from "node:crypto";
+import { createElement } from "react";
+import type { Prisma } from "@prisma/client";
+import { prisma } from "@/lib/prisma";
+import { serializableTransaction } from "./transaction";
+import { UserFacingError } from "./action-error";
+import {
+  berlinDateKey,
+  formatUtcDateKey,
+  getTargetMonthData,
+  isNotdienstReminderDue,
+  NOTDIENST_LOCK_DAY,
+} from "./date-utils";
+import { loadNotdienstDays } from "./notdienst-planning";
+import { sendAppEmail } from "@/lib/mail";
+import { NotdienstAvailabilityReminderEmail } from "@/emails/NotdienstAvailabilityReminderEmail";
+import { NotdienstPlanPublishedEmail } from "@/emails/NotdienstPlanPublishedEmail";
+
+type Tx = Prisma.TransactionClient;
+const parentRoles = ["ELTERN", "ADMIN", "KOORDINATOR"] as const;
+const eligibleParents = (now: Date): Prisma.UserWhereInput => ({
+  role: { in: [...parentRoles] },
+  emailVerifiedAt: { not: null },
+  privacyPolicyAcceptedAt: { not: null },
+  disabledAt: null,
+  OR: [{ lockedUntil: null }, { lockedUntil: { lte: now } }],
+});
+const monthLabel = (year: number, month: number) =>
+  new Intl.DateTimeFormat("de-DE", {
+    timeZone: "UTC",
+    month: "long",
+    year: "numeric",
+  }).format(new Date(Date.UTC(year, month - 1, 1)));
+const period = (year: number, month: number) => ({
+  gte: new Date(Date.UTC(year, month - 1, 1)),
+  lt: new Date(Date.UTC(year, month, 1)),
+});
+
+export async function getFamilyNotdienstProgress(
+  db: Pick<Tx, "child" | "notdienstAvailability" | "termin">,
+  kitaId: string,
+  familyId: string,
+  year: number,
+  month: number,
+  minimum: number,
+) {
+  const [children, entries, days] = await Promise.all([
+    db.child.count({ where: { kitaId, familyId, active: true } }),
+    db.notdienstAvailability.findMany({
+      where: {
+        kitaId,
+        child: { kitaId, familyId, active: true },
+        date: period(year, month),
+      },
+      select: { date: true },
+    }),
+    loadNotdienstDays(db, kitaId, year, month),
+  ]);
+  const valid = new Set(days.map(formatUtcDateKey));
+  const selected = new Set(
+    entries
+      .map((a) => formatUtcDateKey(a.date))
+      .filter((key) => valid.has(key)),
+  ).size;
+  return { selected, required: children * minimum };
+}
+
+export async function queueNotdienstReminders(
+  kitaId: string,
+  year: number,
+  month: number,
+  automatic = false,
+  now = new Date(),
+) {
+  return serializableTransaction(async (tx) => {
+    const target = getTargetMonthData(now);
+    if (
+      target.isLocked ||
+      target.targetYear !== year ||
+      target.targetMonth !== month
+    ) {
+      if (automatic) return 0;
+      throw new UserFacingError(
+        "Erinnerungen sind nur während der Eintragsfrist für den Folgemonat möglich.",
+      );
+    }
+    const kita = await tx.kita.findUniqueOrThrow({
+      where: { id: kitaId },
+      select: {
+        notdienstModuleEnabled: true,
+        notdienstMinPerChildPerMonth: true,
+        notdienstReminderDaysBefore: true,
+      },
+    });
+    if (!kita.notdienstModuleEnabled) {
+      if (automatic) return 0;
+      throw new UserFacingError("Das Notdienstmodul ist deaktiviert.");
+    }
+    const plan = await tx.notdienstPlan.findUnique({
+      where: { kitaId_year_month: { kitaId, year, month } },
+      select: { status: true },
+    });
+    if (plan?.status === "PUBLISHED") return 0;
+    if (automatic) {
+      if (!isNotdienstReminderDue(kita.notdienstReminderDaysBefore, now))
+        return 0;
+      const run = await tx.notdienstReminderRun.createMany({
+        data: [{ id: randomUUID(), kitaId, year, month, createdAt: now }],
+        skipDuplicates: true,
+      });
+      if (!run.count) return 0;
+    }
+    const [families, entries, days] = await Promise.all([
+      tx.family.findMany({
+        where: { kitaId, children: { some: { kitaId, active: true } } },
+        select: {
+          id: true,
+          children: { where: { kitaId, active: true }, select: { id: true } },
+          users: {
+            where: { kitaId, ...eligibleParents(now) },
+            select: { id: true },
+          },
+        },
+      }),
+      tx.notdienstAvailability.findMany({
+        where: {
+          kitaId,
+          date: period(year, month),
+          child: { kitaId, active: true },
+        },
+        select: { date: true, child: { select: { familyId: true } } },
+      }),
+      loadNotdienstDays(tx, kitaId, year, month),
+    ]);
+    const valid = new Set(days.map(formatUtcDateKey));
+    const selected = new Map<string, Set<string>>();
+    for (const entry of entries) {
+      const key = formatUtcDateKey(entry.date);
+      if (!valid.has(key)) continue;
+      const dates = selected.get(entry.child.familyId) ?? new Set<string>();
+      dates.add(key);
+      selected.set(entry.child.familyId, dates);
+    }
+    const jobs = families
+      .filter(
+        (family) =>
+          (selected.get(family.id)?.size ?? 0) <
+          family.children.length * kita.notdienstMinPerChildPerMonth,
+      )
+      .flatMap((family) =>
+        family.users.map((user) => ({
+          id: randomUUID(),
+          kitaId,
+          familyId: family.id,
+          userId: user.id,
+          year,
+          month,
+          kind: "REMINDER",
+          eventKey: `reminder:${berlinDateKey(now)}`,
+          createdAt: now,
+          nextAttemptAt: now,
+        })),
+      );
+    if (!jobs.length) return 0;
+    return (
+      await tx.notdienstEmail.createMany({ data: jobs, skipDuplicates: true })
+    ).count;
+  });
+}
+
+// Must run in the same transaction as the first publication.
+export async function queueNotdienstPublication(
+  tx: Tx,
+  kitaId: string,
+  planId: string,
+  year: number,
+  month: number,
+  now = new Date(),
+) {
+  const assigned = await tx.notdienstAssignment.findMany({
+    where: { kitaId, planId, child: { kitaId, active: true } },
+    select: { child: { select: { familyId: true } } },
+  });
+  const families = await tx.family.findMany({
+    where: {
+      kitaId,
+      id: { in: [...new Set(assigned.map((a) => a.child.familyId))] },
+    },
+    select: {
+      id: true,
+      users: {
+        where: { kitaId, ...eligibleParents(now) },
+        select: { id: true },
+      },
+    },
+  });
+  const jobs = families.flatMap((family) =>
+    family.users.map((user) => ({
+      id: randomUUID(),
+      kitaId,
+      familyId: family.id,
+      userId: user.id,
+      planId,
+      year,
+      month,
+      kind: "PUBLICATION",
+      eventKey: `publication:${planId}`,
+      createdAt: now,
+      nextAttemptAt: now,
+    })),
+  );
+  return jobs.length
+    ? (await tx.notdienstEmail.createMany({ data: jobs, skipDuplicates: true }))
+        .count
+    : 0;
+}
+
+export async function deliverNotdienstEmails(
+  ids: string[],
+  send = sendAppEmail,
+  now = new Date(),
+) {
+  const result = { sent: 0, failed: 0, skipped: 0 };
+  const deliver = async (id: string) => {
+    const claimToken = randomUUID();
+    const leaseUntil = new Date(now.getTime() + 5 * 60_000);
+    const claim = await prisma.notdienstEmail.updateMany({
+      where: {
+        id,
+        sentAt: null,
+        skippedAt: null,
+        nextAttemptAt: { lte: now },
+        OR: [{ leaseUntil: null }, { leaseUntil: { lte: now } }],
+      },
+      data: { claimToken, leaseUntil, attempts: { increment: 1 } },
+    });
+    if (!claim.count) return;
+    const finish = (data: Prisma.NotdienstEmailUpdateManyMutationInput) =>
+      prisma.notdienstEmail.updateMany({
+        where: { id, claimToken },
+        data: { ...data, claimToken: null, leaseUntil: null },
+      });
+    try {
+      const job = await prisma.notdienstEmail.findUniqueOrThrow({
+        where: { id },
+        include: { user: true, kita: true, plan: { select: { status: true } } },
+      });
+      const { user, kita } = job;
+      let eligible =
+        kita.notdienstModuleEnabled &&
+        user.kitaId === job.kitaId &&
+        user.familyId === job.familyId &&
+        parentRoles.some((role) => role === user.role) &&
+        !!user.emailVerifiedAt &&
+        !!user.privacyPolicyAcceptedAt &&
+        !user.disabledAt &&
+        (!user.lockedUntil || user.lockedUntil <= now);
+      let progress: { selected: number; required: number } | undefined;
+      let dates: string[] = [];
+      if (job.kind === "REMINDER") {
+        const target = getTargetMonthData(now);
+        const plan = await prisma.notdienstPlan.findUnique({
+          where: {
+            kitaId_year_month: {
+              kitaId: job.kitaId,
+              year: job.year,
+              month: job.month,
+            },
+          },
+          select: { status: true },
+        });
+        eligible &&=
+          !target.isLocked &&
+          target.targetYear === job.year &&
+          target.targetMonth === job.month &&
+          plan?.status !== "PUBLISHED";
+        if (eligible) {
+          progress = await getFamilyNotdienstProgress(
+            prisma,
+            job.kitaId,
+            job.familyId,
+            job.year,
+            job.month,
+            kita.notdienstMinPerChildPerMonth,
+          );
+          eligible &&=
+            progress.required > 0 && progress.selected < progress.required;
+        }
+      } else if (job.kind === "PUBLICATION") {
+        eligible &&= !!job.planId && job.plan?.status === "PUBLISHED";
+        if (eligible) {
+          const [assignments, days] = await Promise.all([
+            prisma.notdienstAssignment.findMany({
+              where: {
+                kitaId: job.kitaId,
+                planId: job.planId!,
+                child: {
+                  kitaId: job.kitaId,
+                  familyId: job.familyId,
+                  active: true,
+                },
+                date: {
+                  ...period(job.year, job.month),
+                },
+              },
+              select: { date: true },
+              orderBy: { date: "asc" },
+            }),
+            loadNotdienstDays(prisma, job.kitaId, job.year, job.month),
+          ]);
+          const valid = new Set(days.map(formatUtcDateKey));
+          dates = assignments
+            .map((a) => formatUtcDateKey(a.date))
+            .filter((key) => key >= berlinDateKey(now) && valid.has(key));
+          eligible &&= dates.length > 0;
+        }
+      } else eligible = false;
+      if (!eligible) {
+        await finish({ skippedAt: now, failed: false, lastError: null });
+        result.skipped++;
+        return;
+      }
+      const base =
+        process.env.NEXT_PUBLIC_SITE_URL ||
+        process.env.AUTH_URL ||
+        process.env.NEXTAUTH_URL;
+      if (!base) throw new Error("App-Adresse für E-Mails fehlt.");
+      const site = new URL(base);
+      if (
+        !["http:", "https:"].includes(site.protocol) ||
+        site.username ||
+        site.password
+      )
+        throw new Error("App-Adresse ungültig.");
+      const label = monthLabel(job.year, job.month);
+      const link = new URL(
+        job.kind === "REMINDER"
+          ? "/dashboard/notdienst"
+          : "/dashboard/kalender",
+        site.origin,
+      ).toString();
+      const response = await send({
+        to: user.email,
+        idempotencyKey: `notdienst-email/${job.id}`,
+        subject:
+          job.kind === "REMINDER"
+            ? `Erinnerung: Notdienst-Verfügbarkeiten für ${label}`
+            : `Notdienstplan ${label} veröffentlicht`,
+        react:
+          job.kind === "REMINDER"
+            ? createElement(NotdienstAvailabilityReminderEmail, {
+                parentName: user.firstName,
+                kitaName: kita.name,
+                monthLabel: label,
+                link,
+                selectedDays: progress!.selected,
+                requiredDays: progress!.required,
+                deadlineLabel: new Intl.DateTimeFormat("de-DE", {
+                  timeZone: "UTC",
+                  day: "2-digit",
+                  month: "2-digit",
+                  year: "numeric",
+                }).format(
+                  new Date(
+                    Date.UTC(job.year, job.month - 2, NOTDIENST_LOCK_DAY),
+                  ),
+                ),
+              })
+            : createElement(NotdienstPlanPublishedEmail, {
+                parentName: user.firstName,
+                kitaName: kita.name,
+                monthLabel: label,
+                dateLabels: dates.map((key) =>
+                  new Intl.DateTimeFormat("de-DE", {
+                    timeZone: "UTC",
+                    weekday: "long",
+                    day: "2-digit",
+                    month: "2-digit",
+                    year: "numeric",
+                  }).format(new Date(`${key}T00:00:00Z`)),
+                ),
+                link,
+              }),
+      });
+      if (!response.success) throw new Error(response.error);
+      await finish({ sentAt: now, failed: false, lastError: null });
+      result.sent++;
+    } catch {
+      const current = await prisma.notdienstEmail.findUnique({
+        where: { id },
+        select: { attempts: true },
+      });
+      const delay = Math.min(
+        6 * 60 * 60_000,
+        60_000 * 2 ** Math.min(current?.attempts ?? 1, 8),
+      );
+      await finish({
+        failed: true,
+        lastError:
+          "E-Mail-Versand fehlgeschlagen. Der Versand wird erneut versucht.",
+        nextAttemptAt: new Date(now.getTime() + delay),
+      });
+      result.failed++;
+    }
+  };
+  const unique = [...new Set(ids)];
+  for (let i = 0; i < unique.length; i += 4)
+    await Promise.all(unique.slice(i, i + 4).map(deliver));
+  return result;
+}
+
+type MailScope = {
+  kitaId?: string;
+  year?: number;
+  month?: number;
+  planId?: string;
+};
+export async function deliverDueNotdienstEmails(
+  scope: MailScope = {},
+  send = sendAppEmail,
+  now = new Date(),
+) {
+  const jobs = await prisma.notdienstEmail.findMany({
+    where: {
+      ...scope,
+      sentAt: null,
+      skippedAt: null,
+      nextAttemptAt: { lte: now },
+      OR: [{ leaseUntil: null }, { leaseUntil: { lte: now } }],
+    },
+    select: { id: true },
+    orderBy: [{ nextAttemptAt: "asc" }, { createdAt: "asc" }],
+    take: 12,
+  });
+  return deliverNotdienstEmails(
+    jobs.map((job) => job.id),
+    send,
+    now,
+  );
+}
+
+export async function runNotdienstNotificationJob(
+  send = sendAppEmail,
+  now = new Date(),
+  kitaId?: string,
+) {
+  const target = getTargetMonthData(now);
+  let queued = 0;
+  if (!target.isLocked && isNotdienstReminderDue(31, now)) {
+    const candidates = await prisma.kita.findMany({
+      where: {
+        ...(kitaId ? { id: kitaId } : {}),
+        notdienstModuleEnabled: true,
+        notdienstPlans: { none: { year: target.targetYear, month: target.targetMonth, status: "PUBLISHED" } },
+        notdienstReminderDaysBefore: {
+          gte: Math.max(
+            1,
+            NOTDIENST_LOCK_DAY - Number(berlinDateKey(now).slice(-2)),
+          ),
+        },
+        notdienstReminderRuns: {
+          none: { year: target.targetYear, month: target.targetMonth },
+        },
+      },
+      select: { id: true, notdienstReminderDaysBefore: true },
+      orderBy: { id: "asc" },
+      take: 100,
+    });
+    for (const kita of candidates)
+      if (isNotdienstReminderDue(kita.notdienstReminderDaysBefore, now))
+        queued += await queueNotdienstReminders(
+          kita.id,
+          target.targetYear,
+          target.targetMonth,
+          true,
+          now,
+        );
+  }
+  return {
+    queued,
+    ...(await deliverDueNotdienstEmails(kitaId ? { kitaId } : {}, send, now)),
+  };
+}
+
+export async function getNotdienstEmailStatus(
+  kitaId: string,
+  year: number,
+  month: number,
+) {
+  const jobs = await prisma.notdienstEmail.findMany({
+    where: { kitaId, year, month },
+    select: {
+      id: true,
+      kind: true,
+      sentAt: true,
+      skippedAt: true,
+      failed: true,
+      lastError: true,
+      user: { select: { firstName: true, lastName: true } },
+      family: { select: { name: true } },
+    },
+    orderBy: { createdAt: "desc" },
+  });
+  const status = (job: (typeof jobs)[number]) =>
+    job.sentAt
+      ? ("sent" as const)
+      : job.skippedAt
+        ? ("skipped" as const)
+        : job.failed
+          ? ("failed" as const)
+          : ("pending" as const);
+  return {
+    sent: jobs.filter((job) => status(job) === "sent").length,
+    failed: jobs.filter((job) => status(job) === "failed").length,
+    pending: jobs.filter((job) => status(job) === "pending").length,
+    skipped: jobs.filter((job) => status(job) === "skipped").length,
+    entries: jobs.slice(0, 30).map((job) => ({
+      id: job.id,
+      kind: job.kind,
+      status: status(job),
+      name: `${job.user.firstName} ${job.user.lastName}`,
+      familyName: job.family.name,
+      error: job.lastError,
+    })),
+  };
+}
+export type NotdienstEmailStatus = Awaited<
+  ReturnType<typeof getNotdienstEmailStatus>
+>;

src/lib/notdienst-planning.ts

@@ -0,0 +1,56 @@
+import { Prisma } from "@prisma/client";
+import { UserFacingError } from "./action-error";
+import { getNotdienstDays } from "./notdienst-days";
+import { todayKey } from "./staff/calculations";
+
+export async function loadNotdienstDays(
+  db: Pick<Prisma.TransactionClient, "termin">,
+  kitaId: string,
+  year: number,
+  month: number,
+) {
+  const closures = await db.termin.findMany({
+    where: {
+      kitaId,
+      status: "CONFIRMED",
+      type: { in: ["SCHLIESSTAG", "TEAMTAG"] },
+      // Include closures crossing the month boundary and Berlin midnight.
+      startDate: { lt: new Date(Date.UTC(year, month, 1)) },
+      endDate: { gte: new Date(Date.UTC(year, month - 1, 1) - 86400000) },
+    },
+    select: { startDate: true, endDate: true },
+  });
+  return getNotdienstDays(year, month, closures);
+}
+
+export async function assertChildrenRemovable(
+  tx: Prisma.TransactionClient,
+  kitaId: string,
+  familyId: string,
+  childIds: string[],
+) {
+  if (childIds.length === 0) return;
+  // Coordinate with the FK locks taken by concurrent assignment writes.
+  await tx.$queryRaw`SELECT id FROM children WHERE "kitaId" = ${kitaId}
+    AND "familyId" = ${familyId} AND id IN (${Prisma.join(childIds)}) ORDER BY id FOR UPDATE`;
+  const obligation = await tx.notdienstAssignment.findFirst({
+    where: {
+      kitaId,
+      childId: { in: childIds },
+      child: { kitaId, familyId },
+      OR: [
+        {
+          date: { gte: new Date(`${todayKey()}T00:00:00Z`) },
+          plan: { kitaId, status: "PUBLISHED" },
+        },
+        { alarms: { some: { kitaId, activeAssignmentId: { not: null } } } },
+      ],
+    },
+    select: { id: true },
+  });
+  if (obligation) {
+    throw new UserFacingError(
+      "Das Kind kann nicht entfernt werden, solange veröffentlichte Notdienste oder aktive Alarme bestehen. Bitte zuerst die Einteilung mit der Koordination klären.",
+    );
+  }
+}

src/lib/notdienst-swaps.ts

@@ -0,0 +1,11 @@
+import type { UserRole } from "@prisma/client";
+
+export function canRequestNotdienstSwap(
+  role: UserRole,
+  familyId: string | null | undefined,
+) {
+  return (
+    !!familyId &&
+    (role === "ELTERN" || role === "ADMIN" || role === "KOORDINATOR")
+  );
+}

tests/absence-policy.test.ts

@@ -0,0 +1,73 @@
+import assert from "node:assert/strict";
+import { test } from "node:test";
+import {
+  absenceDate,
+  absenceToday,
+  canEditOwnAbsence,
+  canManageKitaAbsences,
+} from "../src/lib/absence-policy";
+import { familyInvitationView } from "../src/lib/family-invitation-view";
+
+test("Abwesenheitsdatum akzeptiert echte Kalendertage und lehnt Überläufe ab", () => {
+  assert.equal(
+    absenceDate("2028-02-29").toISOString(),
+    "2028-02-29T00:00:00.000Z",
+  );
+  for (const value of [
+    "2026-02-29",
+    "2026-04-31",
+    "2026-13-01",
+    "2026-1-09",
+    "2026-10-09T12:00:00",
+    "invalid",
+  ])
+    assert.throws(() => absenceDate(value));
+});
+
+test("Die Datumsgrenze folgt Berlin auch über Mitternacht und die Zeitumstellung", () => {
+  assert.equal(absenceToday(new Date("2026-10-09T21:59:59Z")), "2026-10-09");
+  assert.equal(absenceToday(new Date("2026-10-09T22:00:00Z")), "2026-10-10");
+  assert.equal(absenceToday(new Date("2026-10-25T22:59:59Z")), "2026-10-25");
+  assert.equal(absenceToday(new Date("2026-10-25T23:00:00Z")), "2026-10-26");
+  assert.equal(canEditOwnAbsence("2026-10-09", "2026-10-09"), false);
+  assert.equal(canEditOwnAbsence("2026-10-10", "2026-10-09"), true);
+  assert.equal(canManageKitaAbsences("ELTERN"), false);
+  for (const role of ["ADMIN", "KOORDINATOR", "ERZIEHER"])
+    assert.equal(canManageKitaAbsences(role), true);
+});
+
+test("Einladungsanzeige unterscheidet Aktivierung, Fehler, Ablauf und laufenden Versand", () => {
+  const now = new Date("2026-10-09T12:00:00Z");
+  const base = {
+    expiresAt: new Date("2026-10-16T12:00:00Z"),
+    sentAt: null,
+    failed: false,
+    leaseUntil: null,
+    status: "PENDING",
+  };
+  assert.equal(familyInvitationView(null, null, now).status, "open");
+  assert.equal(
+    familyInvitationView(null, { ...base, failed: true }, now).status,
+    "failed",
+  );
+  assert.equal(
+    familyInvitationView(null, { ...base, expiresAt: now }, now).status,
+    "expired",
+  );
+  assert.equal(
+    familyInvitationView(null, { ...base, sentAt: now }, now).status,
+    "sent",
+  );
+  assert.equal(
+    familyInvitationView(
+      null,
+      { ...base, leaseUntil: new Date(now.getTime() + 1000) },
+      now,
+    ).status,
+    "sending",
+  );
+  assert.equal(
+    familyInvitationView(now, { ...base, failed: true }, now).status,
+    "active",
+  );
+});

tests/calendar-actions.integration.test.cjs

@@ -0,0 +1,193 @@
+/* eslint-disable @typescript-eslint/no-require-imports -- Test real actions with isolated request and mail boundaries. */
+const { test, before, beforeEach, after } = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+const vm = require('node:vm');
+const ts = require('typescript');
+const { PrismaClient } = require('@prisma/client');
+const { randomUUID } = require('node:crypto');
+let prisma, current, fixture, edit, swap, accept;
+const tenants = [], emails = [];
+function loader(overrides = {}) {
+  const cache = new Map();
+  function load(file) {
+    file = path.resolve(file);
+    if (cache.has(file)) return cache.get(file).exports;
+    const mod = { exports: {} }; cache.set(file, mod);
+    const code = ts.transpileModule(fs.readFileSync(file, 'utf8'), {
+      compilerOptions: { target: ts.ScriptTarget.ES2022, module: ts.ModuleKind.CommonJS, jsx: ts.JsxEmit.ReactJSX, esModuleInterop: true },
+      fileName: file,
+    }).outputText;
+    const req = spec => {
+      if (Object.hasOwn(overrides, spec)) return overrides[spec];
+      if (spec === 'server-only') return {};
+      if (spec === '@/lib/prisma') return { prisma };
+      if (spec === 'next/headers') return { headers: async () => new Headers() };
+      if (spec === 'next/cache') return { revalidatePath() {} };
+      if (spec === 'next/navigation') return { redirect(url) { throw new Error(`REDIRECT:${url}`); }, notFound() { throw new Error('NOT_FOUND'); } };
+      if (spec.startsWith('@/') || spec.startsWith('.')) {
+        const target = spec.startsWith('@/') ? path.resolve('src', spec.slice(2)) : path.resolve(path.dirname(file), spec);
+        for (const suffix of ['.ts', '.tsx', '/index.ts']) if (fs.existsSync(target + suffix)) return load(target + suffix);
+      }
+      return require(spec);
+    };
+    vm.runInThisContext(`(function(require,module,exports){${code}\n})`, { filename: file })(req, mod, mod.exports);
+    return mod.exports;
+  }
+  return load;
+}
+
+before(async () => {
+  const raw = process.env.TEST_DATABASE_URL;
+  if (!raw) throw new Error('TEST_DATABASE_URL muss ausdrücklich auf die lokale kita_quickwins_test zeigen.');
+  const url = new URL(raw);
+  assert.ok(['127.0.0.1','localhost'].includes(url.hostname));
+  assert.equal(url.pathname,'/kita_quickwins_test');
+  prisma = new PrismaClient({ datasourceUrl: raw });
+  const load = loader({
+    '@/lib/auth-utils': {
+      requireKitaSession: async () => ({ user: current }),
+      requireRole: async roles => { assert.ok(roles.includes(current.role)); return { user: current }; },
+    },
+    '@/lib/mail': { sendAppEmail: async input => { emails.push(input); return { success: true }; } },
+  });
+  ({ updateMitbringsel: edit, createNotdienstSwapRequest: swap, acceptNotdienstSwapRequest: accept } = load('src/app/dashboard/kalender/actions.ts'));
+});
+after(async () => {
+  if (!prisma) return;
+  await prisma.kita.deleteMany({ where: { id: { in: tenants } } });
+  await prisma.$disconnect();
+});
+beforeEach(async () => {
+  emails.length = 0;
+  const kita = await prisma.kita.create({ data: { name: 'Kalender-Test', slug: `calendar-test-${randomUUID()}` } }); tenants.push(kita.id);
+  const family = await prisma.family.create({ data: { kitaId: kita.id, name: 'Eigener Haushalt' } });
+  const targetFamily = await prisma.family.create({ data: { kitaId: kita.id, name: 'Angefragter Haushalt' } });
+  const makeUser = (role, familyId) => prisma.user.create({ data: { kitaId: kita.id, familyId, role, email: `${randomUUID()}@example.invalid`, firstName: 'Test', lastName: role, passwordHash: 'test', emailVerifiedAt: new Date(), privacyPolicyAcceptedAt: new Date() } });
+  const owner = await makeUser('ELTERN',family.id);
+  const targetAdmin = await makeUser('ADMIN',targetFamily.id);
+  const targetCoord = await makeUser('KOORDINATOR',targetFamily.id);
+  const event = await prisma.termin.create({ data: { kitaId: kita.id, title: 'Sommerfest', type: 'KITA_FEST', status: 'CONFIRMED', mitbringselListEnabled: true, startDate: new Date('2030-11-04T10:00:00Z'), endDate: new Date('2030-11-04T16:00:00Z') } });
+  const item = await prisma.mitbringselItem.create({ data: { kitaId: kita.id, terminId: event.id, userId: owner.id, content: 'Nudelsalat' } });
+  const child = await prisma.child.create({ data: { kitaId: kita.id, familyId: family.id, firstName: 'Eigenes Kind', lastName: 'Test' } });
+  const targetChild = await prisma.child.create({ data: { kitaId: kita.id, familyId: targetFamily.id, firstName: 'Anderes Kind', lastName: 'Test' } });
+  const plan = await prisma.notdienstPlan.create({ data: { kitaId: kita.id, year: 2030, month: 11, status: 'PUBLISHED' } });
+  const offered = await prisma.notdienstAssignment.create({ data: { kitaId: kita.id, planId: plan.id, childId: child.id, date: new Date('2030-11-04T00:00:00Z') } });
+  const target = await prisma.notdienstAssignment.create({ data: { kitaId: kita.id, planId: plan.id, childId: targetChild.id, date: new Date('2030-11-05T00:00:00Z') } });
+  fixture = { kita, family, targetFamily, owner, targetAdmin, targetCoord, event, item, child, targetChild, plan, offered, target };
+  current = owner;
+});
+const edited = content => edit({ itemId: fixture.item.id, content });
+const swapPayload = () => ({ targetAssignmentId: fixture.target.id, offeredAssignmentId: fixture.offered.id, message: 'Kannst du tauschen?' });
+const storedItem = () => prisma.mitbringselItem.findUniqueOrThrow({ where: { id: fixture.item.id } });
+async function setRole(role) { current = await prisma.user.update({ where: { id: fixture.owner.id }, data: { role } }); }
+
+test('Eigener Beitrag wird direkt bearbeitet und behält Autor, Termin und ID', async () => {
+  assert.equal((await edited('  Kartoffelsalat  ')).success,true);
+  const item = await storedItem();
+  assert.equal(item.content,'Kartoffelsalat');
+  assert.equal(item.userId,fixture.owner.id);
+  assert.equal(item.terminId,fixture.event.id);
+  assert.equal(await prisma.mitbringselItem.count({ where: { terminId: fixture.event.id } }),1);
+});
+for (const [label,content] of [['leer',''],['Leerzeichen','   '],['zu lang','a'.repeat(501)]]) {
+  test(`Ungültiger Beitrag (${label}) erhält den alten Inhalt`, async () => {
+    assert.ok((await edited(content)).error);
+    assert.equal((await storedItem()).content,'Nudelsalat');
+  });
+}
+test('500 Zeichen werden vollständig gespeichert', async () => {
+  assert.equal((await edited('a'.repeat(500))).success,true);
+  assert.equal((await storedItem()).content.length,500);
+});
+for (const role of ['ELTERN','ADMIN','KOORDINATOR']) {
+  test(`${role} kann fremde Mitbringbeiträge nicht bearbeiten`, async () => {
+    current = { ...fixture.targetAdmin, role };
+    assert.match((await edited('Fremde Änderung')).error,/nur eigene/);
+    assert.equal((await storedItem()).content,'Nudelsalat');
+  });
+}
+for (const role of ['ADMIN','KOORDINATOR']) {
+  test(`${role} kann einen eigenen Mitbringbeitrag bearbeiten`, async () => {
+    await setRole(role);
+    assert.equal((await edited('Gemüsesalat')).success,true);
+  });
+}
+test('Mitbringbeiträge einer anderen Kita sind nicht bearbeitbar', async () => {
+  const kita = await prisma.kita.create({ data: { name: 'Andere Kita', slug: randomUUID() } }); tenants.push(kita.id);
+  current = { ...fixture.owner, kitaId: kita.id };
+  assert.ok((await edited('Tenant-Wechsel')).error);
+  assert.equal((await storedItem()).content,'Nudelsalat');
+});
+for (const status of ['PENDING','REJECTED']) {
+  test(`Ein ${status}-Termin erlaubt keine Bearbeitung`, async () => {
+    await prisma.termin.update({ where: { id: fixture.event.id }, data: { status } });
+    assert.match((await edited('Brot')).error,/nicht mehr aktiv/);
+    assert.equal((await storedItem()).content,'Nudelsalat');
+  });
+}
+test('Deaktivierte Mitbringliste schützt vorhandene Beiträge', async () => {
+  await prisma.termin.update({ where: { id: fixture.event.id }, data: { mitbringselListEnabled: false } });
+  assert.ok((await edited('Brot')).error);
+  assert.equal((await storedItem()).content,'Nudelsalat');
+});
+test('Gelöschter Beitrag wird nicht neu angelegt', async () => {
+  await prisma.mitbringselItem.delete({ where: { id: fixture.item.id } });
+  assert.ok((await edited('Brot')).error);
+  assert.equal(await prisma.mitbringselItem.count({ where: { id: fixture.item.id } }),0);
+});
+for (const role of ['ELTERN','ADMIN','KOORDINATOR']) {
+  test(`${role} fragt mit eigenem Haushalt einen Diensttausch an und benachrichtigt Eltern mit Verwaltungsrolle`, async () => {
+    await setRole(role);
+    assert.equal((await swap(swapPayload())).success,true);
+    const request = await prisma.notdienstSwapRequest.findFirstOrThrow({ where: { kitaId: fixture.kita.id } });
+    assert.equal(request.requesterUserId,current.id);
+    assert.equal(request.requesterFamilyId,fixture.family.id);
+    assert.deepEqual(emails.map(e => e.to).sort(),[fixture.targetAdmin.email,fixture.targetCoord.email].sort());
+    current = fixture.targetCoord;
+    assert.equal((await accept(request.id)).success,true);
+    assert.equal((await prisma.notdienstAssignment.findUniqueOrThrow({ where: { id: fixture.target.id } })).childId,fixture.child.id);
+    assert.equal((await prisma.notdienstAssignment.findUniqueOrThrow({ where: { id: fixture.offered.id } })).childId,fixture.targetChild.id);
+    assert.ok(emails.some(e => e.to === fixture.owner.email && e.subject === 'Notdienst-Tausch bestätigt'));
+  });
+}
+for (const role of ['ADMIN','KOORDINATOR']) {
+  test(`${role} ohne eigenen Haushalt erhält kein Tauschrecht`, async () => {
+    await setRole(role); current = { ...current, familyId: null };
+    assert.ok((await swap(swapPayload())).error);
+    assert.equal(await prisma.notdienstSwapRequest.count({ where: { kitaId: fixture.kita.id } }),0);
+  });
+}
+test('Erzieherrolle erhält auch mit einem Haushalt kein Tauschrecht', async () => {
+  await setRole('ERZIEHER');
+  assert.ok((await swap(swapPayload())).error);
+});
+test('Admin kann keine fremde Einteilung als eigenes Angebot verwenden', async () => {
+  await setRole('ADMIN');
+  assert.match((await swap({ targetAssignmentId: fixture.offered.id, offeredAssignmentId: fixture.target.id })).error,/nur eigene/);
+  assert.equal(await prisma.notdienstSwapRequest.count({ where: { kitaId: fixture.kita.id } }),0);
+});
+test('Koordination kann keinen Tausch innerhalb des eigenen Haushalts starten', async () => {
+  await setRole('KOORDINATOR');
+  await prisma.notdienstAssignment.update({ where: { id: fixture.target.id }, data: { childId: fixture.child.id } });
+  assert.match((await swap(swapPayload())).error,/eigenen Haushalt/);
+});
+test('Aktiver Notdienstalarm blockiert auch einen Admin-Tausch', async () => {
+  await setRole('ADMIN');
+  await prisma.notdienstAlarm.create({ data: { kitaId: fixture.kita.id, assignmentId: fixture.offered.id, activeAssignmentId: fixture.offered.id, familyId: fixture.family.id, familyName: fixture.family.name, childName: 'Eigenes Kind', date: fixture.offered.date, expiresAt: new Date('2030-11-04T18:00:00Z'), deadline: new Date('2030-11-04T10:00:00Z') } });
+  assert.match((await swap(swapPayload())).error,/aktiver Alarmierung/);
+});
+test('Unverifizierte und deaktivierte Konten bleiben vom Tausch-Mailversand ausgeschlossen', async () => {
+  await prisma.user.update({ where: { id: fixture.targetAdmin.id }, data: { emailVerifiedAt: null } });
+  await prisma.user.update({ where: { id: fixture.targetCoord.id }, data: { disabledAt: new Date() } });
+  await setRole('ADMIN');
+  assert.equal((await swap(swapPayload())).success,true);
+  assert.equal(emails.length,0);
+});
+test('Doppelte offene Anfrage bleibt auch für Koordination gesperrt', async () => {
+  await setRole('KOORDINATOR');
+  assert.equal((await swap(swapPayload())).success,true);
+  assert.match((await swap(swapPayload())).error,/offene Tauschanfrage/);
+  assert.equal(await prisma.notdienstSwapRequest.count({ where: { kitaId: fixture.kita.id } }),1);
+});

tests/family-absence-flows.integration.test.ts

@@ -0,0 +1,786 @@
+import assert from "node:assert/strict";
+import { mock, test } from "node:test";
+import { createRequire } from "node:module";
+import { resolve } from "node:path";
+import { randomUUID } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { PrismaClient, UserRole } from "@prisma/client";
+import { hashToken } from "../src/lib/tokens";
+import { absenceDate, absenceToday } from "../src/lib/absence-policy";
+
+test(
+  "Familieneinladungen und Abwesenheiten gegen isoliertes PostgreSQL",
+  { skip: !process.env.TEST_DATABASE_URL },
+  async (t) => {
+    const url = new URL(process.env.TEST_DATABASE_URL!);
+    assert.ok(["127.0.0.1", "localhost"].includes(url.hostname));
+    assert.ok(
+      /test/.test(url.pathname),
+      "Nur ausdrücklich bezeichnete Testdatenbanken",
+    );
+    process.env.DATABASE_URL = url.toString();
+    process.env.NEXT_PUBLIC_SITE_URL = "http://127.0.0.1:3010";
+    const db = new PrismaClient();
+    const suffix = randomUUID();
+    const kitaId = `flow-test-${suffix}`,
+      otherKitaId = `other-flow-${suffix}`;
+    let actor: {
+      id: string;
+      kitaId: string;
+      familyId: string | null;
+      role: UserRole;
+    };
+    const deliveries: { to: string; key: string | undefined }[] = [];
+    const fail = new Set<string>();
+    let throwTransport = false;
+    const refreshed: string[] = [];
+    const moduleMock = mock as typeof mock & {
+      module: (
+        name: string,
+        options: { namedExports: Record<string, unknown> },
+      ) => unknown;
+    };
+    moduleMock.module("../src/lib/auth-utils.ts", {
+      namedExports: {
+        requireKitaSession: async () => ({ user: actor }),
+        requireRole: async (roles: UserRole[]) => {
+          assert.ok(roles.includes(actor.role), "Rolle muss erlaubt sein");
+          return { user: actor };
+        },
+      },
+    });
+    moduleMock.module("next/cache", {
+      namedExports: { revalidatePath: (path: string) => refreshed.push(path) },
+    });
+    moduleMock.module("../src/auth.ts", {
+      namedExports: { signIn: async () => {} },
+    });
+    moduleMock.module("../src/lib/mail.ts", {
+      namedExports: {
+        sendAppEmail: async (input: {
+          to: string;
+          idempotencyKey?: string;
+        }) => {
+          deliveries.push({ to: input.to, key: input.idempotencyKey });
+          if (throwTransport) throw new Error("Simulierter Transportfehler");
+          return fail.has(input.to)
+            ? { success: false, error: "Simulierter Mailfehler" }
+            : { success: true, id: "test-only" };
+        },
+        getAppEmailConfigError: () => "Test ohne echte Mail-Konfiguration",
+      },
+    });
+    const load = createRequire(
+      resolve("tests/family-absence-flows.integration.test.ts"),
+    );
+    const familyActions = load(
+      "../src/app/dashboard/families/actions",
+    ) as typeof import("../src/app/dashboard/families/actions");
+    const absences = load(
+      "../src/actions/absences",
+    ) as typeof import("../src/actions/absences");
+    const { acceptInviteAction } = load(
+      "../src/app/invite/[token]/actions",
+    ) as typeof import("../src/app/invite/[token]/actions");
+    const { prisma } = load(
+      "../src/lib/prisma",
+    ) as typeof import("../src/lib/prisma");
+    const today = absenceToday();
+    const day = (offset: number) =>
+      new Date(absenceDate(today).getTime() + offset * 86_400_000)
+        .toISOString()
+        .slice(0, 10);
+    const actorOf = (user: {
+      id: string;
+      kitaId: string | null;
+      familyId: string | null;
+      role: UserRole;
+    }) => ({ ...user, kitaId: user.kitaId! });
+    const createUser = (
+      role: UserRole,
+      tenant = kitaId,
+      familyId: string | null = null,
+    ) =>
+      db.user.create({
+        data: {
+          kitaId: tenant,
+          familyId,
+          role,
+          email: `${randomUUID()}@example.test`,
+          passwordHash: "",
+          firstName: "Test",
+          lastName: role,
+          privacyPolicyAcceptedAt: new Date(),
+        },
+      });
+    const form = (name: string, emails: string[]) => {
+      const data = new FormData();
+      for (const [key, value] of Object.entries({
+        familyName: name,
+        parent1FirstName: "Eva",
+        parent1LastName: "Test",
+        parent1Email: emails[0],
+        childCount: "1",
+        childFirstName_0: "Kind",
+        childLastName_0: "Test",
+      }))
+        data.set(key, value);
+      if (emails[1])
+        for (const [key, value] of Object.entries({
+          parent2FirstName: "Jan",
+          parent2LastName: "Test",
+          parent2Email: emails[1],
+        }))
+          data.set(key, value);
+      return data;
+    };
+    const createAbsence = (
+      childId: string,
+      start: number,
+      end = start,
+      tenant = kitaId,
+    ) =>
+      db.absence.create({
+        data: {
+          kitaId: tenant,
+          childId,
+          startDate: absenceDate(day(start)),
+          endDate: absenceDate(day(end)),
+          reason: "ILLNESS",
+        },
+      });
+    const identity = (row: { id: string; updatedAt: Date }) => ({
+      id: row.id,
+      updatedAt: row.updatedAt.toISOString(),
+    });
+    try {
+      await db.kita.createMany({
+        data: [
+          { id: kitaId, name: "Ablauftest", slug: kitaId },
+          { id: otherKitaId, name: "Andere Kita", slug: otherKitaId },
+        ],
+      });
+      const admin = await createUser("ADMIN");
+      actor = actorOf(admin);
+      const emails = [
+        `failure-${suffix}@example.test`,
+        `success-${suffix}@example.test`,
+      ];
+      fail.add(emails[0]);
+      let invitedUsers: Awaited<ReturnType<typeof db.user.findMany>> = [];
+
+      await t.test(
+        "Mailfehler lässt Familie erfolgreich gespeichert; alle Empfänger werden versucht",
+        async () => {
+          const result = await familyActions.addFamilyAction(
+            {},
+            form("Eingeladen", emails),
+          );
+          assert.equal(result.success, true);
+          assert.ok(result.warning);
+          assert.equal(result.errors, undefined);
+          assert.equal(
+            await db.family.count({ where: { kitaId, name: "Eingeladen" } }),
+            1,
+          );
+          assert.ok(refreshed.includes("/dashboard/families"));
+          invitedUsers = await db.user.findMany({
+            where: { email: { in: emails } },
+          });
+          assert.equal(invitedUsers.length, 2);
+          const jobs = await db.invitation.findMany({
+            where: { userId: { in: invitedUsers.map((user) => user.id) } },
+          });
+          assert.equal(jobs.length, 2);
+          assert.equal(
+            jobs.find((job) => job.email === emails[0])!.failed,
+            true,
+          );
+          assert.ok(jobs.find((job) => job.email === emails[1])!.sentAt);
+          assert.equal(deliveries.length, 2);
+          const repeated = await familyActions.addFamilyAction(
+            {},
+            form("Eingeladen", emails),
+          );
+          assert.ok(repeated.errors);
+          assert.equal(
+            await db.family.count({ where: { kitaId, name: "Eingeladen" } }),
+            1,
+          );
+        },
+      );
+
+      await t.test(
+        "Gezielte Wiederholung behält den gültigen fehlgeschlagenen Link und erstellt keine Person erneut",
+        async () => {
+          const user = invitedUsers.find((user) => user.email === emails[0])!;
+          const before = await db.invitation.findUniqueOrThrow({
+            where: { userId: user.id },
+          });
+          fail.clear();
+          const result = await familyActions.resendFamilyInvitationAction(
+            user.id,
+          );
+          assert.equal(result.success, true);
+          assert.equal(result.warning, undefined);
+          const after = await db.invitation.findUniqueOrThrow({
+            where: { userId: user.id },
+          });
+          assert.equal(after.token, before.token);
+          assert.equal(after.attempts, 2);
+          assert.equal(after.failed, false);
+          assert.ok(after.sentAt);
+          assert.equal(deliveries.length, 3);
+          assert.equal(deliveries[2].key, deliveries[0].key);
+          assert.equal(
+            await db.user.count({ where: { email: user.email } }),
+            1,
+          );
+          const again = await familyActions.resendFamilyInvitationAction(
+            user.id,
+          );
+          assert.ok(again.error);
+          assert.equal(deliveries.length, 3);
+        },
+      );
+
+      await t.test(
+        "Abgelaufener Link wird erneuert und alter Token ungültig",
+        async () => {
+          const user = invitedUsers[0];
+          const before = await db.invitation.update({
+            where: { userId: user.id },
+            data: {
+              expiresAt: absenceDate(day(-1)),
+              sentAt: absenceDate(day(-2)),
+            },
+          });
+          await db.verificationToken.update({
+            where: { token: hashToken(before.token) },
+            data: { expires: absenceDate(day(-1)) },
+          });
+          assert.equal(
+            (await familyActions.resendFamilyInvitationAction(user.id)).success,
+            true,
+          );
+          const after = await db.invitation.findUniqueOrThrow({
+            where: { userId: user.id },
+          });
+          assert.notEqual(after.token, before.token);
+          assert.ok(after.expiresAt > new Date());
+          assert.equal(
+            await db.verificationToken.findUnique({
+              where: { token: hashToken(before.token) },
+            }),
+            null,
+          );
+        },
+      );
+
+      await t.test(
+        "Aktivierte und kita-fremde Konten werden nicht angeschrieben",
+        async () => {
+          const user = invitedUsers[0];
+          await db.user.update({
+            where: { id: user.id },
+            data: { emailVerifiedAt: new Date() },
+          });
+          const before = deliveries.length;
+          assert.ok(
+            (await familyActions.resendFamilyInvitationAction(user.id)).error,
+          );
+          const foreignFamily = await db.family.create({
+            data: { kitaId: otherKitaId, name: "Fremd" },
+          });
+          const foreign = await createUser(
+            "ELTERN",
+            otherKitaId,
+            foreignFamily.id,
+          );
+          assert.ok(
+            (await familyActions.resendFamilyInvitationAction(foreign.id))
+              .error,
+          );
+          assert.equal(deliveries.length, before);
+        },
+      );
+
+      await t.test(
+        "Hinzufügen eines Elternteils bei Mailfehler ist abgeschlossen und wiederholbar",
+        async () => {
+          const first = `${randomUUID()}@example.test`;
+          assert.equal(
+            (await familyActions.addFamilyAction({}, form("Ergänzen", [first])))
+              .success,
+            true,
+          );
+          const family = await db.family.findFirstOrThrow({
+            where: { kitaId, name: "Ergänzen" },
+            include: { users: true, children: true },
+          });
+          const second = `${randomUUID()}@example.test`;
+          fail.add(second);
+          const result = await familyActions.updateFamilyAction({
+            familyId: family.id,
+            familyName: family.name,
+            parents: family.users,
+            children: family.children,
+            newParents: [{ firstName: "Neu", lastName: "Test", email: second }],
+          });
+          assert.equal(result.success, true);
+          assert.ok(result.warning);
+          assert.equal(result.error, undefined);
+          assert.equal(
+            await db.user.count({ where: { familyId: family.id } }),
+            2,
+          );
+          fail.clear();
+          const parent = await db.user.findUniqueOrThrow({
+            where: { email: second },
+          });
+          assert.equal(
+            (await familyActions.resendFamilyInvitationAction(parent.id))
+              .success,
+            true,
+          );
+        },
+      );
+
+      await t.test(
+        "Adresskorrektur eines offenen Kontos erneuert die Einladung für die neue Adresse",
+        async () => {
+          const family = await db.family.findFirstOrThrow({
+            where: { kitaId, name: "Eingeladen" },
+            include: { users: true, children: true },
+          });
+          const pending = family.users.find((user) => !user.emailVerifiedAt)!;
+          const old = await db.invitation.findUniqueOrThrow({
+            where: { userId: pending.id },
+          });
+          const email = `${randomUUID()}@example.test`;
+          const result = await familyActions.updateFamilyAction({
+            familyId: family.id,
+            familyName: family.name,
+            parents: family.users.map((user) => ({
+              ...user,
+              email: user.id === pending.id ? email : user.email,
+            })),
+            children: family.children,
+          });
+          assert.equal(result.success, true);
+          const renewed = await db.invitation.findUniqueOrThrow({
+            where: { userId: pending.id },
+          });
+          assert.equal(renewed.email, email);
+          assert.notEqual(renewed.token, old.token);
+          assert.equal(
+            await db.verificationToken.findUnique({
+              where: { token: hashToken(old.token) },
+            }),
+            null,
+          );
+          assert.equal(deliveries.at(-1)!.to, email);
+        },
+      );
+
+      await t.test(
+        "Transportausnahme wird gespeichert statt den Familienvorgang zurückzuwerfen",
+        async () => {
+          throwTransport = true;
+          const result = await familyActions.addFamilyAction(
+            {},
+            form("Transportfehler", [`${randomUUID()}@example.test`]),
+          );
+          assert.equal(result.success, true);
+          assert.ok(result.warning);
+          throwTransport = false;
+        },
+      );
+
+      await t.test(
+        "Alte Einladungen werden übernommen; paralleles erneutes Senden verschickt nur einmal und Aktivierung schließt den Status ab",
+        async () => {
+          const household = await db.family.create({
+            data: { kitaId, name: "Alte Einladung" },
+          });
+          const user = await createUser("ELTERN", kitaId, household.id);
+          const oldToken = randomUUID();
+          await db.verificationToken.create({
+            data: {
+              identifier: user.id,
+              token: hashToken(oldToken),
+              expires: absenceDate(day(-1)),
+            },
+          });
+          await db.invitation.create({
+            data: {
+              kitaId,
+              email: user.email,
+              token: oldToken,
+              expiresAt: absenceDate(day(-1)),
+            },
+          });
+          const before = deliveries.length;
+          const results = await Promise.all([
+            familyActions.resendFamilyInvitationAction(user.id),
+            familyActions.resendFamilyInvitationAction(user.id),
+          ]);
+          assert.ok(results.some((result) => result.success));
+          assert.equal(deliveries.length, before + 1);
+          assert.equal(
+            await db.invitation.count({ where: { userId: user.id } }),
+            1,
+          );
+          const job = await db.invitation.findUniqueOrThrow({
+            where: { userId: user.id },
+          });
+          assert.equal(
+            await db.verificationToken.findUnique({
+              where: { token: hashToken(oldToken) },
+            }),
+            null,
+          );
+          const activation = new FormData();
+          activation.set("token", job.token);
+          activation.set("password", "Test-only-password-2026");
+          activation.set("confirmPassword", "Test-only-password-2026");
+          activation.set("acceptPrivacyPolicy", "on");
+          await acceptInviteAction({ attempt: 0 }, activation);
+          assert.ok(
+            (await db.user.findUniqueOrThrow({ where: { id: user.id } }))
+              .emailVerifiedAt,
+          );
+          assert.equal(
+            (
+              await db.invitation.findUniqueOrThrow({
+                where: { userId: user.id },
+              })
+            ).status,
+            "ACCEPTED",
+          );
+          assert.equal(
+            await db.verificationToken.findUnique({
+              where: { token: hashToken(job.token) },
+            }),
+            null,
+          );
+        },
+      );
+
+      const ownFamily = await db.family.create({
+        data: { kitaId, name: "Eigener Haushalt" },
+      });
+      const otherFamily = await db.family.create({
+        data: { kitaId, name: "Anderer Haushalt" },
+      });
+      const parent = await createUser("ELTERN", kitaId, ownFamily.id);
+      const child = await db.child.create({
+        data: {
+          kitaId,
+          familyId: ownFamily.id,
+          firstName: "Eigen",
+          lastName: "Kind",
+        },
+      });
+      const otherChild = await db.child.create({
+        data: {
+          kitaId,
+          familyId: otherFamily.id,
+          firstName: "Fremd",
+          lastName: "Kind",
+        },
+      });
+      actor = actorOf(parent);
+      let future = await createAbsence(child.id, 3, 4);
+
+      await t.test(
+        "Eltern bearbeiten zukünftige Meldungen und die eigene Tagesgrenze wird eingehalten",
+        async () => {
+          const result = await absences.updateAbsence({
+            ...identity(future),
+            startDate: day(5),
+            endDate: day(6),
+            reason: "VACATION",
+            note: "Korrigiert",
+          });
+          assert.equal(result.success, true);
+          future = await db.absence.findUniqueOrThrow({
+            where: { id: future.id },
+          });
+          assert.equal(future.startDate.toISOString().slice(0, 10), day(5));
+          assert.equal(future.note, "Korrigiert");
+          assert.ok(refreshed.includes("/dashboard/abwesenheiten"));
+          assert.ok(
+            (
+              await absences.updateAbsence({
+                ...identity(future),
+                startDate: today,
+                endDate: day(6),
+                reason: "VACATION",
+              })
+            ).error,
+          );
+        },
+      );
+
+      await t.test(
+        "Begonnene Mehrtagesmeldungen bleiben für Eltern vollständig unveränderbar",
+        async () => {
+          const running = await createAbsence(child.id, -1, 1);
+          assert.ok(
+            (
+              await absences.updateAbsence({
+                ...identity(running),
+                startDate: day(1),
+                endDate: day(2),
+                reason: "OTHER",
+              })
+            ).error,
+          );
+          assert.ok((await absences.deleteAbsence(identity(running))).error);
+          assert.equal(
+            await db.absence.count({ where: { id: running.id } }),
+            1,
+          );
+        },
+      );
+
+      await t.test(
+        "Andere Haushalte und Kitas bleiben bei Änderungen und Rücknahmen geschützt",
+        async () => {
+          const other = await createAbsence(otherChild.id, 10);
+          assert.ok((await absences.deleteAbsence(identity(other))).error);
+          assert.ok(
+            (
+              await absences.updateAbsence({
+                ...identity(other),
+                startDate: day(11),
+                endDate: day(11),
+                reason: "OTHER",
+              })
+            ).error,
+          );
+          actor = { ...actor, kitaId: otherKitaId };
+          assert.ok((await absences.deleteAbsence(identity(future))).error);
+          actor = actorOf(parent);
+          await assert.rejects(() =>
+            absences.getDailyAbsences({ date: today }),
+          );
+        },
+      );
+
+      await t.test(
+        "Ungültige Daten, Überschneidungen und veraltete Bearbeitungsstände werden abgewiesen",
+        async () => {
+          await createAbsence(child.id, 8, 9);
+          assert.ok(
+            (
+              await absences.updateAbsence({
+                ...identity(future),
+                startDate: day(8),
+                endDate: day(8),
+                reason: "OTHER",
+              })
+            ).error,
+          );
+          assert.ok(
+            (
+              await absences.updateAbsence({
+                ...identity(future),
+                startDate: "2026-02-30",
+                endDate: day(8),
+                reason: "OTHER",
+              })
+            ).error,
+          );
+          assert.ok(
+            (
+              await absences.updateAbsence({
+                ...identity(future),
+                startDate: day(7),
+                endDate: day(6),
+                reason: "OTHER",
+              })
+            ).error,
+          );
+          assert.ok(
+            (
+              await absences.deleteAbsence({
+                id: future.id,
+                updatedAt: "2000-01-01T00:00:00.000Z",
+              })
+            ).error,
+          );
+          assert.equal(await db.absence.count({ where: { id: future.id } }), 1);
+        },
+      );
+
+      await t.test(
+        "Gleichzeitige Abmeldungen erzeugen höchstens eine überlappende Meldung",
+        async () => {
+          const payload = {
+            childId: child.id,
+            startDate: day(20),
+            endDate: day(22),
+            reason: "ILLNESS",
+          };
+          const results = await Promise.all([
+            absences.reportAbsence(payload),
+            absences.reportAbsence(payload),
+          ]);
+          assert.equal(results.filter((result) => result.success).length, 1);
+          assert.equal(results.filter((result) => result.error).length, 1);
+          assert.equal(
+            await db.absence.count({
+              where: { childId: child.id, startDate: absenceDate(day(20)) },
+            }),
+            1,
+          );
+          assert.ok(
+            (
+              await absences.reportAbsence({
+                ...payload,
+                startDate: day(-2),
+                endDate: day(-2),
+              })
+            ).error,
+          );
+          assert.ok(
+            (
+              await absences.reportAbsence({
+                ...payload,
+                childId: otherChild.id,
+              })
+            ).error,
+          );
+        },
+      );
+
+      await t.test(
+        "Kita-Team korrigiert laufende Meldungen ohne eigenen Haushalt; Eltern ziehen zukünftige zurück",
+        async () => {
+          const running = await db.absence.findFirstOrThrow({
+            where: { childId: child.id, startDate: absenceDate(day(-1)) },
+          });
+          for (const role of [
+            "ADMIN",
+            "KOORDINATOR",
+            "ERZIEHER",
+          ] as UserRole[]) {
+            const team = role === "ADMIN" ? admin : await createUser(role);
+            actor = actorOf(team);
+            const latest = await db.absence.findUniqueOrThrow({
+              where: { id: running.id },
+            });
+            assert.equal(
+              (
+                await absences.updateAbsence({
+                  ...identity(latest),
+                  startDate: day(-1),
+                  endDate: day(2),
+                  reason: "OTHER",
+                  note: role,
+                })
+              ).success,
+              true,
+            );
+            assert.equal(
+              (await absences.getDailyAbsences({ date: today })).absences![0]
+                .startDate,
+              day(-1),
+            );
+          }
+          actor = actorOf(parent);
+          assert.equal(
+            (await absences.deleteAbsence(identity(future))).success,
+            true,
+          );
+          assert.equal(
+            await db.absence.findUnique({ where: { id: future.id } }),
+            null,
+          );
+        },
+      );
+
+      await t.test(
+        "Ein veraltetes Rollen-Token verleiht keine Teamrechte",
+        async () => {
+          actor = { ...actorOf(parent), role: "ADMIN" };
+          const running = await db.absence.findFirstOrThrow({
+            where: { childId: child.id, startDate: absenceDate(day(-1)) },
+          });
+          assert.ok((await absences.deleteAbsence(identity(running))).error);
+          assert.ok(
+            (
+              await familyActions.resendFamilyInvitationAction(
+                invitedUsers[1].id,
+              )
+            ).error,
+          );
+        },
+      );
+      await t.test(
+        "Additives Upgrade funktioniert auf leerem und bestehendem Schema und ist wiederholbar",
+        async () => {
+          const sql = await readFile(
+            resolve("deploy/sql/familieneinladungen.sql"),
+            "utf8",
+          );
+          const schema = `upgrade_test_${suffix.replaceAll("-", "")}`;
+          await db.$executeRawUnsafe(`CREATE SCHEMA "${schema}"`);
+          try {
+            await db.$transaction(async (tx) => {
+              await tx.$executeRawUnsafe(
+                `SET LOCAL search_path TO "${schema}"`,
+              );
+              await tx.$executeRawUnsafe(sql);
+              const fresh = await tx.$queryRawUnsafe<
+                { relation: string | null }[]
+              >("SELECT to_regclass('invitations')::text AS relation");
+              assert.equal(fresh[0].relation, null);
+              await tx.$executeRawUnsafe(
+                'CREATE TABLE "users" ("id" TEXT PRIMARY KEY)',
+              );
+              await tx.$executeRawUnsafe(
+                'CREATE TABLE "invitations" ("id" TEXT PRIMARY KEY, "token" TEXT NOT NULL)',
+              );
+              await tx.$executeRawUnsafe(
+                "INSERT INTO \"invitations\" (\"id\", \"token\") VALUES ('a', 'old-a'), ('b', 'old-b')",
+              );
+              await tx.$executeRawUnsafe(sql);
+              await tx.$executeRawUnsafe(sql);
+              const rows = await tx.$queryRawUnsafe<
+                {
+                  token: string;
+                  userId: string | null;
+                  failed: boolean;
+                  attempts: number;
+                }[]
+              >(
+                'SELECT "token", "userId", "failed", "attempts" FROM "invitations" ORDER BY "id"',
+              );
+              assert.deepEqual(rows, [
+                { token: "old-a", userId: null, failed: false, attempts: 0 },
+                { token: "old-b", userId: null, failed: false, attempts: 0 },
+              ]);
+            });
+          } finally {
+            await db.$executeRawUnsafe(`DROP SCHEMA "${schema}" CASCADE`);
+          }
+        },
+      );
+    } finally {
+      const users = await db.user.findMany({
+        where: { kitaId: { in: [kitaId, otherKitaId] } },
+        select: { id: true },
+      });
+      await db.verificationToken.deleteMany({
+        where: { identifier: { in: users.map((user) => user.id) } },
+      });
+      await db.kita.deleteMany({
+        where: { id: { in: [kitaId, otherKitaId] } },
+      });
+      await Promise.all([db.$disconnect(), prisma.$disconnect()]);
+    }
+  },
+);

tests/mail-transport.test.cjs

@@ -0,0 +1,55 @@
+/* eslint-disable @typescript-eslint/no-require-imports -- Execute the installed SDK and real TypeScript mail adapter. */
+const { test, before, after }=require('node:test');const assert=require('node:assert/strict');
+const fs=require('node:fs'),path=require('node:path'),vm=require('node:vm'),ts=require('typescript');
+let prisma; // The mail adapter never accesses a database.
+function loader(overrides = {}) {
+  const cache = new Map();
+  function load(file) {
+    file = path.resolve(file);
+    if (cache.has(file)) return cache.get(file).exports;
+    const mod = { exports: {} }; cache.set(file, mod);
+    const code = ts.transpileModule(fs.readFileSync(file, 'utf8'), {
+      compilerOptions: { target: ts.ScriptTarget.ES2022, module: ts.ModuleKind.CommonJS, jsx: ts.JsxEmit.ReactJSX, esModuleInterop: true },
+      fileName: file,
+    }).outputText;
+    const req = spec => {
+      if (Object.hasOwn(overrides, spec)) return overrides[spec];
+      if (spec === 'server-only') return {};
+      if (spec === '@/lib/prisma') return { prisma };
+      if (spec === 'next/headers') return { headers: async () => new Headers() };
+      if (spec === 'next/cache') return { revalidatePath() {} };
+      if (spec === 'next/navigation') return { redirect(url) { throw new Error(`REDIRECT:${url}`); }, notFound() { throw new Error('NOT_FOUND'); } };
+      if (spec.startsWith('@/') || spec.startsWith('.')) {
+        const target = spec.startsWith('@/') ? path.resolve('src', spec.slice(2)) : path.resolve(path.dirname(file), spec);
+        for (const suffix of ['.ts', '.tsx', '/index.ts']) if (fs.existsSync(target + suffix)) return load(target + suffix);
+      }
+      return require(spec);
+    };
+    vm.runInThisContext(`(function(require,module,exports){${code}\n})`, { filename: file })(req, mod, mod.exports);
+    return mod.exports;
+  }
+  return load;
+}
+
+const originalFetch=global.fetch;const saved=Object.fromEntries(['RESEND_API_KEY','EMAIL_FROM','NODE_ENV'].map(k=>[k,process.env[k]]));let send;
+before(()=>{process.env.RESEND_API_KEY='re_test_not_real';process.env.EMAIL_FROM='Test <test@example.invalid>';process.env.NODE_ENV='test';send=loader()('src/lib/mail.ts').sendAppEmail;});
+after(()=>{global.fetch=originalFetch;for(const [k,v] of Object.entries(saved)){if(v===undefined)delete process.env[k];else process.env[k]=v;}});
+const input={to:'recipient@example.invalid',subject:'Test',react:'Test',idempotencyKey:'stable-job'};
+test('SDK receives the stable key and an AbortSignal on the actual fetch call',async()=>{
+ let captured;global.fetch=async(_url,options)=>{captured=options;return new Response(JSON.stringify({id:'test-id'}),{status:200});};
+ assert.equal((await send(input)).success,true);assert.ok(captured.signal instanceof AbortSignal);assert.match(new Headers(captured.headers).get('Idempotency-Key'),/^stable-job\/[a-f0-9]{64}$/);
+});
+test('Transport timeout aborts the pending fetch rather than merely abandoning its promise',async()=>{
+ let aborted=false;global.fetch=async(_url,options)=>new Promise((_resolve,reject)=>options.signal.addEventListener('abort',()=>{aborted=true;reject(options.signal.reason);},{once:true}));
+ const keepAlive=setTimeout(()=>{},1000);try{assert.equal((await send({...input,timeoutMs:20})).success,false);assert.equal(aborted,true);}finally{clearTimeout(keepAlive);}
+});
+test('Array recipients have distinct stable keys and duplicate addresses are removed',async()=>{
+ const keys=[];global.fetch=async(_url,options)=>{keys.push(new Headers(options.headers).get('Idempotency-Key'));return new Response(JSON.stringify({id:'test'}),{status:200});};
+ const message={...input,to:['one@example.invalid','two@example.invalid','one@example.invalid']};await send(message);await send(message);
+ assert.equal(keys.length,4);assert.notEqual(keys[0],keys[1]);assert.equal(keys[0],keys[2]);assert.equal(keys[1],keys[3]);
+});
+
+test('Corrected message payload receives a new version without changing stable retries',async()=>{
+ const keys=[];global.fetch=async(_url,options)=>{keys.push(new Headers(options.headers).get('Idempotency-Key'));return new Response(JSON.stringify({id:'test'}),{status:200});};
+ await send(input);await send(input);await send({...input,react:'Corrected dates'});assert.equal(keys[0],keys[1]);assert.notEqual(keys[1],keys[2]);
+});

tests/notdienst-days.test.ts

@@ -0,0 +1,55 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { getNotdienstDays } from "../src/lib/notdienst-days";
+
+const keys = (year: number, month: number, start: string, end: string) =>
+  getNotdienstDays(year, month, [
+    { startDate: new Date(start), endDate: new Date(end) },
+  ]).map((d) => d.toISOString().slice(0, 10));
+
+test("Schließtage schließen inklusive beider Randtage aus", () => {
+  const days = keys(2030, 11, "2030-11-04T10:00:00Z", "2030-11-06T12:00:00Z");
+  for (const key of ["2030-11-04", "2030-11-05", "2030-11-06"])
+    assert.ok(!days.includes(key));
+  assert.ok(days.includes("2030-11-07"));
+  assert.ok(days.every((key) => ![0, 6].includes(new Date(key).getUTCDay())));
+});
+
+test("Berliner Mitternacht am Monatsanfang zählt zum richtigen Monat", () => {
+  const days = keys(2030, 11, "2030-10-31T23:00:00Z", "2030-11-01T22:59:00Z");
+  assert.ok(!days.includes("2030-11-01"));
+  assert.ok(days.includes("2030-11-04"));
+});
+
+test("Sommerzeit und Schließzeiten über Monatsgrenzen", () => {
+  const days = keys(2030, 7, "2030-06-28T22:00:00Z", "2030-07-02T21:59:00Z");
+  assert.ok(!days.includes("2030-07-01"));
+  assert.ok(!days.includes("2030-07-02"));
+  assert.ok(days.includes("2030-07-03"));
+});
+
+test("Überlappende Schließtermine erzeugen keine doppelten Tage", () => {
+  const closures = [
+    { startDate: new Date("2030-11-04"), endDate: new Date("2030-11-05") },
+    { startDate: new Date("2030-11-05"), endDate: new Date("2030-11-06") },
+  ];
+  const days = getNotdienstDays(2030, 11, closures);
+  assert.equal(new Set(days.map(Number)).size, days.length);
+  assert.equal(days.length, getNotdienstDays(2030, 11, []).length - 3);
+});
+
+
+test("Berliner Monatswechsel bestimmt Zielmonat und Sperrfrist", async () => {
+  const { getTargetMonthData } = await import("../src/lib/date-utils");
+  assert.equal(getTargetMonthData(new Date("2030-10-26T22:00:00Z")).isLocked, true);
+  const data = getTargetMonthData(new Date("2030-12-31T23:00:00Z"));
+  assert.equal(data.targetYear, 2031); assert.equal(data.targetMonth, 2);
+});
+
+test("Automatische Erinnerung beginnt um 9 Uhr vor der Eintragsfrist", async () => {
+  const { isNotdienstReminderDue } = await import("../src/lib/date-utils");
+  assert.equal(isNotdienstReminderDue(7, new Date("2030-10-18T07:00:00Z")), false);
+  assert.equal(isNotdienstReminderDue(7, new Date("2030-10-19T06:59:00Z")), false);
+  assert.equal(isNotdienstReminderDue(7, new Date("2030-10-19T07:00:00Z")), true);
+  assert.equal(isNotdienstReminderDue(0, new Date("2030-10-19T07:00:00Z")), false);
+});

tests/notdienst-notifications.integration.test.cjs

@@ -0,0 +1,217 @@
+/* eslint-disable @typescript-eslint/no-require-imports -- Load real server actions with isolated request and mail transport boundaries. */
+const { test, before, beforeEach, after } = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('node:fs'); const path = require('node:path'); const vm = require('node:vm');
+const ts = require('typescript'); const { randomUUID } = require('node:crypto');
+const { PrismaClient } = require('@prisma/client');
+const { render } = require('@react-email/render');
+let prisma, current, f, service, publish, retry;
+let failMail = false; const emails = [], tenants = [];
+function loader(overrides = {}) {
+  const cache = new Map();
+  function load(file) {
+    file = path.resolve(file);
+    if (cache.has(file)) return cache.get(file).exports;
+    const mod = { exports: {} }; cache.set(file, mod);
+    const code = ts.transpileModule(fs.readFileSync(file, 'utf8'), {
+      compilerOptions: { target: ts.ScriptTarget.ES2022, module: ts.ModuleKind.CommonJS, jsx: ts.JsxEmit.ReactJSX, esModuleInterop: true },
+      fileName: file,
+    }).outputText;
+    const req = spec => {
+      if (Object.hasOwn(overrides, spec)) return overrides[spec];
+      if (spec === 'server-only') return {};
+      if (spec === '@/lib/prisma') return { prisma };
+      if (spec === 'next/headers') return { headers: async () => new Headers() };
+      if (spec === 'next/cache') return { revalidatePath() {} };
+      if (spec === 'next/navigation') return { redirect(url) { throw new Error(`REDIRECT:${url}`); }, notFound() { throw new Error('NOT_FOUND'); } };
+      if (spec.startsWith('@/') || spec.startsWith('.')) {
+        const target = spec.startsWith('@/') ? path.resolve('src', spec.slice(2)) : path.resolve(path.dirname(file), spec);
+        for (const suffix of ['.ts', '.tsx', '/index.ts']) if (fs.existsSync(target + suffix)) return load(target + suffix);
+      }
+      return require(spec);
+    };
+    vm.runInThisContext(`(function(require,module,exports){${code}\n})`, { filename: file })(req, mod, mod.exports);
+    return mod.exports;
+  }
+  return load;
+}
+
+const now = new Date('2030-10-19T07:00:00Z');
+const sender = async input => { emails.push(input); return failMail ? { success: false, error: 'Test mail failure' } : { success: true, id: 'simulated' }; };
+before(async () => {
+  const raw=process.env.TEST_DATABASE_URL;
+  if (!raw) throw new Error('TEST_DATABASE_URL muss auf die separate lokale kita_notifications_test zeigen.');
+  const url=new URL(raw); assert.ok(['127.0.0.1','localhost'].includes(url.hostname)); assert.equal(url.pathname,'/kita_notifications_test');
+  process.env.AUTH_URL='http://127.0.0.1:3014'; prisma=new PrismaClient({datasourceUrl:raw});
+  const load=loader({ '@/lib/auth-utils': { requireKitaSession:async()=>({user:current}), requireRole:async roles=>{assert.ok(roles.includes(current.role));return {user:current};} }, '@/lib/mail':{sendAppEmail:sender} });
+  service=load('src/lib/notdienst-notifications.ts');
+  ({publishPlanAction:publish,retryNotdienstEmailsAction:retry}=load('src/app/dashboard/notdienst/plan/actions.ts'));
+});
+after(async()=>{if(prisma){await prisma.kita.deleteMany({where:{id:{in:tenants}}});await prisma.$disconnect();}});
+beforeEach(async()=>{
+  failMail=false;emails.length=0;
+  const kita=await prisma.kita.create({data:{name:'Benachrichtigungen Test',slug:randomUUID(),notdienstMinPerChildPerMonth:3,notdienstReminderDaysBefore:7}});tenants.push(kita.id);
+  const family=await prisma.family.create({data:{kitaId:kita.id,name:'Testhaushalt'}});
+  const parent=await prisma.user.create({data:{kitaId:kita.id,familyId:family.id,role:'ADMIN',email:`${randomUUID()}@example.invalid`,firstName:'Test',lastName:'Admin',passwordHash:'test',emailVerifiedAt:new Date(),privacyPolicyAcceptedAt:new Date()}});
+  const children=await Promise.all(['A','B'].map(firstName=>prisma.child.create({data:{kitaId:kita.id,familyId:family.id,firstName,lastName:'Test'}})));
+  f={kita,family,parent,children};current=parent;
+});
+const jobs=()=>prisma.notdienstEmail.findMany({where:{kitaId:f.kita.id},orderBy:{createdAt:'asc'}});
+const manual=(time=now)=>service.queueNotdienstReminders(f.kita.id,2030,11,false,time);
+const auto=(time=now)=>service.runNotdienstNotificationJob(sender,time,f.kita.id);
+async function availability(keys,child=f.children[0]){await prisma.notdienstAvailability.createMany({data:keys.map(key=>({kitaId:f.kita.id,childId:child.id,userId:f.parent.id,date:new Date(key)})),skipDuplicates:true});}
+async function draft(){return prisma.notdienstPlan.create({data:{kitaId:f.kita.id,year:2030,month:11,assignments:{create:[{kitaId:f.kita.id,childId:f.children[0].id,date:new Date('2030-11-04')},{kitaId:f.kita.id,childId:f.children[1].id,date:new Date('2030-11-05')}]}}});}
+async function partner(role='KOORDINATOR'){return prisma.user.create({data:{kitaId:f.kita.id,familyId:f.family.id,role,email:`${randomUUID()}@example.invalid`,firstName:'Partner',lastName:role,passwordHash:'test',emailVerifiedAt:new Date(),privacyPolicyAcceptedAt:new Date()}});}
+
+test('Automatik erinnert den fehlenden Haushalt genau einmal im Monat',async()=>{
+  const first=await auto();assert.equal(first.queued,1);assert.equal(first.sent,1);
+  assert.equal((await auto()).queued,0);assert.equal((await auto(new Date('2030-10-20T07:00:00Z'))).queued,0);
+  assert.equal(emails.length,1);assert.equal(await prisma.notdienstReminderRun.count({where:{kitaId:f.kita.id}}),1);
+});
+test('Zu wenige gültige Tage werden als unvollständig erkannt; Mail enthält Soll und Frist',async()=>{
+  await availability(['2030-11-04','2030-11-05']);assert.equal((await auto()).sent,1);
+  const html=(await render(emails[0].react)).replace(/<!--.*?-->/g,'');assert.ok(html.includes('2 von 6'));assert.ok(html.includes('26.10.2030'));
+});
+test('Vollständige sechs Tage werden nicht erinnert',async()=>{
+  await availability(['2030-11-04','2030-11-05','2030-11-06','2030-11-07','2030-11-08','2030-11-11']);
+  assert.equal((await auto()).queued,0);assert.equal(emails.length,0);
+});
+test('Geschwister-Doppelbuchungen und alte Wochenenddaten reduzieren das Soll nicht',async()=>{
+  await availability(['2030-11-04','2030-11-05','2030-11-02']);await availability(['2030-11-04','2030-11-05','2030-11-03'],f.children[1]);
+  const progress=await service.getFamilyNotdienstProgress(prisma,f.kita.id,f.family.id,2030,11,3);assert.deepEqual(progress,{selected:2,required:6});
+  assert.equal((await auto()).sent,1);
+});
+test('Vor 9 Uhr Berliner Zeit und vor Erinnerungstag wird nichts vorbereitet',async()=>{
+  assert.equal((await auto(new Date('2030-10-19T06:59:00Z'))).queued,0);
+  assert.equal((await auto(new Date('2030-10-18T07:00:00Z'))).queued,0);assert.equal((await jobs()).length,0);
+});
+test('Verpasster Erinnerungstag wird bis zum 26. nachgeholt',async()=>{assert.equal((await auto(new Date('2030-10-25T07:00:00Z'))).sent,1);});
+test('Nach der Sperrfrist werden keine Erinnerungen vorbereitet',async()=>{
+  assert.equal((await auto(new Date('2030-10-27T09:00:00Z'))).queued,0);
+  await assert.rejects(manual(new Date('2030-10-27T09:00:00Z')),/Eintragsfrist/);
+});
+test('0 schaltet automatische Erinnerungen ab; manueller Versand bleibt möglich',async()=>{
+  await prisma.kita.update({where:{id:f.kita.id},data:{notdienstReminderDaysBefore:0}});
+  assert.equal((await auto()).queued,0);assert.equal(await manual(),1);
+});
+test('Deaktiviertes Modul wird weder vorbereitet noch versendet',async()=>{
+  await manual();await prisma.kita.update({where:{id:f.kita.id},data:{notdienstModuleEnabled:false}});
+  assert.equal((await auto()).sent,0);assert.equal(emails.length,0);assert.ok((await jobs())[0].skippedAt);
+});
+test('Admin- und Koordinationskonten desselben Haushalts erhalten die Erinnerung',async()=>{
+  const p=await partner();assert.equal((await auto()).sent,2);assert.deepEqual(emails.map(e=>e.to).sort(),[p.email,f.parent.email].sort());
+});
+test('Unverifizierte, gesperrte, deaktivierte und Erzieherkonten werden nicht angeschrieben',async()=>{
+  await partner('ERZIEHER');await prisma.user.update({where:{id:f.parent.id},data:{lockedUntil:new Date('2031-01-01')}});
+  assert.equal((await auto()).sent,0);assert.equal(emails.length,0);
+});
+test('Manuell und automatisch am selben Tag erzeugen nur einen Auftrag je Konto',async()=>{
+  assert.equal(await manual(),1);assert.equal(await manual(),0);assert.equal((await auto()).queued,0);assert.equal(emails.length,1);
+});
+test('Parallele automatische Läufe erzeugen nur eine Mailrunde',async()=>{
+  const results=await Promise.all([auto(),auto()]);assert.equal(results.reduce((n,r)=>n+r.queued,0),1);assert.equal(emails.length,1);
+});
+test('Bei inzwischen vollständiger Auswahl wird ein gespeicherter Reminder übersprungen',async()=>{
+  await manual();await availability(['2030-11-04','2030-11-05','2030-11-06','2030-11-07','2030-11-08','2030-11-11']);
+  assert.equal((await service.deliverDueNotdienstEmails({kitaId:f.kita.id},sender,now)).skipped,1);assert.equal(emails.length,0);
+});
+test('Haushaltswechsel und fehlende Mailbestätigung machen einen Auftrag ungültig',async()=>{
+  await manual();await prisma.user.update({where:{id:f.parent.id},data:{emailVerifiedAt:null}});
+  assert.equal((await service.deliverDueNotdienstEmails({kitaId:f.kita.id},sender,now)).skipped,1);assert.equal(emails.length,0);
+});
+test('Versandfehler bleibt sichtbar; Wiederholung verwendet denselben Idempotenzschlüssel',async()=>{
+  await manual();failMail=true;const first=await service.deliverDueNotdienstEmails({kitaId:f.kita.id},sender,now);assert.equal(first.failed,1);
+  const failed=(await jobs())[0];assert.equal(failed.failed,true);assert.ok(failed.nextAttemptAt>now);assert.equal(failed.sentAt,null);
+  assert.equal((await service.getNotdienstEmailStatus(f.kita.id,2030,11)).failed,1);
+  assert.equal((await service.deliverDueNotdienstEmails({kitaId:f.kita.id},sender,now)).sent,0);
+  failMail=false;assert.equal((await service.deliverDueNotdienstEmails({kitaId:f.kita.id},sender,failed.nextAttemptAt)).sent,1);
+  assert.equal(emails[0].idempotencyKey,emails[1].idempotencyKey);assert.equal((await jobs())[0].failed,false);
+});
+test('Paralleler Versand reserviert einen Auftrag nur einmal',async()=>{
+  await manual();const id=(await jobs())[0].id;let count=0;
+  const slow=async()=>{count++;await new Promise(r=>setTimeout(r,20));return {success:true};};
+  await Promise.all([service.deliverNotdienstEmails([id],slow,now),service.deliverNotdienstEmails([id],slow,now)]);assert.equal(count,1);
+});
+test('Abgelaufene Reservierung nach Worker-Abbruch wird wieder aufgenommen',async()=>{
+  await manual();const id=(await jobs())[0].id;await prisma.notdienstEmail.update({where:{id},data:{leaseUntil:new Date(now.getTime()-1000),claimToken:'old'}});
+  assert.equal((await service.deliverDueNotdienstEmails({kitaId:f.kita.id},sender,now)).sent,1);
+});
+test('Eine fehlerhafte Adresse blockiert die zweite Person nicht',async()=>{
+  await partner();await manual();const result=await service.deliverDueNotdienstEmails({kitaId:f.kita.id},async input=>{emails.push(input);return input.to===f.parent.email?{success:false,error:'failure'}:{success:true};},now);
+  assert.equal(result.failed,1);assert.equal(result.sent,1);
+});
+test('Veröffentlichung fasst Geschwisterdienste pro Konto in einer Mail zusammen',async()=>{
+  const p=await partner();const plan=await draft();assert.equal((await publish(plan.id)).success,true);assert.equal(emails.length,2);
+  const html=await render(emails[0].react);assert.ok(html.includes('04.11.2030'));assert.ok(html.includes('05.11.2030'));
+  assert.deepEqual(emails.map(e=>e.to).sort(),[p.email,f.parent.email].sort());assert.equal((await jobs()).filter(j=>j.kind==='PUBLICATION').length,2);
+});
+test('Mehrfaches und paralleles Veröffentlichen erzeugt keine doppelten Mails',async()=>{
+  const plan=await draft();const result=await Promise.all([publish(plan.id),publish(plan.id)]);assert.ok(result.every(r=>r.success));
+  assert.equal((await jobs()).length,1);assert.equal(emails.length,1);assert.equal((await publish(plan.id)).success,true);assert.equal(emails.length,1);
+});
+test('Mailfehler macht einen veröffentlichten Plan nicht rückgängig',async()=>{
+  const plan=await draft();failMail=true;const result=await publish(plan.id);assert.equal(result.success,true);assert.equal(result.failed,1);
+  assert.equal((await prisma.notdienstPlan.findUniqueOrThrow({where:{id:plan.id}})).status,'PUBLISHED');assert.equal((await jobs())[0].failed,true);
+  failMail=false;assert.equal((await retry(2030,11)).sent,1);assert.equal((await jobs())[0].sentAt!==null,true);
+});
+test('Beim Speichern der Mailaufträge fehlgeschlagene Veröffentlichung bleibt Entwurf',async()=>{
+  const plan=await draft();const load=loader({'@/lib/auth-utils':{requireRole:async()=>({user:current})},'@/lib/notdienst-notifications':{queueNotdienstPublication:async()=>{throw new Error('Test storage failure');}}});
+  const action=load('src/app/dashboard/notdienst/plan/actions.ts').publishPlanAction;assert.ok((await action(plan.id)).error);
+  assert.equal((await prisma.notdienstPlan.findUniqueOrThrow({where:{id:plan.id}})).status,'DRAFT');
+});
+test('Veröffentlichter Plan verhindert weitere automatische Erinnerungen',async()=>{
+  const plan=await draft();await publish(plan.id);emails.length=0;assert.equal((await auto()).queued,0);assert.equal(emails.length,0);
+});
+test('Einteilung wird vor einem Wiederholungsversuch erneut geprüft',async()=>{
+  const plan=await draft();failMail=true;await publish(plan.id);const job=(await jobs())[0];
+  await prisma.notdienstAssignment.deleteMany({where:{planId:plan.id}});failMail=false;
+  assert.equal((await service.deliverNotdienstEmails([job.id],sender,job.nextAttemptAt)).skipped,1);assert.equal(emails.length,1);
+});
+test('Empfänger sehen bei Wiederholung die aktuelle eigene Einteilung',async()=>{
+  const plan=await draft();failMail=true;await publish(plan.id);const job=(await jobs())[0];
+  await prisma.notdienstAssignment.deleteMany({where:{planId:plan.id,date:new Date('2030-11-04')}});failMail=false;
+  await service.deliverNotdienstEmails([job.id],sender,job.nextAttemptAt);const html=await render(emails[1].react);
+  assert.ok(!html.includes('04.11.2030'));assert.ok(html.includes('05.11.2030'));
+});
+test('Kein Auftrag für Haushalte ohne eigene Einteilung',async()=>{
+  const plan=await prisma.notdienstPlan.create({data:{kitaId:f.kita.id,year:2030,month:11}});await publish(plan.id);assert.equal((await jobs()).length,0);
+});
+test('Datenbank verhindert Empfängerbeziehungen zu einer fremden Kita',async()=>{
+  const other=await prisma.kita.create({data:{name:'Andere Kita',slug:randomUUID()}});tenants.push(other.id);
+  await assert.rejects(prisma.notdienstEmail.create({data:{kitaId:other.id,familyId:f.family.id,userId:f.parent.id,year:2030,month:11,kind:'REMINDER',eventKey:'cross-tenant'}}));
+});
+test('Wiederholungsaktion begrenzt den Versand auf die eigene Kita',async()=>{
+  const own=await draft();failMail=true;await publish(own.id);const other=await prisma.kita.create({data:{name:'Andere Kita',slug:randomUUID()}});tenants.push(other.id);
+  const beforeCount=emails.length;current={...current,kitaId:other.id};failMail=false;assert.equal((await retry(2030,11)).sent,0);assert.equal(emails.length,beforeCount);
+});
+test('Monatswechsel und Jahreswechsel verwenden Berliner Kalenderdaten',async()=>{
+  const dateUtils=loader()('src/lib/date-utils.ts');const target=dateUtils.getTargetMonthData(new Date('2030-12-31T23:00:00Z'));
+  assert.equal(target.targetYear,2031);assert.equal(target.targetMonth,2);
+  assert.equal(dateUtils.isNotdienstReminderDue(7,new Date('2030-10-26T22:00:00Z')),false);
+});
+
+test('Noch nicht fällige Kitas verdrängen fällige Erinnerungen nicht aus dem Batch',async()=>{
+ const rows=Array.from({length:101},(_,i)=>({id:`000-not-due-${randomUUID()}-${i}`,name:'Noch nicht fällig',slug:randomUUID(),notdienstReminderDaysBefore:1}));
+ await prisma.kita.createMany({data:rows});tenants.push(...rows.map(r=>r.id));
+ await service.runNotdienstNotificationJob(sender,now);
+ assert.equal(await prisma.notdienstReminderRun.count({where:{kitaId:f.kita.id,year:2030,month:11}}),1);
+ assert.equal((await jobs()).filter(j=>j.kind==='REMINDER').length,1);
+});
+test('Geschützter Job startet ohne gültiges Secret keine Verarbeitung',async()=>{
+ const authorization=loader()('src/lib/alarms/job.ts').authorizeAlarmJob;let called=0;
+ const route=loader({'@/lib/alarms/job':{authorizeAlarmJob:authorization,runAlarmJob:async()=>{called++;return {};}},'@/lib/notdienst-notifications':{runNotdienstNotificationJob:async()=>{called++;return {};}}})('src/app/api/jobs/notdienstalarme/route.ts').POST;
+ const old=process.env.NOTDIENST_JOB_SECRET;
+ try{delete process.env.NOTDIENST_JOB_SECRET;assert.equal((await route(new Request('http://127.0.0.1/api/jobs/notdienstalarme',{method:'POST'}))).status,503);
+ process.env.NOTDIENST_JOB_SECRET='test-only-secret-32-characters-long';assert.equal((await route(new Request('http://127.0.0.1/api/jobs/notdienstalarme',{method:'POST',headers:{authorization:'Bearer wrong'}}))).status,401);assert.equal(called,0);
+ const result=await route(new Request('http://127.0.0.1/api/jobs/notdienstalarme',{method:'POST',headers:{authorization:`Bearer ${process.env.NOTDIENST_JOB_SECRET}`}}));assert.equal(result.status,200);assert.equal(called,2);
+ }finally{if(old===undefined)delete process.env.NOTDIENST_JOB_SECRET;else process.env.NOTDIENST_JOB_SECRET=old;}
+});
+
+test('Zusammengesetzte Mail-Fremdschlüssel schützen auch Nutzer und Plan separat',async()=>{
+ const other=await prisma.kita.create({data:{name:'Fremde Kita',slug:randomUUID()}});tenants.push(other.id);
+ const foreignUser=await prisma.user.create({data:{kitaId:other.id,email:`${randomUUID()}@example.invalid`,firstName:'Foreign',lastName:'Test',passwordHash:'test'}});
+ const foreignPlan=await prisma.notdienstPlan.create({data:{kitaId:other.id,year:2030,month:11}});
+ const base={kitaId:f.kita.id,familyId:f.family.id,userId:f.parent.id,year:2030,month:11,kind:'REMINDER',eventKey:'tenant-check'};
+ await assert.rejects(prisma.notdienstEmail.create({data:{...base,userId:foreignUser.id}}),e=>e.code==='P2003');
+ await assert.rejects(prisma.notdienstEmail.create({data:{...base,kind:'PUBLICATION',planId:foreignPlan.id}}),e=>e.code==='P2003');
+});

tests/notdienst-planning.integration.test.cjs

@@ -0,0 +1,281 @@
+/* eslint-disable @typescript-eslint/no-require-imports -- Load real server actions with isolated request and mail boundaries. */
+const { test, before, after, beforeEach } = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+const vm = require('node:vm');
+const ts = require('typescript');
+const { PrismaClient } = require('@prisma/client');
+const { randomUUID } = require('node:crypto');
+let prisma, current, fixture, save, generate, publish, assign, removeChild, updateFamily, days;
+const tenants = [];
+function loader(overrides = {}) {
+  const cache = new Map();
+  function load(file) {
+    file = path.resolve(file);
+    if (cache.has(file)) return cache.get(file).exports;
+    const mod = { exports: {} }; cache.set(file, mod);
+    const code = ts.transpileModule(fs.readFileSync(file, 'utf8'), {
+      compilerOptions: { target: ts.ScriptTarget.ES2022, module: ts.ModuleKind.CommonJS, jsx: ts.JsxEmit.ReactJSX, esModuleInterop: true },
+      fileName: file,
+    }).outputText;
+    const req = spec => {
+      if (Object.hasOwn(overrides, spec)) return overrides[spec];
+      if (spec === 'server-only') return {};
+      if (spec === '@/lib/prisma') return { prisma };
+      if (spec === 'next/headers') return { headers: async () => new Headers() };
+      if (spec === 'next/cache') return { revalidatePath() {} };
+      if (spec === 'next/navigation') return { redirect(url) { throw new Error(`REDIRECT:${url}`); }, notFound() { throw new Error('NOT_FOUND'); } };
+      if (spec.startsWith('@/') || spec.startsWith('.')) {
+        const target = spec.startsWith('@/') ? path.resolve('src', spec.slice(2)) : path.resolve(path.dirname(file), spec);
+        for (const suffix of ['.ts', '.tsx', '/index.ts']) if (fs.existsSync(target + suffix)) return load(target + suffix);
+      }
+      return require(spec);
+    };
+    vm.runInThisContext(`(function(require,module,exports){${code}\n})`, { filename: file })(req, mod, mod.exports);
+    return mod.exports;
+  }
+  return load;
+}
+
+const date = key => new Date(`${key}T00:00:00Z`);
+const month = { targetYear: 2030, targetMonth: 11, isLocked: false };
+const mail = { getAppEmailConfigError: () => null, sendAppEmail: async () => ({ success: true }) };
+before(async () => {
+  const raw = process.env.TEST_DATABASE_URL;
+  if (!raw) throw new Error('TEST_DATABASE_URL muss auf eine separate lokale Notdienst-Testdatenbank zeigen.');
+  const url = new URL(raw);
+  assert.ok(['127.0.0.1', 'localhost'].includes(url.hostname));
+  assert.equal(url.pathname, '/kita_notdienst_test');
+  prisma = new PrismaClient({ datasourceUrl: raw });
+  const originalDates = loader()('src/lib/date-utils.ts');
+  const load = loader({
+    '@/lib/auth-utils': {
+      requireKitaSession: async () => ({ user: current }),
+      requireRole: async roles => { assert.ok(roles.includes(current.role)); return { user: current }; },
+    },
+    '@/lib/alarms/auth': { requireAlarmActor: async () => ({ id: current.id, kitaId: current.kitaId, role: current.role }) },
+    '@/lib/date-utils': { ...originalDates, getTargetMonthData: () => month },
+    '@/lib/mail': mail,
+  });
+  ({ saveNotdienstAvailabilities: save } = load('src/app/dashboard/notdienst/actions.ts'));
+  ({ generatePlanAction: generate, publishPlanAction: publish, updateAssignmentAction: assign } = load('src/app/dashboard/notdienst/plan/actions.ts'));
+  ({ deleteMyChild: removeChild } = load('src/app/dashboard/profil/actions.ts'));
+  ({ updateFamilyAction: updateFamily } = load('src/app/dashboard/families/actions.ts'));
+  ({ loadNotdienstDays: days } = load('src/lib/notdienst-planning.ts'));
+});
+beforeEach(async () => {
+  const id = randomUUID();
+  const kita = await prisma.kita.create({ data: { name: 'Notdienst-Test', slug: `notdienst-${id}`, notdienstMinPerChildPerMonth: 3 } });
+  tenants.push(kita.id);
+  const family = await prisma.family.create({ data: { kitaId: kita.id, name: 'Familie Test' } });
+  const parent = await prisma.user.create({ data: { kitaId: kita.id, familyId: family.id, email: `${id}@example.invalid`, firstName: 'Test', lastName: 'Eltern', passwordHash: 'test', emailVerifiedAt: new Date(), privacyPolicyAcceptedAt: new Date() } });
+  const children = await Promise.all(['A','B'].map(firstName => prisma.child.create({ data: { kitaId: kita.id, familyId: family.id, firstName, lastName: 'Test' } })));
+  fixture = { kita, family, parent, children };
+  current = parent;
+});
+after(async () => {
+  if (!prisma) return;
+  await prisma.kita.deleteMany({ where: { id: { in: tenants } } });
+  await prisma.$disconnect();
+});
+const payload = (dates = ['2030-11-04','2030-11-05','2030-11-06','2030-11-07','2030-11-08','2030-11-11']) => ({ childrenIds: fixture.children.map(c => c.id), dates });
+async function admin() { current = await prisma.user.update({ where: { id: fixture.parent.id }, data: { role: 'ADMIN' } }); }
+async function closure(start, end = start, status = 'CONFIRMED', kitaId = fixture.kita.id) {
+  return prisma.termin.create({ data: { kitaId, title: 'Geschlossen', type: 'SCHLIESSTAG', status, startDate: new Date(start), endDate: new Date(end), allDay: true } });
+}
+async function makePlan(key = '2030-11-04', status = 'DRAFT', childId = fixture.children[0].id) {
+  return prisma.notdienstPlan.create({ data: { kitaId: fixture.kita.id, year: 2030, month: 11, status, assignments: { create: { kitaId: fixture.kita.id, childId, date: date(key) } } }, include: { assignments: true } });
+}
+async function seedAvailability(childId, keys) {
+  return prisma.notdienstAvailability.createMany({ data: keys.map(key => ({ kitaId: fixture.kita.id, childId, userId: fixture.parent.id, date: date(key) })) });
+}
+
+test('Vollständiger Haushalt speichert sechs verschiedene Tage für zwei Kinder', async () => {
+  assert.equal((await save(payload())).success, true);
+  const entries = await prisma.notdienstAvailability.findMany({ where: { kitaId: fixture.kita.id } });
+  assert.equal(entries.length, 6);
+  for (const child of fixture.children) assert.equal(entries.filter(e => e.childId === child.id).length, 3);
+});
+test('Eine reduzierte Kindermenge kann das Soll nicht umgehen', async () => {
+  assert.match((await save({ childrenIds: [fixture.children[0].id], dates: payload().dates.slice(0,3) })).error, /alle aktiven Kinder/);
+  assert.equal(await prisma.notdienstAvailability.count({ where: { kitaId: fixture.kita.id } }), 0);
+});
+test('Fünf Tage reichen bei zwei Kindern und Soll drei nicht', async () => {
+  assert.match((await save(payload(payload().dates.slice(0,5)))).error, /mindestens 6/);
+});
+test('Doppelte Datumsangaben zählen nur einmal', async () => {
+  assert.match((await save(payload(Array(6).fill('2030-11-04')))).error, /mindestens 6/);
+});
+test('Doppelte Kinder-IDs werden abgewiesen', async () => {
+  assert.ok((await save({ ...payload(), childrenIds: Array(2).fill(fixture.children[0].id) })).error);
+});
+test('Inaktive Kinder können das aktive Kinderset nicht ersetzen', async () => {
+  const inactive = await prisma.child.create({ data: { kitaId: fixture.kita.id, familyId: fixture.family.id, firstName: 'Inaktiv', lastName: 'Test', active: false } });
+  assert.ok((await save({ ...payload(), childrenIds: [fixture.children[0].id, inactive.id] })).error);
+  assert.equal((await save(payload())).success, true);
+});
+test('Kinder eines anderen Haushalts sind nicht wählbar', async () => {
+  const family = await prisma.family.create({ data: { kitaId: fixture.kita.id, name: 'Andere Familie' } });
+  const foreign = await prisma.child.create({ data: { kitaId: fixture.kita.id, familyId: family.id, firstName: 'Fremd', lastName: 'Test' } });
+  assert.ok((await save({ ...payload(), childrenIds: [fixture.children[0].id, foreign.id] })).error);
+});
+for (const [label, key] of [['Samstag','2030-11-02'], ['Sonntag','2030-11-03'], ['falscher Monat','2030-12-02']]) {
+  test(`${label} wird serverseitig abgewiesen und erhält vorhandene Eingaben`, async () => {
+    assert.equal((await save(payload())).success, true);
+    assert.ok((await save(payload([key, ...payload().dates.slice(1)]))).error);
+    assert.equal(await prisma.notdienstAvailability.count({ where: { kitaId: fixture.kita.id } }), 6);
+  });
+}
+test('Schließtag wird auch bei einer Uhrzeit nach Mitternacht abgewiesen', async () => {
+  await closure('2030-11-04T08:00:00Z','2030-11-04T17:00:00Z');
+  assert.match((await save(payload())).error, /Schließtage/);
+});
+test('Monatsübergreifende Schließtage einschließlich Berliner Mitternacht', async () => {
+  await closure('2030-10-31T23:00:00Z','2030-11-04T22:59:00Z');
+  const allowed = (await days(prisma, fixture.kita.id, 2030, 11)).map(d => d.toISOString().slice(0,10));
+  assert.ok(!allowed.includes('2030-11-01'));
+  assert.ok(!allowed.includes('2030-11-04'));
+  assert.ok(allowed.includes('2030-11-05'));
+});
+test('Ausstehende und abgelehnte Schließtermine blockieren keine Eingaben', async () => {
+  await closure('2030-11-04','2030-11-05','PENDING');
+  await closure('2030-11-06','2030-11-07','REJECTED');
+  assert.equal((await save(payload())).success, true);
+});
+test('Schließtage einer anderen Kita beeinflussen die Planung nicht', async () => {
+  const other = await prisma.kita.create({ data: { name: 'Andere Kita', slug: randomUUID() } }); tenants.push(other.id);
+  await closure('2030-11-04','2030-11-11','CONFIRMED',other.id);
+  assert.equal((await save(payload())).success, true);
+});
+test('Generator ignoriert alte Verfügbarkeiten an Schließtagen und für inaktive Kinder', async () => {
+  await seedAvailability(fixture.children[0].id, ['2030-11-01','2030-11-02','2030-11-04','2030-11-05']);
+  await seedAvailability(fixture.children[1].id, ['2030-11-06']);
+  await prisma.child.update({ where: { id: fixture.children[1].id }, data: { active: false } });
+  await closure('2030-10-31T23:00:00Z','2030-11-04T22:59:00Z');
+  await admin();
+  assert.equal((await generate(2030,11)).success, true);
+  const assignments = await prisma.notdienstAssignment.findMany({ where: { kitaId: fixture.kita.id } });
+  assert.deepEqual(assignments.map(a => a.date.toISOString().slice(0,10)), ['2030-11-05']);
+});
+for (const key of ['2030-11-02','2030-12-02','2030-11-04']) {
+  test(`Manuelle Einteilung an unzulässigem Tag ${key} wird verhindert`, async () => {
+    await admin(); const plan = await makePlan('2030-11-05');
+    await closure('2030-11-04');
+    assert.ok((await assign(plan.id, key, fixture.children[0].id)).error);
+    assert.equal(await prisma.notdienstAssignment.count({ where: { planId: plan.id } }),1);
+  });
+}
+test('Alte ungültige Einteilungen bleiben entfernbar und können danach veröffentlicht werden', async () => {
+  await admin(); const plan = await makePlan('2030-12-02');
+  assert.ok((await publish(plan.id)).error);
+  assert.equal((await assign(plan.id,'2030-12-02',null)).success,true);
+  assert.equal((await publish(plan.id)).success,true);
+});
+test('Neu angelegte Schließtage verhindern die Veröffentlichung alter Entwürfe', async () => {
+  await admin(); const plan = await makePlan(); await closure('2030-11-04');
+  assert.match((await publish(plan.id)).error,/geschlossenen Tagen/);
+  assert.equal((await prisma.notdienstPlan.findUniqueOrThrow({ where: { id: plan.id } })).status,'DRAFT');
+  assert.equal((await assign(plan.id,'2030-11-04',null)).success,true);
+  assert.equal((await publish(plan.id)).success,true);
+});
+test('Inaktive Kinder verhindern die Veröffentlichung eines Entwurfs', async () => {
+  await admin(); const plan = await makePlan();
+  await prisma.child.update({ where: { id: fixture.children[0].id }, data: { active: false } });
+  assert.ok((await publish(plan.id)).error);
+});
+test('Gültigen Plan veröffentlichen ist wiederholbar und erhält publishedAt', async () => {
+  await admin(); const plan = await makePlan();
+  assert.equal((await publish(plan.id)).success,true);
+  const first = await prisma.notdienstPlan.findUniqueOrThrow({ where: { id: plan.id } });
+  assert.equal((await publish(plan.id)).success,true);
+  assert.equal((await prisma.notdienstPlan.findUniqueOrThrow({ where: { id: plan.id } })).publishedAt.getTime(),first.publishedAt.getTime());
+});
+test('Fremde Pläne sind auch bei manuell manipulierter ID nicht veröffentlichbar', async () => {
+  const plan = await makePlan(); const old = current;
+  const other = await prisma.kita.create({ data: { name: 'Andere Kita', slug: randomUUID() } }); tenants.push(other.id);
+  current = { ...old, kitaId: other.id, role: 'ADMIN' };
+  assert.ok((await publish(plan.id)).error);
+  assert.equal((await prisma.notdienstPlan.findUniqueOrThrow({ where: { id: plan.id } })).status,'DRAFT');
+});
+test('Eltern können ein Kind mit veröffentlichtem zukünftigen Dienst nicht löschen', async () => {
+  const plan = await makePlan('2030-11-04','PUBLISHED');
+  assert.match((await removeChild(fixture.children[0].id)).error,/Koordination/);
+  assert.equal(await prisma.notdienstAssignment.count({ where: { planId: plan.id } }),1);
+  assert.equal(await prisma.child.count({ where: { id: fixture.children[0].id } }),1);
+});
+test('Kind ohne veröffentlichte Verpflichtung bleibt löschbar', async () => {
+  await makePlan('2030-11-04','DRAFT');
+  assert.equal((await removeChild(fixture.children[0].id)).success,true);
+  assert.equal(await prisma.child.count({ where: { id: fixture.children[0].id } }),0);
+});
+test('Vergangene veröffentlichte Dienste blockieren eine Löschung nicht', async () => {
+  await makePlan('2020-11-04','PUBLISHED');
+  assert.equal((await removeChild(fixture.children[0].id)).success,true);
+});
+test('Löschung fremder Kinder bleibt untersagt', async () => {
+  current = { ...current, familyId: 'foreign-family' };
+  assert.ok((await removeChild(fixture.children[0].id)).error);
+  assert.equal(await prisma.child.count({ where: { id: fixture.children[0].id } }),1);
+});
+test('Admin-Familienbearbeitung kann die Löschsperre nicht umgehen; alles wird zurückgerollt', async () => {
+  await makePlan('2030-11-04','PUBLISHED'); await admin();
+  const result = await updateFamily({
+    familyId: fixture.family.id, familyName: 'Darf nicht gespeichert werden',
+    parents: [{ id: current.id, firstName: current.firstName, lastName: current.lastName, email: current.email }],
+    children: [{ id: fixture.children[1].id, firstName: 'Geändert', lastName: 'Test' }],
+    removedChildIds: [fixture.children[0].id],
+  });
+  assert.match(result.error,/Koordination/);
+  assert.equal((await prisma.family.findUniqueOrThrow({ where: { id: fixture.family.id } })).name,'Familie Test');
+  assert.equal((await prisma.child.findUniqueOrThrow({ where: { id: fixture.children[1].id } })).firstName,'B');
+});
+test('Nach manueller Neuzuordnung ist das ursprünglich eingeteilte Kind löschbar', async () => {
+  await admin(); const plan = await makePlan('2030-11-04','PUBLISHED');
+  assert.equal((await assign(plan.id,'2030-11-04',fixture.children[1].id)).success,true);
+  assert.equal((await removeChild(fixture.children[0].id)).success,true);
+  assert.equal((await prisma.notdienstAssignment.findUniqueOrThrow({ where: { id: plan.assignments[0].id } })).childId,fixture.children[1].id);
+});
+test('Paralleles Veröffentlichen und Löschen lässt keinen veröffentlichten Dienst unbemerkt verschwinden', async () => {
+  await admin(); const plan = await makePlan();
+  const results = await Promise.all([publish(plan.id), removeChild(fixture.children[0].id)]);
+  const stored = await prisma.notdienstPlan.findUniqueOrThrow({ where: { id: plan.id }, include: { assignments: true } });
+  if (results[1].error) assert.equal(stored.assignments.length,1);
+  else { assert.equal(stored.assignments.length,0); assert.equal(await prisma.child.count({ where: { id: fixture.children[0].id } }),0); }
+  assert.ok(results.every(r => r.success || r.error));
+});
+
+test('Teamtag mit geschlossener Kita ist ebenfalls kein Notdiensttag', async () => {
+  const event = await closure('2030-11-04');
+  await prisma.termin.update({ where: { id: event.id }, data: { type: 'TEAMTAG' } });
+  assert.match((await save(payload())).error,/Schließtage/);
+  await seedAvailability(fixture.children[0].id,['2030-11-04','2030-11-05']);
+  await admin(); assert.equal((await generate(2030,11)).success,true);
+  assert.equal(await prisma.notdienstAssignment.count({ where: { kitaId: fixture.kita.id, date: date('2030-11-04') } }),0);
+});
+test('Heutige veröffentlichte Verpflichtung blockiert die Kindlöschung', async () => {
+  const berlin = new Intl.DateTimeFormat('sv-SE', { timeZone: 'Europe/Berlin', year: 'numeric', month: '2-digit', day: '2-digit' }).format(new Date());
+  await makePlan(berlin,'PUBLISHED');
+  assert.match((await removeChild(fixture.children[0].id)).error,/Koordination/);
+});
+test('Aktiver Alarm schützt auch ein Kind mit vergangener Einteilung', async () => {
+  const plan = await makePlan('2020-11-04','PUBLISHED');
+  const assignment = plan.assignments[0];
+  await prisma.notdienstAlarm.create({ data: {
+    kitaId: fixture.kita.id, assignmentId: assignment.id, activeAssignmentId: assignment.id,
+    familyId: fixture.family.id, familyName: fixture.family.name, childName: 'A Test',
+    date: assignment.date, expiresAt: new Date(Date.now()+3600000), deadline: new Date(Date.now()+1800000),
+  } });
+  assert.match((await removeChild(fixture.children[0].id)).error,/aktive Alarme/);
+  assert.equal(await prisma.child.count({ where: { id: fixture.children[0].id } }),1);
+});
+test('Admin kann ein Kind ohne Verpflichtung weiterhin entfernen', async () => {
+  await admin();
+  assert.equal((await updateFamily({
+    familyId: fixture.family.id, familyName: 'Familie geändert',
+    parents: [{ id: current.id, firstName: current.firstName, lastName: current.lastName, email: current.email }],
+    children: [{ id: fixture.children[1].id, firstName: 'B', lastName: 'Test' }],
+    removedChildIds: [fixture.children[0].id],
+  })).success,true);
+  assert.equal(await prisma.child.count({ where: { id: fixture.children[0].id } }),0);
+});

tests/runtime-supervisor.test.cjs

@@ -0,0 +1,16 @@
+/* eslint-disable @typescript-eslint/no-require-imports -- CommonJS fixtures exercise the native Node process supervisor. */
+const {test}=require('node:test');const assert=require('node:assert/strict');const {spawn}=require('node:child_process');const {mkdtempSync,mkdirSync,writeFileSync,rmSync}=require('node:fs');const {tmpdir}=require('node:os');const {join,resolve}=require('node:path');
+function fixture(server,worker){const root=mkdtempSync(join(tmpdir(),'kita-runtime-test-'));mkdirSync(join(root,'scripts'));writeFileSync(join(root,'server.js'),server);writeFileSync(join(root,'scripts/notdienst-alarm-worker.mjs'),worker);return root;}
+function waitForOutput(child,marker){return new Promise((resolvePromise,reject)=>{let text='';const timer=setTimeout(()=>reject(new Error(`Missing ${marker}`)),10000);child.stdout.on('data',chunk=>{text+=chunk;if(text.includes(marker)){clearTimeout(timer);resolvePromise(text);}});});}
+function exited(child){return new Promise(resolvePromise=>child.once('exit',(code,signal)=>resolvePromise({code,signal})));}
+function gone(pid){try{process.kill(pid,0);return false;}catch{return true;}}
+test('Worker crash is restarted while the server stays alive; shutdown stops both',async()=>{
+ const root=fixture('console.log(`server:${process.pid}`);setInterval(()=>{},1000);',`import {existsSync,writeFileSync} from 'node:fs';if(!existsSync('once')){writeFileSync('once','1');console.log('worker-crashed');process.exit(1);}console.log(\`worker-ready:\${process.pid}\`);setInterval(()=>{},1000);`);
+ const child=spawn(process.execPath,[resolve('scripts/start-runtime.mjs')],{cwd:root,env:{...process.env,NOTDIENST_JOB_SECRET:'test-only-secret-32-characters-long'},stdio:['ignore','pipe','pipe']});
+ try{const text=await waitForOutput(child,'worker-ready:');const serverPid=Number(text.match(/server:(\d+)/)[1]);const workerPid=Number(text.match(/worker-ready:(\d+)/)[1]);assert.equal(gone(serverPid),false);const ended=exited(child);child.kill('SIGTERM');assert.equal((await ended).code,0);assert.equal(gone(serverPid),true);assert.equal(gone(workerPid),true);}finally{if(child.exitCode===null)child.kill('SIGTERM');rmSync(root,{recursive:true,force:true});}
+});
+test('Server failure shuts down the worker and preserves the failure exit code',async()=>{
+ const root=fixture('setTimeout(()=>process.exit(7),150);', 'console.log(`worker:${process.pid}`);setInterval(()=>{},1000);');
+ const child=spawn(process.execPath,[resolve('scripts/start-runtime.mjs')],{cwd:root,env:{...process.env,NOTDIENST_JOB_SECRET:'test-only-secret-32-characters-long'},stdio:['ignore','pipe','pipe']});
+ try{const ended=exited(child);const text=await waitForOutput(child,'worker:');const pid=Number(text.match(/worker:(\d+)/)[1]);assert.equal((await ended).code,7);assert.equal(gone(pid),true);}finally{if(child.exitCode===null)child.kill('SIGTERM');rmSync(root,{recursive:true,force:true});}
+});

tests/security.test.cjs

@@ -163,6 +163,7 @@ test('database blocks cross-tenant child, user, RSVP and announcement links', as
   await assert.rejects(prisma.child.create({ data: { firstName: 'Wrong', lastName: 'Tenant', kitaId: kitaA.id, familyId: familyB.id } }), error => error.code === 'P2003');
   await assert.rejects(prisma.user.update({ where: { id: parentA.id }, data: { familyId: familyB.id } }), error => error.code === 'P2003');
   await assert.rejects(prisma.announcement.create({ data: { kitaId: kitaA.id, authorId: parentB.id, title: 'Wrong', content: 'Wrong' } }), error => error.code === 'P2003');
+  await assert.rejects(prisma.invitation.create({ data: { kitaId: kitaA.id, userId: parentB.id, email: 'cross-' + prefix + '@example.invalid', token: randomUUID(), expiresAt: new Date(Date.now() + 60000), invitedById: adminA.id } }), error => error.code === 'P2003');
   const event = await prisma.termin.create({ data: { kitaId: kitaA.id, title: 'Event', type: 'SONSTIGES', status: 'CONFIRMED', startDate: new Date(), endDate: new Date() } });
   await assert.rejects(prisma.eventParticipation.create({ data: { kitaId: kitaA.id, eventId: event.id, childId: childB.id, status: 'ATTENDING' } }), error => error.code === 'P2003');
 });
@@ -304,6 +305,7 @@ test('changing a parent email revokes sessions and requires fresh mailbox activa
   assert.equal(await authConfig.callbacks.jwt({ token: oldToken }),null);
   assert.equal(await authConfig.providers[0].authorize({ email: newEmail, password: 'Safe-test-password' }),null);
   const initialInvite = emails.at(-1).react.props.inviteLink.split('/').at(-1);
+  await prisma.invitation.update({ where: { userId: parentA.id }, data: { sentAt: new Date(Date.now() - 61_000) } });
   assert.equal((await actions.resendParentInvite(parentA.id)).success,true);
   const renewedInvite = emails.at(-1).react.props.inviteLink.split('/').at(-1);
   assert.notEqual(initialInvite,renewedInvite);
@@ -313,6 +315,33 @@ test('changing a parent email revokes sessions and requires fresh mailbox activa
   assert.equal((await accept({ attempt: 0 }, form(renewedInvite))).errors,undefined);
   assert.ok((await prisma.user.findUnique({ where: { id: parentA.id } })).emailVerifiedAt);
 });
+test('family admins keep their role when a changed mailbox is invited and activated', async () => {
+  const family = await prisma.family.create({ data: { kitaId: kitaA.id, name: 'Admin family' } });
+  const child = await prisma.child.create({ data: { kitaId: kitaA.id, familyId: family.id, firstName: 'Admin', lastName: 'Child' } });
+  const user = await prisma.user.create({ data: { email: `family-admin.${prefix}@example.invalid`, firstName: 'Family', lastName: 'Admin',
+    role: 'ADMIN', kitaId: kitaA.id, familyId: family.id, passwordHash: passHash,
+    emailVerifiedAt: new Date(), privacyPolicyAcceptedAt: new Date() } });
+  try {
+    const load = loader({ '@/auth': { auth: async () => session(adminA), signIn: async () => {} }, '@/lib/mail': emailMock });
+    const actions = load('src/app/dashboard/families/actions.ts');
+    const updated = await actions.updateFamilyAction({ familyId: family.id, familyName: 'Family A',
+      parents: [{ id: user.id, firstName: 'Family', lastName: 'Admin', email: `changed-family-admin.${prefix}@example.invalid` }],
+      children: [{ id: child.id, firstName: 'A', lastName: 'Test' }] });
+    assert.equal(updated.success,true,updated.error); assert.equal(updated.warning,undefined);
+    assert.equal((await prisma.user.findUnique({ where: { id: user.id } })).role,'ADMIN');
+    await prisma.invitation.update({ where: { userId: user.id }, data: { sentAt: new Date(Date.now() - 61_000) } });
+    assert.equal((await actions.resendParentInvite(user.id)).success,true);
+    const token = emails.at(-1).react.props.inviteLink.split('/').at(-1);
+    const accepted = await load('src/app/invite/[token]/actions.ts').acceptInviteAction({ attempt: 0 }, fields({ token,
+      password: 'Family-admin-new-password', confirmPassword: 'Family-admin-new-password', acceptPrivacyPolicy: 'on' }));
+    assert.equal(accepted.errors,undefined);
+    const activated = await prisma.user.findUnique({ where: { id: user.id } });
+    assert.equal(activated.role,'ADMIN'); assert.ok(activated.emailVerifiedAt);
+  } finally {
+    await prisma.verificationToken.deleteMany({ where: { identifier: user.id } });
+    await prisma.family.delete({ where: { id: family.id } });
+  }
+});
 test('resending an invite cannot issue an active link to an obsolete mailbox', async () => {
   const user = await prisma.user.create({ data: { email: `resend-race.${prefix}@example.invalid`, firstName: 'Race', lastName: 'Test',
     role: 'ELTERN', kitaId: kitaA.id, familyId: familyA.id, passwordHash: '' } });
@@ -355,7 +384,7 @@ test('upload quota holds under concurrent writes and accepted MIME comes from fi
 
 test('all supplemental database tenant constraints are present', async () => {
   const [row] = await prisma.$queryRaw`SELECT count(*)::int AS count FROM pg_constraint WHERE conname LIKE '%_tenant_fkey'`;
-  assert.equal(row.count,41);
+  assert.equal(row.count,45);
 });
 test('role guard authenticates once and keeps role validation on that session', async () => {
   let calls = 0;