dogfather-universe/server/workspace-personen.js

/* =====================================================================
   workspace-personen.js — Personen und Zugangscodes über den Browser
   verwalten. Ausschließlich für die Rolle "admin".

   Bisher ging das nur per SSH über workspace-code.js. Das bleibt als
   Notweg bestehen (etwa wenn niemand mehr hineinkommt), für den Alltag
   ist es aber zu umständlich.

   Zum Anzeigen des Codes im Browser: Der Code wird genau einmal in der
   Antwort auf das Anlegen zurückgegeben und danach nirgends gespeichert
   -- in der Datenbank steht nur sein scrypt-Hash. Das ist dasselbe
   Verfahren, das etwa GitHub für Zugriffstoken verwendet. Er läuft über
   HTTPS und landet weder im Protokoll noch im Serverlog.
   ===================================================================== */

import express from "express";
import {
  db, protokolliere, echteIp, sitzungLesen, personAnlegen, codeNeu, personSperren, betreuungSetzen, istLeitung, istDogFather, ROLLEN_SORTIERUNG, ROLLEN_REIHE,
} from "./workspace.js";
import { sicherungJetzt } from "./workspace-sicherung.js";

export const personenRouter = express.Router();

/* Reihenfolge und Umfang kommen aus workspace.js -- eine eigene
   Liste hier waere die naechste Stelle, die beim Aendern vergessen wird. */
const ROLLEN = ROLLEN_REIHE;
const NAME_MAX = 60;

/* Nur Management. Alles andere bekommt 404 statt 403 -- wer nicht
   berechtigt ist, muss nicht erfahren, dass es diesen Bereich gibt. */
function nurAdmin(req, res, next) {
  const person = sitzungLesen(req);
  if (!person) return res.status(401).json({ fehler: "nicht_angemeldet" });
  if (!istLeitung(person)) return res.status(404).json({ fehler: "nicht_gefunden" });
  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();
}

personenRouter.use("/workspace/api/verwaltung", nurAdmin);

/* ---------------------------------------------------------------------
   Schranke: An DogFather und Managern aendert nur DogFather etwas.

   Sie haengt an JEDEM Weg mit einer :id, nicht an einzelnen Routen. Der
   erste Versuch sicherte nur Anlegen und Sperren ab -- und prompt blieb
   "neuer Zugangscode" offen. Ein Manager konnte DogFather einen neuen
   Code ausstellen, bekam ihn angezeigt und haette ihn damit aus seinem
   eigenen Konto ausgesperrt. Genau das soll "nur DogFather hat alle
   endgueltigen Rechte" verhindern.

   Als Schranke statt als Einzelpruefung, damit der naechste Weg, der
   hier dazukommt, automatisch mitgeschuetzt ist.                      */
function nurDogFatherBeiLeitung(req, res, next) {
  if (istDogFather(req.person)) return next();
  const id = Number(req.params.id);
  if (!Number.isInteger(id)) return next();
  const ziel = db().prepare("SELECT rolle FROM personen WHERE id = ?").get(id);
  if (ziel && (ziel.rolle === "admin" || ziel.rolle === "manager")) {
    return res.status(403).json({
      fehler: "An DogFather und Managern ändert nur DogFather etwas.",
    });
  }
  next();
}

/* ---------- Übersicht --------------------------------------------------- */

/* Sortierung: Die ROLLE zuerst, dann erst der Zustand.

   Vorher stand "p.aktiv DESC" ganz vorn -- dadurch wanderte jede
   gesperrte Person ans Ende der GESAMTEN Liste, quer durch alle Rollen.
   Ein gesperrter Manager stand also unter den Creators, und die
   Reihenfolge DogFather-Manager-Scout-Creator, die ueberall sonst gilt,
   war ausgerechnet auf der Personenseite aufgehoben.

   Jetzt: Rolle, dann Gesperrtes ans Ende SEINER Rolle, dann Name.

   (Der Kommentar steht bewusst hier und nicht in der Abfrage: Er enthaelt
   Rueckwaerts-Anfuehrungszeichen, und die beenden mitten in einer
   Zeichenkette genau diese -- der Server startete danach nicht mehr.) */
