Files
dogfather-universe/server/workspace-calls.js
T
DogFatherGitandClaude Opus 5 63036fc33e Wiederholungen bekommen eine eigene Tafel -- und nur den laufenden Monat
Filipe: "ich will da auch noch eine kategorie fuer automatische
wiederholungen. die sollen dann auch nur fuer den monat selbst
angezeigt werden und nicht monate im voraus."

DAS PROBLEM WAR ECHT UND GROSS, UND ES STAND SEIT TAGEN AUF SEINEM
BILDSCHIRM

Der Nachfueller haelt einen Horizont von 180 Tagen gefuellt (siehe
workspace-serien.js). Ein woechentlicher Community-Talk ergibt darin
sechsundzwanzig Zeilen -- und alle standen unter "Steht an". Auf dem
Bild waren es siebenundzwanzig Karten, fast alle derselbe Termin. Die
Liste war damit unbrauchbar fuer genau das, wofuer sie da ist: zu
sehen, was WIRKLICH ansteht.

Jetzt sind es zwei getrennte Fragen:

  STEHT AN            was einmalig bevorsteht
  LAEUFT AUTOMATISCH  was von allein wiederkommt -- und davon nur der
                      LAUFENDE MONAT

Der Monatsschnitt ist die eigentliche Antwort auf "nicht Monate im
Voraus": Eine Wiederholung im November sagt einem heute nichts, was man
nicht schon weiss. Wer weiter schauen will, hat den Kalender -- und
genau das steht als Satz in der Gruppe.

Gerechnet wird auf dem reinen Datumstext (`beginn` beginnt mit
JJJJ-MM), nicht mit `new Date`. Kein Zeitzonenfehler, kein Nachtfehler.
Die Trennung faellt im SERVER, nicht in der Oberflaeche: Eine zweite
Regel im Browser waere die sichere Zusage, dass beide auseinanderlaufen.

DREI AUSSAGEN STATT EINER

pruef-call-kategorien saet jetzt zwei Auspraegungen derselben Serie --
eine in vier, eine in sechzig Tagen -- und misst:

  1. die Wiederholung dieses Monats steht in "Laeuft automatisch"
  2. die des naechsten Monats NICHT
  3. und unter "Steht an" steht keine von beiden

Vorher wird geprueft, dass die beiden ueberhaupt in verschiedenen
Monaten liegen. Ohne diese Zeile waere Nummer 2 an einem 1. des Monats
trivial erfuellt -- gruen, ohne etwas gemessen zu haben.

Zwei Fehler beim Bau der Pruefung, beide von ihr selbst gemeldet:
`page.evaluate` lief in "Target page has been closed" (der Block davor
schliesst seinen Browserkontext -- diese Aussage braucht ohnehin keinen
Browser, sie betrifft die Schnittstelle), und eine Hilfsfunktion stand
nach ihrer ersten Benutzung.

pruef-call-kategorien von 17 auf 22. Neun Pruefungen gelaufen, alle
gruen.

Co-Authored-By: Claude Opus 5 <[email protected]>
2026-09-07 23:26:38 +02:00

371 lines
16 KiB
JavaScript

