Files
dogfather-universe/server/workspace-aufgaben.js
T
DogFatherGit 389d8c1213 Workspace: neue Rolle Manager, feste Rollenreihenfolge, echte Rollenwahl
DREI TEILE.

1) ROLLE "MANAGER"

Ein Manager darf alles, was DogFather darf -- mit genau zwei
Vorbehalten: Er kann keine Leitung ANLEGEN und an keiner Leitung etwas
AENDERN. Sonst koennte er sich einen zweiten Vollzugang schaffen oder
DogFather aussperren. "Nur DogFather hat alle endgueltigen Rechte"
heisst genau das.

Umgesetzt ueber istLeitung() an EINER Stelle statt 44 einzelner
Vergleiche auf "admin" im Server und 26 im Browser.

DATENBANK-UMSTELLUNG: CREATE TABLE IF NOT EXISTS fasst eine vorhandene
Tabelle nicht an -- die CHECK-Regel stand also weiter auf den alten drei
Rollen, und ein Manager waere daran gescheitert, obwohl der Code stimmt.
SQLite kann eine CHECK-Regel nicht aendern, also: neue Tabelle, Daten
hinueber, alte weg, umbenennen. Davor schreibt der Server eine
vollstaendige Sicherung (VACUUM INTO, in sich konsistent). Ohne
Sicherung wird NICHT umgestellt.

Geprueft nach der Umstellung: alle 13 Tabellen mit gleicher Zeilenzahl,
PRAGMA integrity_check ok, keine verwaisten Verweise. Die einzige
Abweichung war eine Sitzung mehr -- die eigene Anmeldung, die die
Umstellung ausgeloest hat.

2) EIN SICHERHEITSLOCH, DAS DER TEST GEFUNDEN HAT

Der erste Entwurf sicherte "Person anlegen" und "Person sperren" ab --
und liess "neuer Zugangscode" offen. Ein Manager konnte DogFather einen
neuen Code ausstellen, bekam ihn angezeigt und haette ihn damit aus
seinem eigenen Konto ausgesperrt. Im Test aufgefallen, weil ich den
negativen Fall durchgespielt habe.

Behoben nicht durch eine dritte Einzelpruefung, sondern durch eine
Schranke an JEDEM Weg mit einer :id. Der naechste Weg, der dazukommt,
ist damit automatisch mitgeschuetzt.

Nachgeprueft: Manager bekommt 403 beim Code-Erneuern und Sperren von
DogFather UND von sich selbst, darf aber Creator und Scouts verwalten.

3) FOLGEFEHLER DER MASSENERSETZUNG

Die Regel "niemals den letzten aktiven DogFather sperren" hatte durch
die Umstellung auf istLeitung() ploetzlich auch Manager blockiert --
gezaehlt werden aber nur DogFather-Zugaenge. Jetzt istDogFather().
Geprueft: DogFather kann einen Manager sperren, sich selbst nicht.

4) REIHENFOLGE UND ROLLENWAHL

Ueberall DogFather, Manager, Scout, Creator. "ORDER BY rolle" waere
alphabetisch gewesen (admin, creator, manager, scout) -- also fast genau
falsch herum. Jetzt ein gemeinsamer Sortierausdruck aus workspace.js.

Das Auswahlmenue fuer die Rolle ist weg. Es kam als weisses
Windows-Menue mitten in einer dunklen Oberflaeche und schnitt "Creator"
zu "Crea" ab -- gestalten laesst sich ein aufgeklapptes Systemmenue
nicht. Ersetzt durch vier sichtbare Schalter mit Symbol, Farbe je Rolle
und einer Zeile, was die Rolle bedeutet. Bei "Manager" gegen
"DogFather" ist das der Unterschied zwischen Raten und Wissen.

DogFather und Manager stehen dort nur zur Wahl, wenn DogFather selbst
davorsitzt -- ein Knopf, der immer scheitert, gehoert nicht hin.

Nebenbei: Das Namensfeld war auf eine von zwoelf Spalten gequetscht, weil
seine Umgebung keine .feld-Klasse trug. Alle Formulare daraufhin
durchsucht, keine weiteren Faelle.
2026-08-31 11:32:22 +02:00

299 lines
12 KiB
JavaScript