personenRouter.get("/workspace/api/verwaltung/personen", (req, res) => {
  try {
    res.json({
      personen: db().prepare(`
        SELECT p.id, p.name, p.rolle, p.aktiv, p.erstellt, p.letzter_login,
               (SELECT COUNT(*) FROM sitzungen s WHERE s.person_id = p.id) AS sitzungen,
               (SELECT COUNT(*) FROM aufgaben a
                 WHERE (a.creator_id = p.id OR a.verantwortlich_id = p.id)
                   AND a.status <> 'erledigt') AS offene_aufgaben,
               b.betreuer_id,
               (SELECT name FROM personen x WHERE x.id = b.betreuer_id) AS betreuer_name,
               (SELECT COUNT(*) FROM betreuung y WHERE y.betreuer_id = p.id) AS betreut_anzahl
        FROM personen p
        LEFT JOIN betreuung b ON b.creator_id = p.id
        ORDER BY ${ROLLEN_SORTIERUNG.replace("rolle", "p.rolle")}, p.aktiv DESC, p.name`).all(),
      /* Wer ueberhaupt als zustaendig eingetragen werden kann. */
      betreuer: db().prepare(
        "SELECT id, name FROM personen WHERE rolle = 'scout' AND aktiv = 1 ORDER BY name").all(),
    });
  } catch (fehler) {
    console.error("[workspace] Personen lesen:", fehler?.message);
    res.status(503).json({ fehler: "nicht_verfuegbar" });
  }
});

/* ---------- Zuständigkeit ------------------------------------------------
   Wer betreut welchen Creator. Nur das Management setzt das -- sonst
   koennte sich ein Scout selbst Creator zuteilen und haette damit die
   Rechtevergabe in der Hand, die ihn eigentlich begrenzen soll.         */

personenRouter.put("/workspace/api/verwaltung/betreuung/:id", gleicheHerkunft, (req, res) => {
  try {
    const id = Number(req.params.id);
    if (!Number.isInteger(id)) return res.status(400).json({ fehler: "ungueltig" });

    const creator = db().prepare("SELECT id, rolle FROM personen WHERE id = ?").get(id);
    if (!creator || creator.rolle !== "creator") {
      return res.status(404).json({ fehler: "nicht_gefunden" });
    }

    const w = req.body?.betreuer_id;
    if (w === null || w === "" || w === undefined) {
      betreuungSetzen(id, null, { ...req.person, ip: echteIp(req) });
      return res.json({ ok: true, betreuer_id: null });
    }

    const z = Number(w);
    if (!Number.isInteger(z) || z < 1) return res.status(400).json({ fehler: "Ungültige Auswahl." });
    const betreuer = db().prepare(
      "SELECT id, name, rolle FROM personen WHERE id = ? AND aktiv = 1").get(z);
    /* Nur Scouts. Das Management sieht ohnehin alle Creator und braucht
       keinen Eintrag -- einer waere irrefuehrend. */
    if (!betreuer || betreuer.rolle !== "scout") {
      return res.status(400).json({ fehler: "Zuständig können nur aktive Scouts sein." });
    }

    betreuungSetzen(id, z, { ...req.person, ip: echteIp(req) });
    res.json({ ok: true, betreuer_id: z, betreuer_name: betreuer.name });
  } catch (fehler) {
    console.error("[workspace] Betreuung setzen:", fehler?.message);
    res.status(503).json({ fehler: "nicht_verfuegbar" });
  }
});

/* ---------- Anlegen ----------------------------------------------------- */

personenRouter.post("/workspace/api/verwaltung/personen", gleicheHerkunft, (req, res) => {
  try {
    const name = String(req.body?.name ?? "").trim();
    const rolle = String(req.body?.rolle ?? "");
    if (name.length < 2) return res.status(400).json({ fehler: "Name fehlt." });
    if (name.length > NAME_MAX) return res.status(400).json({ fehler: "Name ist zu lang." });
    if (!ROLLEN.includes(rolle)) return res.status(400).json({ fehler: "Unbekannte Rolle." });

    /* ERSTER VORBEHALT: Eine Leitung anlegen darf nur DogFather.
       Duerfte ein Manager das, koennte er sich einen zweiten Zugang mit
       vollen Rechten schaffen -- und waere damit nicht mehr begrenzbar.
       "Nur DogFather hat alle endgueltigen Rechte" faengt hier an. */
    if (!istDogFather(req.person) && (rolle === "admin" || rolle === "manager")) {
      return res.status(403).json({
        fehler: "DogFather und Manager legt nur DogFather selbst an.",
      });
    }

    const vorhanden = db().prepare(
      "SELECT 1 FROM personen WHERE lower(name) = lower(?) AND aktiv = 1").get(name);
    if (vorhanden) return res.status(409).json({ fehler: "Diesen Namen gibt es schon." });

    const neu = personAnlegen(name, rolle, { ...req.person, ip: echteIp(req) });
    /* Der Code steht NUR hier in der Antwort. Danach ist er weg. */
    res.status(201).json({ id: neu.id, name: neu.name, rolle: neu.rolle, code: neu.code });
  } catch (fehler) {
    console.error("[workspace] Person anlegen:", fehler?.message);
    res.status(503).json({ fehler: "nicht_verfuegbar" });
  }
});

