# SPDX-License-Identifier: AGPL-3.0-or-later # Copyright (C) 2026 Jonas Lorenz IT-Dienstleistungen # # Dieses Synapse-Modul ist freie Software: Sie koennen es unter den # Bedingungen der GNU Affero General Public License, Version 3 oder (nach # Ihrer Wahl) jeder spaeteren Fassung, weitergeben und veraendern. Es wird # OHNE JEDE GEWAEHRLEISTUNG bereitgestellt. Der Lizenztext und dieser # Quelltext stehen auf der Seite /open-source-lizenzen jeder AlarmPunkt- # Installation (Abschnitt "Chat-Server"). # # Warum AGPL: Das Modul laeuft im Prozess von Synapse (AGPL-3.0-or-later) # und bildet mit ihm ein Gesamtwerk (Betreiber 15.11.2026; # compliance/06_licenses.md, Nr. 19). """ Nur lesen - aber reagieren und abstimmen. (Betreiber, 01.10.2026) Ein Synapse-Modul. Es laesst in den Raeumen der Einheiten Personen, die das Chatrecht nur zum Lesen haben, keine Nachricht schreiben, wohl aber reagieren und in Umfragen abstimmen. ====================================================================== WARUM ES DAFUER EIN MODUL BRAUCHT ====================================================================== In einem verschluesselten Raum ist alles `m.room.encrypted`: Nachricht, Reaktion und Stimme. Die Machtstufen von Matrix unterscheiden nur nach dem Ereignistyp und koennen deshalb nur "alles" oder "nichts" sperren. Lesbar neben dem Chiffrat steht aber die Beziehung (`m.relates_to`) - die Kryptobibliothek aller drei Clients legt sie dort ab, damit der Server Reaktionen und Antworten zuordnen kann. Am 01.10.2026 in der Datenbank des Echtbetriebs gezaehlt: Reaktionen tragen `m.annotation`, Umfragestimmen `m.reference`, Nachrichten nichts oder `m.thread` bzw. `m.in_reply_to`. Daran entscheidet dieses Modul. ====================================================================== WEN ES BETRIFFT - DIE ABMACHUNG MIT ALARMPUNKT ====================================================================== Nur Raeume, deren `users_default` mindestens SCHWELLE ist. Das setzt allein der Raumabgleich von AlarmPunkt (matrixRaumSchreibrechte() in src/matrix.php): Schreibende erreichen die Schwelle ueber `users_default`, wer nur lesen darf, steht einzeln darunter. Direktgespraeche und eigene Gruppen haben `users_default` 0 und bleiben unberuehrt. Die Schwelle hier und MATRIX_SCHREIB_SCHWELLE dort muessen gleich sein - beide 10. ====================================================================== WAS ES NICHT IST ====================================================================== Keine Sperre gegen jemanden, der seinen Client umbaut: Die Beziehung steht unverschluesselt da und laesst sich faelschen. Es setzt die Regel gegen die Clients durch, die es gibt - auch gegen aeltere App-Fassungen, die das Eingabefeld noch zeigen. Faellt das Modul aus (nicht geladen), darf jeder im Raum schreiben. Das ist die gewollte Richtung: lieber ein Mensch zu viel, der schreibt, als ein Raum, in dem keiner mehr schreiben kann. """ from typing import Any, Dict from synapse.module_api import NOT_SPAM, ModuleApi # Was ein Nur-Lesender verschluesselt senden darf: Reaktionen und # Umfragestimmen. Bearbeiten (m.replace), Threads (m.thread) und # Antworten (nur m.in_reply_to, ohne rel_type) bleiben gesperrt. ERLAUBTE_BEZIEHUNGEN = ("m.annotation", "m.reference") MELDUNG = "Hier darfst du nur mitlesen." class NurLesen: def __init__(self, config: Dict[str, Any], api: ModuleApi): self._api = api self._schwelle = int(config.get("schwelle", 10)) api.register_spam_checker_callbacks( check_event_for_spam=self.check_event_for_spam, ) @staticmethod def parse_config(config: Dict[str, Any]) -> Dict[str, Any]: return config or {} async def check_event_for_spam(self, event: Any) -> Any: if event.type != "m.room.encrypted" or event.is_state(): return NOT_SPAM bezug = event.content.get("m.relates_to") if isinstance(bezug, dict) and bezug.get("rel_type") in ERLAUBTE_BEZIEHUNGEN: return NOT_SPAM zustand = await self._api.get_room_state( event.room_id, [("m.room.power_levels", "")] ) stufen = zustand.get(("m.room.power_levels", "")) if stufen is None: return NOT_SPAM inhalt = stufen.content vorgabe = _zahl(inhalt.get("users_default"), 0) # Kein Raum mit Schreibstufe: Direktgespraech, eigene Gruppe. if vorgabe < self._schwelle: return NOT_SPAM nutzer = inhalt.get("users") stufe = _zahl(nutzer.get(event.sender), vorgabe) if isinstance(nutzer, dict) else vorgabe if stufe >= self._schwelle: return NOT_SPAM return MELDUNG def _zahl(wert: Any, sonst: int) -> int: try: return int(wert) except (TypeError, ValueError): return sonst