Értesítések

A Libre WebUI felhasználónként tartós értesítési fiókot vezet, így az említések, közvetlen üzenetek, megosztások, automatizálási hibák és emlékeztetők zárt oldalnál is megérkeznek.

Állapot-felugró ablakok

A rövid állapotüzenetek, például egy mentett módosítás vagy egy befejezett Git-művelet, az oldal teteje közelében jelennek meg. A Bezárás gombbal egérrel vagy billentyűzettel is eltüntetheti a felugró ablakot. Ha az egérmutatót fölé viszi, az üzenet látható marad, így elolvashatja; a bezárás csak az üzenetet tünteti el, a háttérben futó művelet megőrzi aktuális állapotát.

Bejövő fiók

Az értesítések adatbázissorok: titkosított cím/törzs, 500-as limit felhasználónként és opcionális forráskulcs a deduplikáláshoz. A REST listáz, számol, olvasottnak jelöl és töröl.

Az élő kézbesítés a notify:<userId> tartós SSE-folyamot használja a GET /api/notifications/events címen. Az identitás a hitelesített munkamenetből jön, nem kliensinputból. Az SQL-fiók az igazság; elveszett eseményt listaolvasás állít helyre.

Értesítési források

Típus	Mikor
channel-dm	Közvetlen üzenet
channel-mention	Valaki @mentions vagy válaszol
channel-invite	Csatornához adás
share	Erőforrás-megosztás
automation-failed	Automatizálás hibája, ha nincs letiltva
calendar-reminder	Emlékeztető ideje
work-run-finished	Felbérelt Work agent befejez
work-run-attention	Agent bemenetet kér vagy hibázik
work-takeover	Agent képernyőátvételt kér
work-approval	Work-futás mellékhatással járó művelet jóváhagyására vár
system	Példányszintű közlemény

Mindig csak az érintett felhasználó kapja. Nem tag név említése nem hoz létre semmit.

Az értesítések automatizálásokat is elindíthatnak: egy event eseményindítós automatizálás mindig lefut, amikor a kiválasztott típusú értesítés megérkezik a tulajdonosához, automatizálásonkénti egyperces hűtési idővel korlátozva.

Kimenő webhookok

Adminisztrátorok célokat regisztrálhatnak.

• Védett kimenet. Pontos URL, nincs redirect, nincs privát/link-local cím, kivéve TOOLS_PRIVATE_NETWORK_ALLOWLIST. A DNS minden kézbesítésnél újraellenőrzött.
• Aláírt. Secret mellett X-Libre-Signature: sha256=<hmac> az exact testen.
• Redaktált. Csak eseménytípus, cím, ID és timestamp; törzs, üzenet, prompt, dokumentum nem hagyja el.
• Tartós. Korlátozott retry; 5xx újra, 4xx végleges döntés.
• Hatókörös. Célonként típusok vagy *.

Böngésző push

A Settings → Notifications Web Pushra regisztrálja a böngészőt.

• VAPID (RFC 8292). Egyszer létrehozott, titkosított ES256 pár vagy VAPID_PUBLIC_KEY/VAPID_PRIVATE_KEY; VAPID_SUBJECT a kapcsolat.
• Titkosított payload (RFC 8291). aes128gcm az eszköz kulcsaira; a szolgáltatás nem olvassa.
• Eszköz- és munkamenet-kötött. Kijelentkezés vagy "sign out other sessions" törli. A végpont titkosított lookup tokennel és nyilvános HTTPS kell.
• Tartós. Retry, 404/410 törli a regisztrációt.
• A payload cím, opcionális törzs, típus és link, ugyanazzal a redakcióval.

Push csak production app és biztonságos origin mellett. A service worker offline shellt és telepíthetőséget biztosít; hash assetek változatlan cache, API soha nincs cache-elve.

Email

Az e-mail a harmadik kézbesítési csatorna, és az egyetlen, amit egy rendszergazdának be kell állítania. A Settings → User Management → Access & policies → Email notifications egyetlen kimenő SMTP-szervert tart: host, port, kapcsolatbiztonság (STARTTLS, implicit TLS vagy none megbízható hálózathoz), opcionális hitelesítő adatok, a feladó címe és a linkekhez használt nyilvános URL. A Környezeti változók dokumentumban lévő SMTP_* környezeti változók ugyanezeket a mezőket inicializálják konténeres telepítésekhez; a felületen mentett érték elsőbbséget élvez. A jelszó titkosítva tárolódik, és soha nem kerül vissza a böngészőbe. A Send test egy üzenetet kézbesít a rendszergazda saját címére (vagy egy begépelt bármelyik címre), így a körüljárás bizonyítható, mielőtt a felhasználók rá támaszkodnának.

A rendszergazdák Világos vagy Sötét e-mail-sablont is választhatnak, és mentés előtt megtekinthetik az előnézetét. Az alapértelmezett a Világos. A mentett beállítás a példány minden értesítésére és teszt-e-mailjére vonatkozik, beleértve a Markdown-eredményeket is; független az egyes felhasználók felületi témájától. Az előnézet mintatartalmat jelenít meg anélkül, hogy kapcsolódna az SMTP-hez, levelet küldene vagy feladatot állítana sorba. A beállítást csak rendszergazdák olvashatják vagy módosíthatják, és csak ők kérhetnek előnézetet. A beépített beállítások olvashatóan tartják a szöveget, a hivatkozásokat, a kódblokkokat és a gombokat; egyéni HTML-sablonok nem engedélyezettek. Az e-mail-kliensek ennek ellenére saját megjelenítési beállításaik szerint módosíthatják a színeket.

Amint a kapcsoló be van kapcsolva, minden felhasználó kiválasztja, mi éri el a postaládáját a Settings → Notifications → Email notifications alatt:

• Channel mentions: egy csatornában Önt megemlítő üzenet, az előnézettel és a csatornára mutató linkkel.
• Automation results: minden automatizálási futásának eredménye, siker vagy hiba. Egy chat-futás magát az asszisztensválaszt hordozza (néhány ezer karakterig); egy Work-futás a feladat állapotsorát hordozza; egy hiba a hibát hordozza. A link a keletkezett chatet vagy taskot nyitja meg.

Mindkét kapcsoló kikapcsolva marad, amíg a felhasználó be nem kapcsolja őket, és csak olyan fiókoknál működnek, amelyeknek van e-mail-címe, amit a fiók tulajdonosa regisztrációkor állít be, vagy egy rendszergazda ad hozzá a Users alatt. Az üzenetek ugyanazon a tartós job-runtime-on keresztül mennek ki, mint a Web Push, korlátozott újrapróbálkozással átmeneti relézavarok esetén, és az SMTP-kliens egy kis, beépített implementáció (EHLO, STARTTLS, AUTH PLAIN vagy LOGIN), amely soha nem küld hitelesítő adatot titkosítatlan kapcsolaton, hacsak a mód kifejezetten none. Minden üzenetnek van egy egyszerű szöveges és egy HTML alternatív része a weboldal megjelenésében: a Libre WebUI wordmark, egy kártya a tartalommal, egy korall gomb a célhoz, és egy lábléc, amely visszamutat a Settings → Notifications oldalra. Egy automatizálási eredmény Markdownból renderelődik (címsorok, listák, kiemelés, kód, csak http(s) célokra mutató linkek); minden más escape-elt, és az egyetlen külső kép a librewebui.org-ról kiszolgált logó. Nincs nyomkövetés.

Korlátok

• Típusonkénti preferencia még nincs. Az automatizálás saját beállítását követi, a csatorna elhagyása leállítja értesítéseit.