/* ---------- Neuer Code -------------------------------------------------- */

personenRouter.post("/workspace/api/verwaltung/personen/:id/code", gleicheHerkunft, nurDogFatherBeiLeitung, (req, res) => {
  try {
    const id = Number(req.params.id);
    if (!Number.isInteger(id)) return res.status(400).json({ fehler: "ungueltig" });
    if (id === req.person.id) {
      /* Sich selbst den Code zu tauschen wirft einen sofort hinaus (alle
         Sitzungen werden beendet). Erlaubt, aber nur bewusst. */
      if (!req.body?.auch_mich) {
        return res.status(400).json({ fehler: "eigener_code", hinweis:
          "Das beendet deine eigene Sitzung sofort." });
      }
    }
    const neu = codeNeu(id, { ...req.person, ip: echteIp(req) });
    res.json({ id: neu.id, name: neu.name, rolle: neu.rolle, code: neu.code });
  } catch (fehler) {
    if (/Keine Person/.test(fehler?.message || "")) {
      return res.status(404).json({ fehler: "nicht_gefunden" });
    }
    console.error("[workspace] Code erneuern:", fehler?.message);
    res.status(503).json({ fehler: "nicht_verfuegbar" });
  }
});

/* ---------- Sperren / Entsperren ---------------------------------------- */

personenRouter.patch("/workspace/api/verwaltung/personen/:id", gleicheHerkunft, nurDogFatherBeiLeitung, (req, res) => {
  try {
    const id = Number(req.params.id);
    if (!Number.isInteger(id)) return res.status(400).json({ fehler: "ungueltig" });

    const person = db().prepare("SELECT id, name, rolle, aktiv FROM personen WHERE id = ?").get(id);
    if (!person) return res.status(404).json({ fehler: "nicht_gefunden" });

    if (req.body?.aktiv !== undefined) {
      const aktiv = req.body.aktiv ? 1 : 0;
      /* Sich selbst zu sperren würde den letzten Zugang zusperren können.
         Deshalb gar nicht erst erlauben. */
      if (id === req.person.id && !aktiv) {
        return res.status(400).json({ fehler: "Du kannst dich nicht selbst sperren." });
      }
      /* Und niemals den letzten aktiven DogFather sperren -- sonst kann
         niemand mehr eine Leitung anlegen, auch kein Manager.
         Bewusst istDogFather und NICHT istLeitung: Manager duerfen
         gesperrt werden, es gibt ja noch DogFather. Die Massenumstellung
         auf istLeitung hatte das hier faelschlich mitgezogen -- gezaehlt
         werden aber nur DogFather-Zugaenge, also blockierte die Regel
         plotzlich auch das Sperren eines Managers. */
      if (!aktiv && istDogFather(person)) {
        const { n } = db().prepare(
          "SELECT COUNT(*) AS n FROM personen WHERE rolle = 'admin' AND aktiv = 1").get();
        if (n <= 1) return res.status(400).json({ fehler: "Das ist der letzte aktive DogFather-Zugang." });
      }
      personSperren(id, aktiv, { ...req.person, ip: echteIp(req) });
    }

    if (req.body?.name !== undefined) {
      const name = String(req.body.name).trim();
      if (name.length < 2 || name.length > NAME_MAX) {
        return res.status(400).json({ fehler: "Name ist ungültig." });
      }
      db().prepare("UPDATE personen SET name = ? WHERE id = ?").run(name, id);
      protokolliere("person_umbenannt", {
        personId: req.person.id, rolle: req.person.rolle, ip: echteIp(req),
        detail: `${person.name} -> ${name}`,
      });
    }

    res.json({ ok: true });
  } catch (fehler) {
    console.error("[workspace] Person ändern:", fehler?.message);
    res.status(503).json({ fehler: "nicht_verfuegbar" });
  }
});

