/* ===================================================================== workspace-hinweise.js — "Was ist dran?" (Konzept, Phase 4). Der erste Baustein der Automationen. Bis hierher musste man selbst daran denken, in den richtigen Bereich zu schauen. Diese Datei dreht das um: Das System sagt, was liegen bleibt. Drei Regeln, an die sich das hier haelt: 1. KEINE eigenen Daten. Ein Hinweis ist immer nur eine Sicht auf etwas, das ohnehin schon existiert. Wird die Aufgabe erledigt, verschwindet der Hinweis von selbst -- es gibt nichts zu quittieren und nichts, was veralten kann. 2. JEDER HINWEIS FUEHRT IRGENDWOHIN. Ein Hinweis ohne Ziel ist nur ein schlechtes Gewissen. Deshalb traegt jeder einen Link zu der Stelle, an der man das Problem tatsaechlich loesen kann. 3. DIESELBE SICHTBARKEIT WIE UEBERALL. Die Regeln werden aus den Fachmodulen importiert, nicht abgeschrieben. Ein Hinweis darf niemals etwas verraten, das die zugehoerige Seite verbergen wuerde -- sonst waere die Uebersicht ein Leck. ===================================================================== */ import express from "express"; import { db, sitzungLesen, betreuteIds, istLeitung, istDogFather, siehtAlles, pipelineIds, gehoertAufDieseAdresse, } from "./workspace.js"; import { darfSeite } from "./rechte.js"; import { sichtbar as sichtbarAufgaben } from "./workspace-aufgaben.js"; import { sichtbar as sichtbarTermine } from "./workspace-kalender.js"; import { sichtbar as sichtbarDateien } from "./workspace-dateien.js"; import { sichtbar as sichtbarEintraege } from "./workspace-bereiche.js"; import { stufenFuer } from "./workspace-checkliste.js"; import { offeneHinweise as zielHinweise } from "./workspace-manager-ziele.js"; export const hinweisRouter = express.Router(); /* Reihenfolge = Dringlichkeit. "warnung" steht immer oben. */ const RANG = { warnung: 0, offen: 1, ruhig: 2 }; function angemeldet(req, res, next) { const person = sitzungLesen(req); if (!person) return res.status(401).json({ fehler: "nicht_angemeldet" }); req.person = person; next(); } hinweisRouter.use("/workspace/api/hinweise", angemeldet); const p2 = (n) => String(n).padStart(2, "0"); function heuteLokal() { const d = new Date(); return `${d.getFullYear()}-${p2(d.getMonth() + 1)}-${p2(d.getDate())}`; } function jetztLokal() { const d = new Date(); return `${heuteLokal()}T${p2(d.getHours())}:${p2(d.getMinutes())}`; } function inTagen(n) { const d = new Date(Date.now() + n * 86400_000); return `${d.getFullYear()}-${p2(d.getMonth() + 1)}-${p2(d.getDate())}`; } /* Kleine Hilfe: eine Zahl abfragen, Fehler eines einzelnen Hinweises duerfen nie die ganze Uebersicht kippen. */ function zaehle(sql, werte) { try { return db().prepare(sql).get(...werte)?.n ?? 0; } catch { return 0; } } hinweisRouter.get("/workspace/api/hinweise", (req, res) => { try { /* Die gewaehlte Sicht (nur DogFather, sonst er selbst). Waeren die Hinweise davon ausgenommen, staende auf der Startseite die eigene Lage, waehrend die Kacheln darunter die eines Scouts zeigen -- zwei Wahrheiten auf einem Bildschirm. */ const person = req.sicht || req.person; const heute = heuteLokal(); const jetzt = jetztLokal(); const hinweise = []; /* DIE ADRESSE IST IMMER DIE ECHTE (15.09.2026). `person` kann die angesehene sein -- der Sicht-Umschalter zeigt die Lage eines anderen. Das aendert, WESSEN Zahlen dastehen, nicht, auf welcher Wand man steht. */ const hier = { ...person, haus: (req.person || person)?.haus }; const dazu = (art, stufe, text, ziel, anzahl) => { if (!anzahl) return; /* EIN HINWEIS AUF EINE SEITE, DIE ES HIER NICHT GIBT, IST KEIN HINWEIS (15.09.2026). Filipe, mit dem Bildschirmfoto auf crew.: „wieso steht es noch da?" -- „1 Punkt im Start-Check braucht Handlung". Die Seite war da schon gesperrt; der Hinweis zeigte ins Leere. Das war MEIN Fehler von heute Mittag: Ich hatte die Seiten gesperrt und ausdruecklich dazugeschrieben „nur die Seiten, nicht die Schnittstellen" -- und dabei uebersehen, dass die Hinweise eine DRITTE Stelle sind. Sie sind keine Seite und keine Schnittstelle, sondern eine Liste von Verweisen. DIESELBE REGEL, NICHT EINE ZWEITE: Was auf dieser Adresse keine Seite hat, bekommt hier auch keinen Hinweis. Eine eigene Liste hier waere die, die beim naechsten Umbau auseinanderlaeuft. */ const zielPfad = ziel ? "/workspace/" + String(ziel).split("?")[0] : null; if (zielPfad && !gehoertAufDieseAdresse(hier, zielPfad)) return; /* ==== UND DIE ROLLE, NICHT NUR DIE ADRESSE (19.09.2026) ========= `gehoertAufDieseAdresse` beantwortet die Frage "gibt es diese Seite hier?" -- nicht "darf DIESE Person sie oeffnen?". Der Unterschied ist am 19.09. sofort aufgefallen, als der erste Hinweis dazukam, der nicht fuer alle gilt: Ein Mitglied der Community bekam "Bei dir klingelt nichts" mit Weg auf `anruf-probe.html` -- eine Seite, die ihm ausdruecklich NICHT offensteht. Gefunden von pruef-community-sicht, die genau danach sucht: sichtbare Wege, die ins Leere fuehren. Das ist der 15.09. noch einmal, nur eine Ebene tiefer. Damals war es die Adresse ("wieso steht es noch da?"), diesmal die Rolle. Und es ist dieselbe Lehre: Die Hinweise sind eine DRITTE Stelle neben Seiten und Schnittstellen, und jede Schranke, die es dort gibt, muss es auch hier geben. DIESELBE TAFEL, NICHT EINE ZWEITE: `darfSeite` ist die Funktion, die auch die Tuer bewacht. Eine eigene Liste hier waere die, die beim naechsten Umbau auseinanderlaeuft. */ if (zielPfad && !darfSeite(person, zielPfad)) return; hinweise.push({ art, stufe, text, ziel, anzahl }); }; /* ---------- Aufgaben ---------- */ const a = sichtbarAufgaben(person); if (a) { dazu("aufgaben_ueberfaellig", "warnung", "überfällig", "aufgaben.html", zaehle(`SELECT COUNT(*) n FROM aufgaben a WHERE ${a.wo} AND a.status NOT IN ('erledigt', 'abgebrochen') AND a.frist IS NOT NULL AND a.frist < ?`, [...a.werte, heute])); dazu("aufgaben_heute", "offen", "heute fällig", "aufgaben.html", zaehle(`SELECT COUNT(*) n FROM aufgaben a WHERE ${a.wo} AND a.status NOT IN ('erledigt', 'abgebrochen') AND a.frist = ?`, [...a.werte, heute])); /* Aufgaben, die im Review haengen. Sie warten auf jemanden -- das ist genau die Sorte Stillstand, die niemandem auffaellt. */ dazu("aufgaben_review", "offen", "wartet auf Freigabe", "aufgaben.html", zaehle(`SELECT COUNT(*) n FROM aufgaben a WHERE ${a.wo} AND a.status = 'review'`, a.werte)); } /* ---------- Termine und Calls ---------- */ const t = sichtbarTermine(person); if (t) { dazu("termine_heute", "offen", "heute im Kalender", "kalender.html", zaehle(`SELECT COUNT(*) n FROM termine t WHERE ${t.wo} AND t.beginn >= ? AND t.beginn < ?`, [...t.werte, heute + "T00:00", inTagen(1) + "T00:00"])); /* Vergangene Gespraeche ohne Protokoll -- der einzige Zustand im Call-Bereich, der aktiv etwas verlangt. */ dazu("protokoll_fehlt", "warnung", "Gespräch ohne Protokoll", "calls.html", zaehle(`SELECT COUNT(*) n FROM termine t LEFT JOIN protokolle pr ON pr.termin_id = t.id WHERE ${t.wo} AND t.art IN ('call','review') AND t.beginn <= ? AND pr.id IS NULL`, [...t.werte, jetzt])); } /* ---------- Dateien ---------- */ const d = sichtbarDateien(person); if (d) { dazu("dateien_review", istLeitung(person) ? "warnung" : "offen", "Datei wartet auf Freigabe", "dateien.html", zaehle(`SELECT COUNT(*) n FROM dateien d WHERE ${d.wo} AND d.status = 'review'`, d.werte)); } /* ---------- Betreuungsbereiche ---------- HIER BLEIBT ES ABSICHTLICH BEI sichtbar() (07.09.2026). Seit heute gibt es daneben sichtbarEintrag(), das Agentur- Eintraege fuer alle sichtbar macht. Hier waere das falsch, und zwar aus zwei Gruenden: Der Hinweis fuehrt fest nach `bereich.html?b=live` -- ein Creator bekaeme also eine Zahl aus der Agentur und landete beim Klick in einem Bereich, in dem nichts davon steht. Und ein dringender Agentur-Punkt ist die Aufgabe der Agentur, nicht seine; ein Hinweis, den man nicht abarbeiten kann, ist Laerm. Wer das eines Tages umstellen will, muss zuerst das Sprungziel mitwandern lassen. */ const e = sichtbarEintraege(person); if (e) { dazu("bereiche_dringend", "warnung", "dringender Punkt in den Bereichen", "bereich.html?b=live", zaehle(`SELECT COUNT(*) n FROM eintraege e WHERE ${e.wo} AND e.status = 'offen' AND e.dringlichkeit = 'hoch'`, e.werte)); } /* Offener Handlungsbedarf aus der Erstanalyse. Sichtbar fuer Management, zustaendigen Scout und den Creator selbst -- genau wie der Start-Check. */ { let woS = null; let werteS = []; if (istLeitung(person)) woS = "1=1"; else if (person.rolle === "creator") { woS = "s.creator_id = ?"; werteS = [person.id]; } else { const ids = betreuteIds(person); if (ids.length) { woS = `s.creator_id IN (${ids.map(() => "?").join(",")})`; werteS = ids; } } if (woS) { dazu("startcheck_handlung", "offen", "Punkt im Start-Check braucht Handlung", "startcheck.html", zaehle(`SELECT COUNT(*) n FROM startcheck s WHERE ${woS} AND s.bewertung = 'handlung'`, werteS)); } } /* ---------- Markierte Punkte aus den festen Checklisten ---------- Wunsch vom 01.09.2026: "so dass die sehen, da ist was -- und es soll auch oben in der Kachel angezeigt werden." NUR FUER CREATOR, und das ist eine bewusste Entscheidung. Fuer einen Betreuer waere die Zahl eine Liste dessen, was er selbst angehakt hat: Sie waechst mit seiner Arbeit, und er kann sie nicht abbauen -- nur der Creator kann. Ein Zaehler, den man nicht auf null bringen kann, wird nach zwei Wochen ignoriert, und dann sind auch die daneben nichts mehr wert. Vier Bereiche, vier Hinweise, weil vier verschiedene Kacheln gemeint sind. Ein Sammelhinweis "6 markierte Punkte" liesse offen, wo man nachsehen soll. */ if (person.rolle === "creator") { /* Aus dem Katalog des Agenturhauses abgeleitet -- ein Creator wohnt dort und nirgends sonst. */ const MARKIERT = stufenFuer("creator").filter((s) => s.merk).map((s) => s.schluessel); const BEREICHE = [ ["live", "LIVE-Analyse", "bereich.html?b=live"], ["content", "Content-Ideen", "content.html"], ["community", "Community", "bereich.html?b=community"], ["technik", "Technik", "bereich.html?b=technik"], ]; for (const [schluessel, name, ziel] of BEREICHE) { dazu(`markiert_${schluessel}`, "warnung", `markierter Punkt in ${name}`, ziel, /* zaehle() faengt Fehler ab -- gibt es die Tabelle noch nicht (niemand hat je eine Checkliste geoeffnet), steht hier 0 statt eines Ausfalls der ganzen Uebersicht. */ /* WELCHE STUFEN HIER ZAEHLEN, sagt der Katalog und nicht diese Zeile (24.09.2026). Hier stand `stufe = 'verbessern'` -- eine abgeschriebene Liste mit genau einem Eintrag. Am Tag, an dem "Passt nicht" dazukam, waere die staerkste Rueckmeldung, die es gibt, als Einzige NICHT auf der Startseite erschienen: Der Creator saehe ein ruhiges Kaestchen, waehrend sein Scout auf etwas wartet. Genau die Sorte Luecke, die nicht falsch aussieht, sondern gar nicht aussieht. `merk` traegt dieselbe Bedeutung wie am Punkt selbst und am Gruppenkopf: "hier wartet etwas auf dich". */ zaehle(`SELECT COUNT(*) n FROM punkt_stand WHERE bereich = ? AND creator_id = ? AND stufe IN (${MARKIERT.map(() => "?").join(",")})`, [schluessel, person.id, ...MARKIERT])); } } /* ---------- Scout-Pipeline ---------- */ /* NUR DogFather sieht alle Leads (01.09.2026). Ein Scout seine eigenen, ein Manager seine eigenen und die seiner zugeteilten Scouts -- dieselbe Regel wie in der Pipeline selbst, aus derselben Quelle (pipelineIds in workspace.js). Ein Hinweis, der mehr verraet als die Seite dahinter, waere ein Leck. */ if (siehtAlles(person) || person.rolle === "scout" || person.rolle === "manager") { const ids = siehtAlles(person) ? null : pipelineIds(person); const nur = ids === null ? "1=1" : ids.length ? `l.scout_id IN (${ids.map(() => "?").join(",")})` : "0=1"; const werte = ids === null ? [] : ids; dazu("followup_faellig", "warnung", "Follow-up fällig", "scouting.html", zaehle(`SELECT COUNT(*) n FROM leads l WHERE ${nur} AND l.status NOT IN ('uebergeben','abgelehnt') AND l.naechster_followup IS NOT NULL AND l.naechster_followup <= ?`, [...werte, heute])); /* Uebergebene Leads, aus denen nie ein Creator wurde. Die Uebergabe ist sonst eine Sackgasse, die niemand bemerkt. */ dazu("uebergabe_offen", "offen", "übergeben, aber noch kein Creator angelegt", "scouting.html", zaehle(`SELECT COUNT(*) n FROM leads l WHERE ${nur} AND l.status = 'uebergeben' AND l.creator_id IS NULL`, werte)); } /* ---------- Nur Management ---------- Review-Termine und fehlende Zustaendigkeit sind Steuerungswissen. Sie erscheinen deshalb weder bei Creator noch bei Scouts -- so wie die zugehoerigen Felder im Profil auch. */ /* DIE AGENTUR-HINWEISE NICHT AUF DER TEAM-ADRESSE (10.09.2026). "Creator-Profile sind noch leer" und "Creator hat noch keinen Start-Check" standen im Bildschirmfoto mitten auf der Team-Seite. Sie zaehlen ausdruecklich Creator -- auf dieser Adresse gibt es keine, und ein Hinweis auf etwas, das man dort weder sehen noch anfassen kann, ist eine Aufgabe ohne Tuer. Die Bedingung steht an DIESER Stelle und nicht in den vier Abfragen darunter: Wer eine fuenfte hinzufuegt, bekommt sie dadurch mit, ohne daran zu denken. */ if (istLeitung(person) && person.haus !== "crew") { dazu("review_faellig", "warnung", "Review-Termin überfällig", "profil.html", zaehle(`SELECT COUNT(*) n FROM profile f JOIN personen p ON p.id = f.person_id AND p.aktiv = 1 WHERE f.naechster_review IS NOT NULL AND f.naechster_review < ?`, [heute])); dazu("review_bald", "offen", "Review steht in den nächsten 7 Tagen an", "profil.html", zaehle(`SELECT COUNT(*) n FROM profile f JOIN personen p ON p.id = f.person_id AND p.aktiv = 1 WHERE f.naechster_review BETWEEN ? AND ?`, [heute, inTagen(7)])); dazu("ohne_betreuung", "ruhig", "Creator ohne zuständige Person", "personen.html", zaehle(`SELECT COUNT(*) n FROM personen p LEFT JOIN betreuung b ON b.creator_id = p.id WHERE p.rolle = 'creator' AND p.aktiv = 1 AND b.creator_id IS NULL`, [])); /* Ein Creator ohne Erstanalyse ist die Sorte Luecke, die sonst niemandem auffaellt -- es fehlt ja nichts, es fing nur nie an. */ dazu("ohne_startcheck", "ruhig", "Creator ohne Start-Check", "startcheck.html", zaehle(`SELECT COUNT(*) n FROM personen p WHERE p.rolle = 'creator' AND p.aktiv = 1 AND NOT EXISTS (SELECT 1 FROM startcheck s WHERE s.creator_id = p.id)`, [])); dazu("ohne_profil", "ruhig", "Creator ohne ausgefülltes Profil", "profil.html", zaehle(`SELECT COUNT(*) n FROM personen p LEFT JOIN profile f ON f.person_id = p.id WHERE p.rolle = 'creator' AND p.aktiv = 1 AND f.person_id IS NULL`, [])); } /* ---------- Anfragen für Modi ---------- WARUM ES DAFUER EINEN HINWEIS BRAUCHT: Die Anfragen haben ausdruecklich KEINE Kachel -- sie stehen auf der Talente-Seite, weil sie der Anfang desselben Trichters sind. Damit gibt es auf der Startseite nichts, was auf sie zeigt. Und eine Anfrage, die drei Wochen unbeantwortet liegt, ist eine Absage, die niemand ausgesprochen hat. Genau dafuer ist die Glocke da. `dazu` prueft selbst, ob die Person diese Seite hier oeffnen darf -- ein Hinweis auf eine gesperrte Seite waere derselbe Fehler wie am 15.09. beim Start-Check. */ dazu("bewerbungen_neu", "offen", "neue Anfrage für Modi", "bewerbungen.html", zaehle("SELECT COUNT(*) n FROM bewerbungen WHERE zustand = 'neu'", [])); /* ==== BEI DIR KLINGELT NICHTS -- STEHT JETZT WOANDERS ========= Hier stand bis zum 03.10.2026 der Hinweis "Bei dir klingelt nichts -- kein Geraet angemeldet", eingefuehrt am 19.09., als sieben von elf Zugaengen kein Geraet hatten. ER HAT DAS PROBLEM NICHT GELOEST. Am 03.10. nachgemessen: immer noch 12 von 20 ohne Anmeldung, darunter die linke Hand und ein Modi. Der Grund liegt auf der Hand -- er SAGT es, aber man kann nichts tun: Er fuehrt auf anruf-probe.html, wo man sich erst zurechtfinden muss. Ersetzt durch einen Kasten auf der Startseite mit einem "Anschalten"-Knopf (glocke.js, `hinweisZeichnen`). Ein Fingertipp statt eines Umwegs -- und er erklaert den iPhone-Fall, in dem Web-Push ohne Home-Bildschirm gar nicht geht. Das wusste hier niemand. WARUM NICHT BEIDES: Der neue Kasten sitzt auf derselben Seite, direkt ueber dieser Liste. Zwei Saetze zur selben Sache auf EINEM Bildschirm sind kein doppelter Schutz, sondern zwei Stellen, die irgendwann Verschiedenes behaupten -- derselbe Grund, aus dem die Betreuungs-Auswahl am 31.08. zusammengelegt wurde. WAS DAMIT AUFGEGEBEN IST, offen gesagt: Diese Zeile liess sich nicht wegklicken, der neue Kasten schon (einmalig, je Geraet). Eine Entscheidung von Filipe am 03.10. Die Gegensicherung ist die Personenliste: Dort steht seit heute bei jeder Person, die nichts bekommt, genau das -- die Leitung sieht es also weiterhin, auch wenn jemand den Kasten wegtippt. */ /* ---------- Manager-Ziele (02.10.2026) ---------- KOMMT FERTIG AUS DEM FACHMODUL und wird hier nicht nachgerechnet. Das ist Regel 3 dieser Datei ("die Regeln werden aus den Fachmodulen importiert, nicht abgeschrieben") und zugleich der Grund, warum die Zahl auf der Kachel und die Zahl auf der Seite nie auseinandergehen koennen: Es ist dieselbe Rechnung. `dazu` filtert danach weiter -- Adresse und Rolle. Fuer einen Creator liefert das Modul ohnehin nichts; faende sich hier spaeter doch ein Weg, haelt ihn die Rechtetafel auf. */ for (const h of zielHinweise(person)) { dazu(h.art, h.stufe, h.text, h.ziel, h.anzahl); } hinweise.sort((x, y) => (RANG[x.stufe] - RANG[y.stufe]) || (y.anzahl - x.anzahl)); res.json({ hinweise, stand: new Date().toISOString() }); } catch (fehler) { console.error("[workspace] Hinweise:", fehler?.message); res.status(503).json({ fehler: "nicht_verfuegbar" }); } });