FEDEO/docs/notification-preferences.md

Persönliche Benachrichtigungen

Unter Einstellungen → Benachrichtigungen (/settings/notifications) im Web und Mehr → Einstellungen in der mobilen App kann jeder Benutzer E-Mail und Push für sein Profil im aktiven Tenant einstellen. Der Web-Menüeintrag ist für alle angemeldeten Mitarbeiter unabhängig von Administrationsrechten sichtbar. Für ein anderes Profil wird zuerst der Tenant gewechselt. Die E-Mail-Adresse stammt aktuell vom Benutzerkonto, nicht vom Mitarbeiterprofil.

Ereignisse

Ereignis	Auslöser	E-Mail ohne Einstellung	Push ohne Einstellung
communication.message.direct	Persönliche Direktnachricht, ohne Absender	aus	an
communication.message.mentioned	Persönliche @-Erwähnung im Raum oder Projektchat	aus	an
communication.message.room	Sonstige Nachricht in einem Raum oder Projektchat mit Mitgliedschaft	aus	aus
communication.room.invited	Aufnahme in einen neu angelegten allgemeinen Chatraum	aus	aus

Erwähnte Empfänger erhalten nur das Erwähnungsereignis, nicht zusätzlich das normale Raumereignis. Projektchats sind die nativen FEDEO-Chaträume; föderierte Zusammenarbeit wird hier noch nicht erfasst.

Persönliche Einstellungen haben Vorrang vor Tenant-Standardwerten. Ohne beide Einträge gelten die obigen Standardwerte. In-App bleibt für Direktnachrichten und Erwähnungen aktiv; die neuen optionalen Raumereignisse sind auch In-App standardmäßig aus. Technische Testnachrichten sind nicht Teil der Matrix.

API und Migration

• GET /api/notifications/preferences: wirksame Einstellungen für den Benutzer und Tenant der authentifizierten Session.
• PUT /api/notifications/preferences: Array aus {eventType, channel, enabled}; Kanäle email und push. Unbekannte Ereignisse, nicht erlaubte Kanäle, nicht-boolsche Werte und Duplikate werden mit 400 abgewiesen. Änderungen werden atomar gespeichert. Benutzer- oder Tenant-IDs im Body ändern den Geltungsbereich nicht.
• Migration 0079_notification_matrix registriert die neuen Ereignisse und übernimmt persönliche Einstellungen und Tenant-Standards von communication.message.new für Direktnachrichten und Erwähnungen. Sie deaktiviert den alten Sammelauslöser sowie die bisher nicht angebundenen Anrufereignisse. Historische Benachrichtigungen bleiben erhalten.
• E-Mail verwendet den SMTP-Versand der Instanz, mobiles Push den zentralen Service, Browser-Push die Web-Push-Konfiguration der Instanz. Ein aktivierter Kanal setzt eine funktionierende Zustellkonfiguration voraus.

Sinnvolle nächste Auslöser

• Aufgabe zugewiesen, Aufgabe fällig: Empfänger aus der Aufgabenverantwortung; Fälligkeit braucht einen geplanten Lauf und Schutz vor Mehrfachversand.
• Urlaubs-/Abwesenheitsantrag eingereicht und entschieden: zuständige Freigabeperson bzw. Antragsteller.
• Dokument zur Prüfung oder Freigabe zugewiesen: ausschließlich verantwortliche Benutzer.
• Projektzuordnung und wichtige Terminänderung: betroffene Projektmitglieder.
• Eingehender und verpasster Anruf: erst mit verlässlichen Anrufzuständen und Empfängerzuordnung anbinden.

Diese Vorschläge werden noch nicht als schaltbare, aber wirkungslose Ereignisse angezeigt. Sicherheits- und Kontowiederherstellungs-E-Mails bleiben außerhalb der optionalen Matrix.