/* =====================================================================
workspace-calls.js — Calls & Meeting-Protokolle (Konzept, Seite 13).
Calls sind KEINE eigene Terminart neben dem Kalender, sondern
dieselben Termine mit art = 'call'. Ein zweiter Terminspeicher waere
die sichere Art, irgendwann zwei widerspruechliche Uhrzeiten zu haben.
Diese Datei fuegt nur das hinzu, was ein Gespraech vom blossen Termin
unterscheidet: das Protokoll danach.
Der tragende Satz aus dem Deck:
"Jeder Call endet mit klaren To-dos, die direkt ins Board uebernommen
werden."
Woertlich genommen heisst das: To-dos werden nicht als Text im
Protokoll abgelegt, sondern sofort zu echten Aufgaben. Sonst steht die
Verabredung in einem Dokument, das niemand mehr oeffnet.
===================================================================== */
import express from "express";
import {
db, protokolliere, echteIp, sitzungLesen, einstellung, einstellungSetzen, istLeitung, istDogFather, siehtAlles,
} from "./workspace.js";
import { sichtbar } from "./workspace-kalender.js";
export const callRouter = express.Router();
/* Wie lange nach dem geplanten Ende ein Call noch als "läuft gerade"
gilt. Gespräche ziehen sich; wer eine Viertelstunde später beitritt,
soll den Knopf noch finden. */
const NACHLAUF_MIN = 60;
const TITEL_MAX = 160;
const TEXT_MAX = 6000;
const TODOS_MAX = 12;
const jetzt = () => new Date().toISOString();
/* Lokale Zeit im selben Format wie ein datetime-local-Feld -- damit ist
"vergangen" derselbe Vergleich wie im Kalender. */
function jetztLokal() {
const d = new Date();
const p = (n) => String(n).padStart(2, "0");
return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}T${p(d.getHours())}:${p(d.getMinutes())}`;
}
function angemeldet(req, res, next) {
const person = sitzungLesen(req);
if (!person) return res.status(401).json({ fehler: "nicht_angemeldet" });
req.person = person;
next();
}
function gleicheHerkunft(req, res, next) {
const herkunft = req.get("origin");
if (!herkunft) return next();
let erlaubt;
try { erlaubt = new URL(herkunft).host === req.get("host"); } catch { erlaubt = false; }
if (!erlaubt) return res.status(403).json({ fehler: "fremde_herkunft" });
next();
}
callRouter.use("/workspace/api/calls", angemeldet);
/* Die Sichtbarkeitsregel kommt aus dem Kalender und wird hier NICHT
wiederholt. Sie stand kurzzeitig zweimal da -- und prompt wurde beim
Erweitern nur eine der beiden Kopien geaendert: Scouts sahen die
Termine ihrer Creator, dieselben Termine als Call aber nicht. Eine
Regel, zwei Orte, ein Fehler. */
const SPALTEN = `
t.id, t.titel, t.beschreibung, t.art, t.beginn, t.dauer_min, t.ort,
t.creator_id, t.teilnehmer_id, t.erledigt, t.serie_id,
pc.name AS creator_name, pt.name AS teilnehmer_name,
pr.id AS protokoll_id, pr.punkte, pr.entscheidungen,
pr.erstellt AS protokoll_erstellt, pr.naechster_termin_id,
pe.name AS protokoll_von`;
const VERBUND = `
FROM termine t
LEFT JOIN personen pc ON pc.id = t.creator_id
LEFT JOIN personen pt ON pt.id = t.teilnehmer_id
LEFT JOIN protokolle pr ON pr.termin_id = t.id
LEFT JOIN personen pe ON pe.id = pr.erstellt_von`;
/* Aufgaben, die aus einem Gespraech entstanden sind. */
function aufgabenZu(protokollIds) {
if (!protokollIds.length) return new Map();
const platz = protokollIds.map(() => "?").join(",");
const zeilen = db().prepare(`
SELECT pa.protokoll_id, a.id, a.titel, a.status, a.frist, p.name AS verantwortlich_name
FROM protokoll_aufgaben pa
JOIN aufgaben a ON a.id = pa.aufgabe_id
LEFT JOIN personen p ON p.id = a.verantwortlich_id
WHERE pa.protokoll_id IN (${platz})
ORDER BY a.id`).all(...protokollIds);
const karte = new Map();
for (const z of zeilen) {
if (!karte.has(z.protokoll_id)) karte.set(z.protokoll_id, []);
karte.get(z.protokoll_id).push({
id: z.id, titel: z.titel, status: z.status,
frist: z.frist, verantwortlich_name: z.verantwortlich_name,
});
}
return karte;
}
/* ---------- Liste ------------------------------------------------------- */
callRouter.get("/workspace/api/calls", (req, res) => {
try {
const { wo, werte } = sichtbar(req.sicht || req.person);
const alle = db().prepare(`
SELECT ${SPALTEN} ${VERBUND}
WHERE ${wo} AND t.art IN ('call','review')
ORDER BY t.beginn DESC`).all(...werte);
const karte = aufgabenZu(alle.filter((c) => c.protokoll_id).map((c) => c.protokoll_id));
for (const c of alle) c.aufgaben = karte.get(c.protokoll_id) || [];
const grenze = jetztLokal();
res.json({
jetzt: grenze,
/* Wo der Call stattfindet, wenn am Termin selbst kein Link steht.
Vorher gab es den Knopf "Call öffnen" nur, wenn jemand von Hand
einen Link eingetragen hatte -- stand dort "Hier" oder "Discord",
war da nichts zum Anklicken, und die Frage "wo führe ich den
Call?" blieb unbeantwortet. Jetzt hat das Team einen festen
Sprachkanal, und jeder Call zeigt darauf.
Der Link liegt in den Einstellungen und nicht fest im Code: Ein
Kanal kann umziehen, und dann darf das kein Programmierauftrag
sein. */
call_link: einstellung("call_link", "") || "",
/* Die Reihenfolge der Gruppen ist die Dringlichkeit: Was fehlt,
steht oben -- nicht was als Naechstes kommt. */
/* WIEDERHOLUNGEN BEKOMMEN EINE EIGENE GRUPPE (07.09.2026).
Filipe: "ich will da auch noch eine kategorie fuer automatische
wiederholungen. die sollen dann auch nur fuer den monat selbst
angezeigt werden und nicht monate im voraus."
DAS PROBLEM WAR ECHT UND GROSS: Der Nachfueller haelt einen
Horizont von 180 Tagen gefuellt (siehe workspace-serien.js).
Ein woechentlicher Community-Talk ergibt darin sechsundzwanzig
Zeilen -- und alle standen unter "Steht an". Auf Filipes Bild
waren es siebenundzwanzig Karten, fast alle derselbe Termin.
Die Liste war damit unbrauchbar fuer das, wofuer sie da ist:
zu sehen, was WIRKLICH ansteht.
Jetzt zwei getrennte Fragen:
STEHT AN was einmalig bevorsteht
LAEUFT AUTOMATISCH was von allein wiederkommt, und davon
nur der LAUFENDE MONAT
Der Monatsschnitt ist die eigentliche Antwort auf "nicht Monate
im Voraus": Eine Wiederholung im November sagt einem heute
nichts, was man nicht schon weiss. Gerechnet wird auf dem
reinen Datumstext (`beginn` beginnt mit JJJJ-MM) -- kein
`new Date`, keine Zeitzone, kein Nachtfehler. */
offen: alle.filter((c) => c.beginn <= grenze && !c.protokoll_id).reverse(),
anstehend: alle.filter((c) => c.beginn > grenze && !c.serie_id).reverse(),
serien: alle.filter((c) => c.beginn > grenze && c.serie_id
&& String(c.beginn).slice(0, 7) === grenze.slice(0, 7)).reverse(),
erledigt: alle.filter((c) => c.beginn <= grenze && c.protokoll_id),
});
} catch (fehler) {
console.error("[workspace] Calls lesen:", fehler?.message);
res.status(503).json({ fehler: "nicht_verfuegbar" });
}
});
/* ---------- Protokoll schreiben ----------------------------------------- */
/* ---------- Wo die Calls stattfinden -------------------------------------
Ein Link, den das Management einmal setzt (der Discord-Sprachkanal des
Teams). Er beantwortet die Frage "wo führe ich den Call?" ein für alle
Mal, statt sie bei jedem Termin neu zu stellen.
Ein Termin darf trotzdem seinen eigenen Ort haben -- ein Gespräch mit
einer Agentur findet nun einmal woanders statt. Der eigene Ort
gewinnt; dieser hier ist die Antwort, wenn keiner eingetragen wurde. */
callRouter.put("/workspace/api/call-link", gleicheHerkunft, (req, res) => {
try {
if (!istLeitung(req.person)) return res.status(403).json({ fehler: "nicht_erlaubt" });
const roh = String(req.body?.link ?? "").trim();
if (roh) {
let u;
try { u = new URL(roh); } catch { u = null; }
/* Nur http(s). Ohne diese Prüfung liesse sich hier ein
javascript:-Verweis hinterlegen, den anschliessend JEDER im Team
mit einem Klick ausfuehrt -- der Link steht ja auf jeder
Call-Karte. */
if (!u || (u.protocol !== "https:" && u.protocol !== "http:")) {
return res.status(400).json({ fehler: "Das ist keine gültige http(s)-Adresse." });
}
if (roh.length > 400) return res.status(400).json({ fehler: "Der Link ist zu lang." });
}
einstellungSetzen("call_link", roh, { ...req.person, ip: echteIp(req) });
protokolliere("call_link_gesetzt", {
personId: req.person.id, rolle: req.person.rolle, ip: echteIp(req),
detail: (roh || "geleert").slice(0, 120),
});
res.json({ ok: true, call_link: roh });
} catch (fehler) {
console.error("[workspace] Call-Link setzen:", fehler?.message);
res.status(503).json({ fehler: "nicht_verfuegbar" });
}
});
/* ---------- Protokoll löschen -------------------------------------------
NUR DogFather (Wunsch 02.09.2026: "ich will auch dass ich die löschen
kann. und nur ich kann die löschen sonst keiner").
Bewusst istDogFather und nicht istLeitung: Ein Manager hat sonst
überall dieselben Rechte, hier ausdrücklich nicht. Ein Protokoll ist
die Gedächtnisstütze eines Gesprächs -- wer es entfernen darf, kann
nachträglich bestimmen, was besprochen wurde.
Gelöscht wird NUR das Protokoll, nicht das Gespräch. Der Termin bleibt
im Kalender und erscheint danach wieder unter "Protokoll fehlt" -- die
Handlung ist damit umkehrbar: neu schreiben, und alles ist wie vorher.
Die daraus entstandenen AUFGABEN bleiben ebenfalls stehen. Sie sind
echte Arbeit, die jemand übernommen hat; sie mit einem Klick auf ein
Protokoll verschwinden zu lassen wäre ein stiller Datenverlust an
einer ganz anderen Stelle. Die Verknüpfung fällt weg (ON DELETE
CASCADE auf der Zwischentabelle), die Aufgaben selbst nicht. */
callRouter.delete("/workspace/api/calls/:id/protokoll", gleicheHerkunft, (req, res) => {
try {
if (!siehtAlles(req.person)) {
return res.status(403).json({ fehler: "Nur DogFather darf ein Protokoll löschen." });
}
const id = Number(req.params.id);
if (!Number.isInteger(id)) return res.status(400).json({ fehler: "ungueltig" });
/* Auch DogFather kommt nur an Gespräche, die er sehen darf -- die
Sichtbarkeitsregel gilt hier wie überall. Bei ihm ist das "alles",
aber die Abfrage steht trotzdem da: Ändert sich die Regel einmal,
ändert sie sich hier mit. */
const { wo, werte } = sichtbar(req.person);
const call = db().prepare(
`SELECT t.id, t.titel, pr.id AS protokoll_id
FROM termine t LEFT JOIN protokolle pr ON pr.termin_id = t.id
WHERE ${wo} AND t.id = ?`).get(...werte, id);
if (!call) return res.status(404).json({ fehler: "nicht_gefunden" });
if (!call.protokoll_id) return res.status(404).json({ fehler: "kein_protokoll" });
db().prepare("DELETE FROM protokolle WHERE id = ?").run(call.protokoll_id);
protokolliere("protokoll_geloescht", {
personId: req.person.id, rolle: req.person.rolle, ip: echteIp(req),
detail: `Call #${id} ${call.titel}`.slice(0, 120),
});
res.json({ ok: true });
} catch (fehler) {
console.error("[workspace] Protokoll löschen:", fehler?.message);
res.status(503).json({ fehler: "nicht_verfuegbar" });
}
});
callRouter.post("/workspace/api/calls/:id/protokoll", gleicheHerkunft, (req, res) => {
const d = db();
try {
const id = Number(req.params.id);
if (!Number.isInteger(id)) return res.status(400).json({ fehler: "ungueltig" });
const { wo, werte } = sichtbar(req.person);
const termin = d.prepare(`
SELECT t.id, t.titel, t.beginn, t.dauer_min, t.ort, t.art,
t.creator_id, t.teilnehmer_id, pr.id AS protokoll_id
FROM termine t LEFT JOIN protokolle pr ON pr.termin_id = t.id
WHERE ${wo} AND t.id = ? AND t.art IN ('call','review')`).get(...werte, id);
if (!termin) return res.status(404).json({ fehler: "nicht_gefunden" });
const k = req.body || {};
const punkte = String(k.punkte ?? "").trim().slice(0, TEXT_MAX) || null;
const entscheidungen = String(k.entscheidungen ?? "").trim().slice(0, TEXT_MAX) || null;
/* To-dos pruefen, BEVOR irgendetwas geschrieben wird. */
const roh = Array.isArray(k.todos) ? k.todos : [];
if (roh.length > TODOS_MAX) {
return res.status(400).json({ fehler: `Höchstens ${TODOS_MAX} To-dos auf einmal.` });
}
const todos = [];
for (const t of roh) {
const titel = String(t?.titel ?? "").trim();
if (!titel) continue;
if (titel.length > TITEL_MAX) return res.status(400).json({ fehler: "Ein To-do ist zu lang." });
const frist = String(t?.frist ?? "").trim();
if (frist && (!/^\d{4}-\d{2}-\d{2}$/.test(frist) || Number.isNaN(Date.parse(frist)))) {
return res.status(400).json({ fehler: "Frist eines To-dos ist ungültig." });
}
todos.push({ titel, frist: frist || null });
}
/* Nächster Termin, falls im Protokoll vereinbart. */
const nb = String(k.naechster_beginn ?? "").trim();
if (nb && !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}$/.test(nb)) {
return res.status(400).json({ fehler: "Der nächste Termin hat kein gültiges Datum." });
}
let dauer = Number(k.naechster_dauer ?? termin.dauer_min ?? 30);
if (!Number.isInteger(dauer) || dauer < 5 || dauer > 480) dauer = 30;
if (!punkte && !entscheidungen && !todos.length) {
return res.status(400).json({ fehler: "Ein leeres Protokoll hilft niemandem." });
}
/* Alles zusammen oder gar nicht -- sonst gaebe es Aufgaben ohne
Protokoll oder umgekehrt. */
let antwort;
d.exec("BEGIN");
try {
let protokollId = termin.protokoll_id;
if (protokollId) {
d.prepare("UPDATE protokolle SET punkte = ?, entscheidungen = ?, geaendert = ? WHERE id = ?")
.run(punkte, entscheidungen, jetzt(), protokollId);
} else {
protokollId = Number(d.prepare(`
INSERT INTO protokolle (termin_id, punkte, entscheidungen, erstellt, erstellt_von)
VALUES (?,?,?,?,?)`).run(id, punkte, entscheidungen, jetzt(), req.person.id).lastInsertRowid);
}
/* To-dos werden zu echten Aufgaben -- genau das ist der Punkt. */
const neueAufgaben = [];
for (const t of todos) {
const a = Number(d.prepare(`
INSERT INTO aufgaben
(titel, beschreibung, status, prioritaet, creator_id, verantwortlich_id, frist, erstellt, erstellt_von)
VALUES (?,?,'offen','mittel',?,?,?,?,?)`).run(
t.titel, `Aus dem Gespräch „${termin.titel}"`,
termin.creator_id, termin.teilnehmer_id ?? termin.creator_id,
t.frist, jetzt(), req.person.id).lastInsertRowid);
d.prepare("INSERT INTO protokoll_aufgaben (protokoll_id, aufgabe_id) VALUES (?,?)")
.run(protokollId, a);
neueAufgaben.push(a);
}
/* Nächster Termin als echter Kalendereintrag, mit demselben
Gegenüber und demselben Meeting-Link. */
let naechster = null;
if (nb) {
naechster = Number(d.prepare(`
INSERT INTO termine
(titel, beschreibung, art, beginn, dauer_min, ort, creator_id, teilnehmer_id, erstellt, erstellt_von)
VALUES (?,?,?,?,?,?,?,?,?,?)`).run(
termin.titel, `Folgetermin zu „${termin.titel}"`, termin.art, nb, dauer,
termin.ort, termin.creator_id, termin.teilnehmer_id, jetzt(), req.person.id).lastInsertRowid);
d.prepare("UPDATE protokolle SET naechster_termin_id = ? WHERE id = ?").run(naechster, protokollId);
}
d.prepare("UPDATE termine SET erledigt = 1 WHERE id = ?").run(id);
d.exec("COMMIT");
antwort = { protokoll_id: protokollId, aufgaben: neueAufgaben.length, naechster_termin_id: naechster };
} catch (fehler) {
d.exec("ROLLBACK");
throw fehler;
}
protokolliere("protokoll_geschrieben", {
personId: req.person.id, rolle: req.person.rolle, ip: echteIp(req),
detail: `Termin #${id}, ${antwort.aufgaben} To-do(s)`.slice(0, 120),
});
res.status(201).json(antwort);
} catch (fehler) {
console.error("[workspace] Protokoll schreiben:", fehler?.message);
res.status(503).json({ fehler: "nicht_verfuegbar" });
}
});