/* =====================================================================
   Löschen.

   Wunsch Filipe, 31.08.2026: "ich will auch die möglichkeit haben die
   löschen zu können."

   Das ist die einzige Handlung im ganzen Workspace, die sich nicht
   rückgängig machen lässt. Deshalb vier Vorkehrungen:

   1. NUR DOGFATHER. Nicht die Leitung, nicht ein Manager -- "nur
      DogFather hat alle endgültigen Rechte" heisst genau hier etwas.
      Ein Manager kann weiterhin sperren; das reicht für den Alltag und
      ist umkehrbar.

   2. VORSCHAU, was daran hängt. Man muss VOR dem Klick sehen, was
      mitgeht und was nur seine Zuordnung verliert. Ohne diese Liste
      löscht man ein Creator-Profil und merkt erst Wochen später, dass
      damit auch der Start-Check und die Content-Säulen weg sind.

   3. EINE SICHERUNG DIREKT DAVOR. Das ist der eigentliche Gewinn aus der
      Sicherungsarbeit von heute: Vor jedem Löschen schreibt der Server
      eine vollständige, sofort geprüfte Sicherung. Geht sie schief, wird
      NICHT gelöscht. Damit ist "gelöscht" wiederherstellbar -- aus einer
      unumkehrbaren Handlung wird eine, die man zurückholen kann.

   4. Sich selbst und den letzten DogFather nie. Dieselbe Regel wie beim
      Sperren, aus demselben Grund: Sonst sperrt man sich aus.

   Was BLEIBT: Aufgaben, Termine, Bereichseinträge, Dateien und
   Protokollzeilen. Sie verlieren nur den Verweis auf die Person
   (ON DELETE SET NULL). Das ist Absicht -- eine Aufgabe verschwinden zu
   lassen, weil jemand geht, wäre Geschichtsfälschung.

   Was MITGEHT (ON DELETE CASCADE): Profil, Start-Check, Content-Säulen,
   Sitzungen, Zuständigkeit. Dinge, die es ohne die Person nicht gibt.
   ===================================================================== */

/* Was hängt an dieser Person? Wird von der Vorschau UND vom Löschen
   benutzt -- damit die Anzeige nicht etwas anderes behaupten kann, als
   das Löschen dann tut. */
function anhang(id) {
  const zahl = (sql, ...w) => db().prepare(sql).get(id, ...w)?.n ?? 0;
  return {
    mit: {
      "Profil": zahl("SELECT COUNT(*) AS n FROM profile WHERE person_id = ?"),
      "Start-Check": zahl("SELECT COUNT(*) AS n FROM startcheck WHERE creator_id = ?"),
      "Content-Säulen": zahl("SELECT COUNT(*) AS n FROM content_saeulen WHERE creator_id = ?"),
      "offene Sitzungen": zahl("SELECT COUNT(*) AS n FROM sitzungen WHERE person_id = ?"),
    },
    bleibt: {
      "Aufgaben": zahl("SELECT COUNT(*) AS n FROM aufgaben WHERE creator_id = ? OR verantwortlich_id = ?", id),
      "Einträge in den Bereichen": zahl("SELECT COUNT(*) AS n FROM eintraege WHERE creator_id = ?"),
      "Termine": zahl("SELECT COUNT(*) AS n FROM termine WHERE creator_id = ? OR teilnehmer_id = ?", id),
      "Dateien": zahl("SELECT COUNT(*) AS n FROM dateien WHERE creator_id = ?"),
      "Leads in der Pipeline": zahl("SELECT COUNT(*) AS n FROM leads WHERE scout_id = ? OR creator_id = ?", id),
    },
    /* Der gefährlichste Einzelfall: Wer einen Scout löscht, nimmt seinen
       Creators die zuständige Person weg -- und die stehen danach ohne
       Betreuung da, ohne dass jemand etwas davon mitbekommt. */
    verliertBetreuung: db().prepare(
      "SELECT p.name FROM betreuung b JOIN personen p ON p.id = b.creator_id WHERE b.betreuer_id = ?")
      .all(id).map((r) => r.name),
  };
}

/* Alles, was gegen ein Löschen spricht -- als Fehlertext oder null.
   Steht getrennt, damit Vorschau und Löschen GARANTIERT dieselbe Antwort
   geben. Zwei Stellen mit derselben Regel laufen irgendwann auseinander. */
function darfGeloeschtWerden(person, akteur) {
  if (!istDogFather(akteur)) return "Löschen darf nur DogFather.";
  if (person.id === akteur.id) return "Dich selbst kannst du nicht löschen.";
  if (istDogFather(person)) {
    const { n } = db().prepare("SELECT COUNT(*) AS n FROM personen WHERE rolle = 'admin'").get();
    if (n <= 1) return "Das ist der letzte DogFather-Zugang.";
  }
  return null;
}