/* =====================================================================
workspace-aufgaben.js — Aufgaben und Dashboard-Zahlen für /workspace.
Kernpunkt dieses Moduls ist die Datentrennung aus dem Konzept:
"Creator sehen ihren Bereich. Scouts sehen nur ihre Pipeline."
Sie wird AUSSCHLIESSLICH serverseitig durchgesetzt -- in jeder Abfrage,
nicht im Browser. Ein manipulierter Aufruf bekommt dadurch keine
fremden Daten, egal was er behauptet.
===================================================================== */
import express from "express";
import {
db, protokolliere, echteIp, sitzungLesen, betreutWo, istLeitung, ROLLEN_SORTIERUNG,
} from "./workspace.js";
export const aufgabenRouter = express.Router();
const STATUS = ["offen", "arbeit", "review", "erledigt"];
const PRIORITAETEN = ["hoch", "mittel", "niedrig"];
const TITEL_MAX = 160;
const TEXT_MAX = 4000;
const jetzt = () => new Date().toISOString();
/* ---------- Schranke ---------------------------------------------------- */
function angemeldet(req, res, next) {
const person = sitzungLesen(req);
if (!person) return res.status(401).json({ fehler: "nicht_angemeldet" });
req.person = person;
next();
}
/* Schutz gegen Anfragen von fremden Seiten. SameSite=lax verhindert das
meiste schon, aber nur solange sich der Browser daran hält. Bei allem,
was Daten verändert, wird zusätzlich geprüft, dass die Anfrage von
dieser Domain kommt. Fehlt der Kopf ganz (z. B. bei curl), ist es kein
Browser-Angriff über eine fremde Seite -- dann zählt allein das Cookie. */
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();
}
aufgabenRouter.use("/workspace/api", angemeldet);
/* ---------- Sichtbarkeit ------------------------------------------------ */
/* Liefert WHERE-Bedingung und Werte, passend zur Rolle. An genau einer
Stelle definiert, damit keine Abfrage sie versehentlich vergisst. */
export function sichtbar(person) {
switch (person.rolle) {
case "admin":
return { wo: "1=1", werte: [] };
case "creator":
return { wo: "(a.creator_id = ? OR a.verantwortlich_id = ?)", werte: [person.id, person.id] };
case "scout": {
/* Eigene Aufgaben -- und die der Creator, die dieser Scout
betreut. Wer jemanden betreut, muss dessen Brett sehen. */
const b = betreutWo(person, "a.creator_id");
return b
? { wo: `(a.verantwortlich_id = ? OR ${b.wo})`, werte: [person.id, ...b.werte] }
: { wo: "a.verantwortlich_id = ?", werte: [person.id] };
}
default:
return { wo: "0=1", werte: [] }; // unbekannte Rolle sieht nichts
}
}
function darfAendern(person, aufgabe) {
if (istLeitung(person)) return true;
return aufgabe.creator_id === person.id || aufgabe.verantwortlich_id === person.id;
}
const SPALTEN = `
a.id, a.titel, a.beschreibung, a.status, a.prioritaet, a.frist,
a.creator_id, a.verantwortlich_id, a.erstellt, a.geaendert, a.erledigt_am,
pc.name AS creator_name, pv.name AS verantwortlich_name`;
const VERBUND = `
FROM aufgaben a
LEFT JOIN personen pc ON pc.id = a.creator_id
LEFT JOIN personen pv ON pv.id = a.verantwortlich_id`;
/* ---------- Lesen ------------------------------------------------------- */
aufgabenRouter.get("/workspace/api/aufgaben", (req, res) => {
try {
const { wo, werte } = sichtbar(req.person);
const reihen = db().prepare(`
SELECT ${SPALTEN} ${VERBUND}
WHERE ${wo}
ORDER BY
CASE a.prioritaet WHEN 'hoch' THEN 0 WHEN 'mittel' THEN 1 ELSE 2 END,
CASE WHEN a.frist IS NULL THEN 1 ELSE 0 END, a.frist,
a.id DESC`).all(...werte);
res.json({ aufgaben: reihen });
} catch (fehler) {
console.error("[workspace] Aufgaben lesen:", fehler?.message);
res.status(503).json({ fehler: "nicht_verfuegbar" });
}
});
aufgabenRouter.get("/workspace/api/uebersicht", (req, res) => {
try {
const { wo, werte } = sichtbar(req.person);
const zaehle = (zusatz, extra = []) => db()
.prepare(`SELECT COUNT(*) AS n ${VERBUND} WHERE ${wo}${zusatz}`)
.get(...werte, ...extra).n;
const heute = jetzt().slice(0, 10);
res.json({
offen: zaehle(" AND a.status = 'offen'"),
arbeit: zaehle(" AND a.status = 'arbeit'"),
review: zaehle(" AND a.status = 'review'"),
erledigt: zaehle(" AND a.status = 'erledigt'"),
/* Überfällig = Frist vorbei und noch nicht erledigt. Genau die Zahl,
die das Konzept auf dem Dashboard sehen will. */
ueberfaellig: zaehle(" AND a.status <> 'erledigt' AND a.frist IS NOT NULL AND a.frist < ?", [heute]),
heute: zaehle(" AND a.status <> 'erledigt' AND a.frist = ?", [heute]),
});
} catch (fehler) {
console.error("[workspace] Übersicht:", fehler?.message);
res.status(503).json({ fehler: "nicht_verfuegbar" });
}
});
/* Für die Zuweisung: wen darf ich überhaupt eintragen? Scouts bekommen
die Liste bewusst nicht -- sie sollen keine fremden Namen sehen. */
aufgabenRouter.get("/workspace/api/personen", (req, res) => {
try {
if (istLeitung(req.person)) {
return res.json({
personen: db().prepare(
"SELECT id, name, rolle FROM personen WHERE aktiv = 1 ORDER BY " + ROLLEN_SORTIERUNG + ", name").all(),
});
}
res.json({ personen: [{ id: req.person.id, name: req.person.name, rolle: req.person.rolle }] });
} catch {
res.status(503).json({ fehler: "nicht_verfuegbar" });
}
});
/* ---------- Anlegen und Ändern ------------------------------------------ */
function pruefeFelder(körper, { neu }) {
const fehler = [];
const aus = {};
if (neu || körper.titel !== undefined) {
const titel = String(körper.titel ?? "").trim();
if (titel.length < 2) fehler.push("Titel fehlt.");
else if (titel.length > TITEL_MAX) fehler.push(`Titel ist länger als ${TITEL_MAX} Zeichen.`);
else aus.titel = titel;
}
if (körper.beschreibung !== undefined) {
const t = String(körper.beschreibung ?? "").trim();
if (t.length > TEXT_MAX) fehler.push("Beschreibung ist zu lang.");
else aus.beschreibung = t || null;
}
if (körper.status !== undefined) {
if (!STATUS.includes(körper.status)) fehler.push("Unbekannter Status.");
else aus.status = körper.status;
}
if (körper.prioritaet !== undefined) {
if (!PRIORITAETEN.includes(körper.prioritaet)) fehler.push("Unbekannte Priorität.");
else aus.prioritaet = körper.prioritaet;
}
if (körper.frist !== undefined) {
const f = String(körper.frist ?? "").trim();
if (!f) aus.frist = null;
else if (!/^\d{4}-\d{2}-\d{2}$/.test(f) || Number.isNaN(Date.parse(f))) fehler.push("Frist ist kein gültiges Datum.");
else aus.frist = f;
}
for (const feld of ["creator_id", "verantwortlich_id"]) {
if (körper[feld] === undefined) continue;
const wert = körper[feld];
if (wert === null || wert === "") { aus[feld] = null; continue; }
const zahl = Number(wert);
if (!Number.isInteger(zahl) || zahl < 1) fehler.push("Ungültige Zuordnung.");
else aus[feld] = zahl;
}
return { aus, fehler };
}
aufgabenRouter.post("/workspace/api/aufgaben", gleicheHerkunft, (req, res) => {
try {
const { aus, fehler } = pruefeFelder(req.body || {}, { neu: true });
if (fehler.length) return res.status(400).json({ fehler: fehler.join(" ") });
/* Wer nicht Management ist, darf ausschließlich für sich selbst
anlegen -- egal, was im Aufruf steht. */
if (!istLeitung(req.person)) {
aus.creator_id = req.person.rolle === "creator" ? req.person.id : null;
aus.verantwortlich_id = req.person.id;
}
for (const feld of ["creator_id", "verantwortlich_id"]) {
if (aus[feld] && !db().prepare("SELECT 1 FROM personen WHERE id = ? AND aktiv = 1").get(aus[feld])) {
return res.status(400).json({ fehler: "Zugeordnete Person gibt es nicht." });
}
}
const { lastInsertRowid } = db().prepare(`
INSERT INTO aufgaben
(titel, beschreibung, status, prioritaet, creator_id, verantwortlich_id,
frist, erstellt, erstellt_von)
VALUES (?,?,?,?,?,?,?,?,?)`).run(
aus.titel, aus.beschreibung ?? null, aus.status ?? "offen",
aus.prioritaet ?? "mittel", aus.creator_id ?? null, aus.verantwortlich_id ?? null,
aus.frist ?? null, jetzt(), req.person.id);
protokolliere("aufgabe_angelegt", {
personId: req.person.id, rolle: req.person.rolle, ip: echteIp(req),
detail: `#${lastInsertRowid} ${aus.titel}`.slice(0, 120),
});
res.status(201).json({ id: Number(lastInsertRowid) });
} catch (fehler) {
console.error("[workspace] Aufgabe anlegen:", fehler?.message);
res.status(503).json({ fehler: "nicht_verfuegbar" });
}
});
aufgabenRouter.patch("/workspace/api/aufgaben/:id", gleicheHerkunft, (req, res) => {
try {
const id = Number(req.params.id);
if (!Number.isInteger(id)) return res.status(400).json({ fehler: "ungueltig" });
/* Erst mit der Sichtbarkeitsregel holen: Was jemand nicht sehen darf,
existiert für ihn auch nicht -- deshalb 404 und nicht 403. Sonst
liesse sich durch Ausprobieren herausfinden, welche Nummern es gibt. */
const { wo, werte } = sichtbar(req.person);
const aufgabe = db().prepare(
`SELECT a.* ${VERBUND} WHERE ${wo} AND a.id = ?`).get(...werte, id);
if (!aufgabe) return res.status(404).json({ fehler: "nicht_gefunden" });
if (!darfAendern(req.person, aufgabe)) return res.status(403).json({ fehler: "nicht_erlaubt" });
const { aus, fehler } = pruefeFelder(req.body || {}, { neu: false });
if (fehler.length) return res.status(400).json({ fehler: fehler.join(" ") });
/* Zuordnungen darf nur das Management verschieben. */
if (!istLeitung(req.person)) { delete aus.creator_id; delete aus.verantwortlich_id; }
const felder = Object.keys(aus);
if (!felder.length) return res.status(400).json({ fehler: "nichts_zu_aendern" });
const setz = felder.map((f) => `${f} = ?`);
const daten = felder.map((f) => aus[f]);
setz.push("geaendert = ?"); daten.push(jetzt());
if (aus.status === "erledigt" && aufgabe.status !== "erledigt") {
setz.push("erledigt_am = ?"); daten.push(jetzt());
} else if (aus.status && aus.status !== "erledigt") {
setz.push("erledigt_am = NULL");
}
db().prepare(`UPDATE aufgaben SET ${setz.join(", ")} WHERE id = ?`).run(...daten, id);
protokolliere("aufgabe_geaendert", {
personId: req.person.id, rolle: req.person.rolle, ip: echteIp(req),
detail: `#${id} ${felder.join(",")}`.slice(0, 120),
});
res.json({ ok: true });
} catch (fehler) {
console.error("[workspace] Aufgabe ändern:", fehler?.message);
res.status(503).json({ fehler: "nicht_verfuegbar" });
}
});
/* ---------- Löschen ------------------------------------------------------
Nur Management. Das Konzept will ausdrücklich, dass Erledigtes sichtbar
bleibt ("Erledigte Aufgaben verschwinden nicht") -- Löschen ist deshalb
der Ausnahmefall für Fehleinträge, nicht der normale Abschluss. Der
Titel wandert ins Protokoll, damit nachvollziehbar bleibt, was weg ist. */
aufgabenRouter.delete("/workspace/api/aufgaben/:id", gleicheHerkunft, (req, res) => {
try {
if (!istLeitung(req.person)) return res.status(403).json({ fehler: "nicht_erlaubt" });
const id = Number(req.params.id);
if (!Number.isInteger(id)) return res.status(400).json({ fehler: "ungueltig" });
const aufgabe = db().prepare("SELECT id, titel FROM aufgaben WHERE id = ?").get(id);
if (!aufgabe) return res.status(404).json({ fehler: "nicht_gefunden" });
db().prepare("DELETE FROM aufgaben WHERE id = ?").run(id);
protokolliere("aufgabe_geloescht", {
personId: req.person.id, rolle: req.person.rolle, ip: echteIp(req),
detail: `#${id} ${aufgabe.titel}`.slice(0, 120),
});
res.json({ ok: true });
} catch (fehler) {
console.error("[workspace] Aufgabe löschen:", fehler?.message);
res.status(503).json({ fehler: "nicht_verfuegbar" });
}
});