Sendeprotokoll fuer Benachrichtigungen: "ich bekomme nichts" ist jetzt beantwortbar

Beim Nachsehen zu Dienes Meldung ist aufgefallen, dass ueber den
Versand selbst nichts festgehalten wird. Im Protokoll standen nur
push_angemeldet und push_abgemeldet -- kein Wort darueber, ob je
etwas verschickt wurde, an wie viele Geraete, und warum nicht.

Von neun Aufrufstellen wertete genau eine den Rueckgabewert aus; die
anderen acht warfen ihn weg. Sagt jemand "ich bekomme nichts", liess
sich also nicht nachsehen, OB gesendet wurde -- dieselbe Falle wie am
06.09. in VanVans Shop, wo zwei Stunden in die Zustellung ermittelt
wurden, bevor jemand fragte, ob die Mails abgeschickt waren. Sie
waren es, alle, nachweisbar in einer Abfrage.

zuletzt_ok reicht dafuer nicht: Es sagt, wann zuletzt irgendetwas
ankam -- nicht was, nicht an wen sonst, und nichts ueber die Faelle,
in denen gar nicht erst gesendet wurde. Genau die (abgeschaltet,
Ruhezeit, kein Geraet) sind die haeufigste Antwort auf die Frage.

Neue Tabelle push_versand: Zeit, Person, Art, Grund, Geraete,
zugestellt. Festgehalten wird JEDER Ausgang, auch der, bei dem nichts
hinausging -- ein Protokoll, das nur Erfolge kennt, kann die Frage
nicht beantworten, fuer die es angelegt wurde.

Das Protokoll sitzt als Huelle um den Versand, nicht in ihm: Sieben
Ausgaenge einzeln zu protokollieren waere eine Liste zum Pflegen, und
der achte, den jemand naechstes Jahr einbaut, umginge sie still --
so sind am 11.09. die Spalten beim Tabellenumbau verschwunden. So
steht ein neuer Ausgang ohne Zutun mit drin.

Aufraeumen nach 30 Tagen, neben dem bestehenden Aufraeumen von
push_verschickt. Gemessen statt geschaetzt: rund 16 Chat-Nachrichten
am Tag an bis zu acht angemeldete Geraete -- ein paar tausend Zeilen
im Monat.

Das Schreiben kann den Versand nicht aufhalten (try), meldet sich
aber, wenn es scheitert: ein Protokoll, das heimlich nichts
schreibt, ist schlimmer als keins.

pruef-push-eilig 13 -> 20. Darunter die Gegenprobe, dass auch das
NICHT-Senden protokolliert wird, und dass ein Fehlschlag nicht als
zugestellt gilt.

Datenbank vorher gesichert und die Sicherung geprueft (integrity_check,
20 Personen, 10 Anmeldungen lesbar).

Co-Authored-By: Claude Opus 5 <[email protected]>

server/pruef-push-eilig.mjs

@@ -244,6 +244,54 @@ const kopfVon = async (art) => {
     `anruf verfaellt nach ${anruf.kopf.ttl} s -- eilig UND kurzlebig, beides zugleich`);
 }
 
+/* =====================================================================
+   Das Sendeprotokoll -- damit "ich bekomme nichts" beantwortbar wird
+   ===================================================================== */
+console.log("\n=== Was hinausging, steht hinterher da ===");
+{
+  const p = new DatabaseSync(process.env.WORKSPACE_DB);
+  const zaehle = (wo = "1=1", ...w) =>
+    p.prepare(`SELECT COUNT(*) AS n FROM push_versand WHERE ${wo}`).get(...w).n;
+
+  /* Drei Meldungen sind oben wirklich hinausgegangen. */
+  const geschickt = zaehle("grund = 'ok'");
+  ok(geschickt >= 3, `${geschickt} zugestellte Meldungen stehen im Protokoll (mindestens 3)`);
+
+  const mitGeraet = zaehle("grund = 'ok' AND geraete >= 1 AND zugestellt >= 1");
+  ok(mitGeraet === geschickt,
+    `bei allen ${mitGeraet} steht, an wie viele Geraete (nicht nur DASS)`);
+
+  const arten = p.prepare(
+    "SELECT DISTINCT art FROM push_versand ORDER BY art").all().map((r) => r.art);
+  ok(arten.includes("chat_nachricht") && arten.includes("anruf"),
+    `die Art steht dabei: ${arten.join(", ")}`);
+
+  /* DER EIGENTLICHE ZWECK: auch das NICHT-Senden muss dastehen.
+     "Abgeschaltet", "Ruhezeit", "kein Geraet" sind die haeufigsten
+     Antworten auf "ich bekomme nichts" -- ein Protokoll, das nur
+     Erfolge kennt, kann die Frage nicht beantworten, fuer die es
+     angelegt wurde. */
+  const vorher = zaehle();
+  const nichts = await push.benachrichtige(personId, "gibtsnicht", {
+    titel: "x", text: "x", ziel: "/workspace/start.html",
+  });
+  const nachher = zaehle();
+  ok(nichts.verschickt === 0 && nichts.grund === "unbekannte_art",
+    `es ging nichts hinaus (${nichts.grund})`);
+  ok(nachher === vorher + 1,
+    `und genau DAS steht jetzt auch da (${vorher} -> ${nachher})`);
+  ok(zaehle("grund = 'unbekannte_art'") === 1,
+    "mit dem Grund, nicht nur als leere Zeile");
+
+  /* Gegenprobe: Koennte diese Messung ueberhaupt "nein" sagen? Eine
+     Art, die es nicht gibt, darf nicht als zugestellt gelten -- sonst
+     waere jede Zeile oben wertlos. */
+  ok(zaehle("grund = 'ok' AND art = 'gibtsnicht'") === 0,
+    "Gegenprobe: der Fehlschlag steht NICHT als zugestellt drin");
+
+  p.close();
+}
+
 /* =====================================================================
    Gegenprobe: der alte Name darf nicht still durchrutschen
    ===================================================================== */