personenRouter.get("/workspace/api/verwaltung/personen/:id/loeschbar", (req, res) => {
  try {
    const id = Number(req.params.id);
    if (!Number.isInteger(id)) return res.status(400).json({ fehler: "ungueltig" });
    /* Wer gar nicht löschen darf, sieht auch die Vorschau nicht -- sie
       verrät, wie viel an einer Person hängt. */
    if (!istDogFather(req.person)) return res.status(404).json({ fehler: "nicht_gefunden" });

    const person = db().prepare("SELECT id, name, rolle, aktiv FROM personen WHERE id = ?").get(id);
    if (!person) return res.status(404).json({ fehler: "nicht_gefunden" });

    res.json({
      person: { id: person.id, name: person.name, rolle: person.rolle, aktiv: person.aktiv },
      hindernis: darfGeloeschtWerden(person, req.person),
      ...anhang(id),
    });
  } catch (fehler) {
    console.error("[workspace] Löschvorschau:", fehler?.message);
    res.status(503).json({ fehler: "nicht_verfuegbar" });
  }
});

personenRouter.delete("/workspace/api/verwaltung/personen/:id", gleicheHerkunft, (req, res) => {
  try {
    const id = Number(req.params.id);
    if (!Number.isInteger(id)) return res.status(400).json({ fehler: "ungueltig" });
    if (!istDogFather(req.person)) return res.status(404).json({ fehler: "nicht_gefunden" });

    const person = db().prepare("SELECT id, name, rolle, aktiv FROM personen WHERE id = ?").get(id);
    if (!person) return res.status(404).json({ fehler: "nicht_gefunden" });

    const hindernis = darfGeloeschtWerden(person, req.person);
    if (hindernis) return res.status(400).json({ fehler: hindernis });

    /* Der Name muss wortwörtlich mitgeschickt werden. Nicht als Schikane:
       Der Löschknopf sitzt neben dem Sperrknopf, und die beiden sind sehr
       verschieden. Wer den Namen tippt, hat die Zeile gelesen, die er
       trifft. */
    if (String(req.body?.name ?? "").trim() !== person.name) {
      return res.status(400).json({ fehler: "Zum Löschen bitte den Namen genau eingeben." });
    }

    const vorher = anhang(id);

    /* Sicherung DIREKT davor -- scheitert sie, wird nicht gelöscht. Das
       ist der Punkt, an dem aus "unumkehrbar" "wiederherstellbar" wird. */
    let sicherung = null;
    try {
      /* Eigene Datei mit Uhrzeit -- drei Loeschungen hintereinander
         wuerden sonst dreimal dieselbe Tagessicherung ueberschreiben,
         und die erste geloeschte Person waere trotzdem weg. */
      sicherung = sicherungJetzt("vor dem Löschen von " + person.name, true);
    } catch (fehler) {
      console.error("[workspace] Sicherung vor dem Löschen:", fehler?.message);
      return res.status(503).json({
        fehler: "Die Sicherung vor dem Löschen ist fehlgeschlagen – es wurde nichts gelöscht.",
      });
    }

    /* Fremdschlüssel müssen an sein, sonst greifen CASCADE und SET NULL
       nicht und es bleiben Reste zurück, die auf niemanden mehr zeigen. */
    db().exec("PRAGMA foreign_keys = ON");
    db().prepare("DELETE FROM personen WHERE id = ?").run(id);

    protokolliere("person_geloescht", {
      personId: req.person.id, rolle: req.person.rolle, ip: echteIp(req),
      detail: `${person.name} (${person.rolle}) · Sicherung: ${sicherung.datei}`.slice(0, 160),
    });

    res.json({ ok: true, sicherung: sicherung.datei, war: vorher });
  } catch (fehler) {
    console.error("[workspace] Person löschen:", fehler?.message);
    res.status(503).json({ fehler: "nicht_verfuegbar" });
  }
});

/* ---------- Protokoll ---------------------------------------------------- */

personenRouter.get("/workspace/api/verwaltung/protokoll", (req, res) => {
  try {
    const anzahl = Math.min(Math.max(Number(req.query.anzahl) || 40, 1), 200);
    res.json({
      eintraege: db().prepare(`
        SELECT k.zeitpunkt, k.aktion, k.rolle, k.detail, k.ip, p.name AS wer
        FROM protokoll k LEFT JOIN personen p ON p.id = k.person_id
        ORDER BY k.id DESC LIMIT ?`).all(anzahl),
    });
  } catch {
    res.status(503).json({ fehler: "nicht_verfuegbar" });
  }
});