dogfather-universe/server/workspace-steckbrief.js

/* =====================================================================
   workspace-steckbrief.js — das eigene Profil jeder Person.

   Jeder im Workspace, egal ob Creator, Scout, Manager oder DogFather,
   hat einen Steckbrief: ein Bild, einen Satz über sich, und die Kanäle,
   auf denen er unterwegs ist.

   WARUM KEINE ECHTE TIKTOK-ANMELDUNG.
   „Mit TikTok verbinden" klingt nach OAuth. Das wäre hier aber:
     * ein TikTok-Entwicklerkonto mit App-Freischaltung,
     * eine Prüfung durch TikTok, die Wochen dauern kann und widerrufbar
       ist,
     * ein Zugriffstoken je Person, das ablaufen kann, erneuert werden
       muss und — wenn es abhandenkommt — fremden Zugriff auf ein
       fremdes Konto bedeutet,
     * eine Abhängigkeit von einer Schnittstelle, die sich ändern kann,
       ohne dass wir gefragt werden.
   Dafür bekäme man: Follower-Zahlen und Video-Statistiken.

   Gebraucht wird hier aber etwas anderes: „Wer ist das, und wo finde ich
   ihn?" Dafür genügt der öffentliche Name. Gespeichert wird deshalb NUR
   das Handle (ohne @) — kein Token, kein Passwort, nichts, was
   abhandenkommen kann. Daraus wird ein Verweis auf den Kanal, und in der
   Personenliste steht, wer wo unterwegs ist.

   Sollen später echte Zahlen dazukommen, ist das ein eigenes Vorhaben
   mit eigener Entscheidung — der Name hier bleibt dann trotzdem richtig.

   DAS BILD liegt als Datei neben der Datenbank, nicht darin. Bilder in
   SQLite zu legen bläht jede Sicherung auf, und die läuft jede Nacht.
   In der Datenbank steht nur der erzeugte Dateiname.

   Sicherheit beim Bild — die Stelle, an der Profilbilder typischerweise
   scheitern:
     1. Der Dateityp wird an der SIGNATUR der Datei geprüft, nicht am
        Content-Type, den der Browser behauptet. Ein umbenanntes SVG mit
        Skript darin käme sonst durch und würde im Namen der Domain
        ausgeführt.
     2. Auf der Platte bekommt jede Datei einen Zufallsnamen. Damit kann
        kein Name Pfade verlassen (../) oder etwas überschreiben.
     3. Ausgeliefert wird mit nosniff und einer eigenen, alles
        verbietenden Inhaltsregel.
   ===================================================================== */

import express from "express";
import {
  randomBytes } from "node:crypto";
import { join } from "node:path";
import { mkdirSync, writeFileSync, unlinkSync, existsSync } from "node:fs";
import { liefereDatei } from "./helfer-ausliefern.mjs";
import {
  db, protokolliere, echteIp, sitzungLesen, DATEN_ORDNER,
  istLeitung, betreuteIds, ROLLEN_SORTIERUNG, ROLLEN_NAME,
  sichtbarePersonenIds,
} from "./workspace.js";

export const steckbriefRouter = express.Router();

const ORDNER = join(DATEN_ORDNER, "profilbilder");
const MAX_BYTES = 4 * 1024 * 1024;      // 4 MB — ein Profilbild braucht nicht mehr
const UEBER_MAX = 400;
const NAME_MAX = 40;

/* Die Kanäle. Der Schlüssel ist zugleich der Spaltenname; das Muster
   begrenzt, was ein Handle sein darf, und die Adresse baut den Verweis.
   Alles an einer Stelle — sonst steht das Muster in der Prüfung und die
   Adresse in der Oberfläche, und beim nächsten Kanal wird eines davon
   vergessen. */
export const KANAELE = {
  tiktok:    { name: "TikTok",    muster: /^[a-zA-Z0-9._]{2,24}$/,  adresse: (h) => `https://www.tiktok.com/@${h}` },
  instagram: { name: "Instagram", muster: /^[a-zA-Z0-9._]{2,30}$/,  adresse: (h) => `https://www.instagram.com/${h}/` },
  youtube:   { name: "YouTube",   muster: /^[a-zA-Z0-9._-]{3,30}$/, adresse: (h) => `https://www.youtube.com/@${h}` },
  twitch:    { name: "Twitch",    muster: /^[a-zA-Z0-9_]{4,25}$/,   adresse: (h) => `https://www.twitch.tv/${h}` },
};

const jetzt = () => new Date().toISOString();

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();
}

steckbriefRouter.use("/workspace/api/steckbrief", angemeldet);

/* ---------- Wen darf ich sehen? -----------------------------------------

   Sich selbst immer. Die Leitung alle. Ein Scout die Creator, die er
   betreut. Ein Creator zusätzlich die Menschen, die IHN betreuen -- er
   soll wissen, wer sein Ansprechpartner ist, sonst steht dort ein Name
   ohne Gesicht.

   Alles andere ist 404, nicht 403: Wer eine Person nicht sehen darf,
   soll auch nicht erfahren, dass es sie gibt. */
function sichtbareIds(person) {
  /* NICHT mehr istLeitung (03.09.2026): Eine Managerin bekam damit die
     Steckbriefe ALLER -- Bild, Kanaele, "ueber mich" -- auch von
     Creators, die ihr nie zugeteilt waren. Jetzt gilt fuer sie dieselbe
     Zuteilungsregel wie fuer einen Scout, nur mit der Kette ueber ihre
     Scouts dazu (sichtbarePersonenIds). null bleibt "alle" und
     bekommt allein DogFather. */
  const erlaubt = sichtbarePersonenIds(person);
  if (erlaubt === null) return null;              // null = alle
  const eigene = new Set(erlaubt);
  eigene.add(person.id);
  if (person.rolle === "creator") {
    /* Die eigenen Betreuer -- und die Leitung, die ohnehin für alle
       zuständig ist. */
    for (const z of db().prepare(
      "SELECT betreuer_id AS id FROM betreuung WHERE creator_id = ?").all(person.id)) {
      eigene.add(z.id);
    }
    for (const z of db().prepare(
      "SELECT id FROM personen WHERE rolle IN ('admin','manager') AND aktiv = 1").all()) {
      eigene.add(z.id);
    }
  }
  return eigene;
}

const SPALTEN = `p.id, p.name, p.rolle, p.aktiv, p.erstellt, p.letzter_login,
  p.bild, p.ueber_mich, p.tiktok, p.instagram, p.youtube, p.twitch`;

/** Eine Zeile aus der Datenbank in das, was nach außen geht. Die Kanäle
 *  kommen als fertige Verweise mit -- damit die Oberfläche die Adressen
 *  nicht ein zweites Mal zusammenbauen muss (und dabei anders). */
/* WER GEHOERT IN WELCHEN ABSCHNITT (19.09.2026).

   DIE ZUORDNUNG STEHT HIER UND NICHT IM BROWSER, aus zwei Gruenden.

   Der erste ist ein Fehler, den sie behebt: In assets/js/steckbrief.js
   stand eine Liste aus drei Gruppen -- Management, Scouting, Creator.
   Wer eine andere Rolle hatte, passte in keine und verschwand
   LAUTLOS aus der Uebersicht. Betroffen waren ausgerechnet die
   rechte Hand und die Modis: Ein Modi, der die Seite oeffnete, sah
   seine eigenen Leute nicht.

   Der zweite ist die Hausregel: Rollennamen der Community gehoeren
   nicht in eine Datei, die jeder Besucher herunterladen kann. Eine
   Liste ['modi','hand','gast'] im Browser waere genau das.

   OHNE ABSCHNITT GIBT ES EINEN SAMMELPLATZ. Kommt morgen eine Rolle
   dazu und wird hier vergessen, steht sie unter „Weitere" -- sichtbar
   und mit einem schiefen Namen. Das ist besser als lautlos weg. */
const ABSCHNITTE = {
  admin:   { name: "Leitung", text: "Wer freigibt und entscheidet." },
  manager: { name: "Leitung", text: "Wer freigibt und entscheidet." },
  hand:    { name: "Team Dogi", text: "Wer den Laden mit am Laufen hält." },
  /* DIE LINKE HAND FEHLTE (23.09.2026).

     Gefunden von pruef-jeder-hat-eine-seite: „alle 9 Rollen sind
     zugeordnet -- fehlt: linke". Sie landete damit im Sammelplatz
     „Weitere" -- auf der Übersicht über die Menschen des Hauses stand
     sie unter einer Überschrift ohne Bedeutung, neben niemandem.

     Sie gehört dorthin, wo die rechte Hand steht: Beide führen Team
     Dogi mit. Eine eigene Überschrift mit einem Namen darunter wäre
     mehr Gliederung als Inhalt -- derselbe Gedanke steht schon bei
     ROLLEN_GRUPPE.

     WARUM DIE PRÜFUNG DAS FINDEN KONNTE und ein Mensch nicht: Sie
     geht ALLE Rollen des Hauses durch, nicht die vier, die zufällig
     angelegt sind. Eine Zuordnung, die man an den vorhandenen Leuten
     prüft, ist eine Aussage über die Testdaten. */
  linke:   { name: "Team Dogi", text: "Wer den Laden mit am Laufen hält." },
  modi:    { name: "Moderation", text: "Wer im Rudel und im Stream nach dem Rechten sieht." },
  scout:   { name: "Scouting", text: "Sie finden neue Creator und begleiten den Anfang." },
  creator: { name: "Creator", text: "Die Leute, um die es geht." },
  gast:    { name: "Community", text: "Die Leute, die zuschauen und mitmachen." },
  spicy:   { name: "Leitung", text: "Wer freigibt und entscheidet." },
};
const ABSCHNITT_SONST = { name: "Weitere", text: "" };

/** Welcher Abschnitt gehoert zu dieser Rolle?
 *
 *  Ausgeleitet, damit die Pruefung die GEGENPROBE machen kann: Eine
 *  Rolle, die hier fehlt, muss sichtbar unter „Weitere" landen und darf
 *  nicht verschwinden. Ohne diesen Zugang waere „niemand faellt heraus"
 *  eine Behauptung ueber die fuenf Rollen, die es heute gibt. */
export function abschnittFuer(rolle) {
  return ABSCHNITTE[rolle] || ABSCHNITT_SONST;
}

function hinaus(z) {
  const kanaele = [];
  for (const [schluessel, k] of Object.entries(KANAELE)) {
    const handle = z[schluessel];
    if (handle) kanaele.push({ art: schluessel, name: k.name, handle, adresse: k.adresse(handle) });
  }
  const abschnitt = ABSCHNITTE[z.rolle] || ABSCHNITT_SONST;
  return {
    id: z.id, name: z.name, rolle: z.rolle,
    rolle_name: ROLLEN_NAME[z.rolle] ?? z.rolle,
    abschnitt: abschnitt.name,
    abschnitt_text: abschnitt.text,
    aktiv: !!z.aktiv, erstellt: z.erstellt, letzter_login: z.letzter_login,
    bild: z.bild ? `/workspace/api/steckbrief/bild/${z.bild}` : null,
    ueber_mich: z.ueber_mich || null,
    kanaele,
  };
}

/* ---------- Lesen -------------------------------------------------------- */

/** Der eigene Steckbrief. Eigener Weg statt /:id mit der eigenen Nummer:
 *  Die Oberfläche soll ihn holen können, ohne vorher zu wissen, wer sie
 *  ist. */
steckbriefRouter.get("/workspace/api/steckbrief/mein", (req, res) => {
  try {
    const z = db().prepare(`SELECT ${SPALTEN} FROM personen p WHERE p.id = ?`).get(req.person.id);
    if (!z) return res.status(404).json({ fehler: "nicht_gefunden" });
    res.json({ steckbrief: hinaus(z), kanaele: KANAELE_ANZEIGE });
  } catch (fehler) {
    console.error("[workspace] Steckbrief lesen:", fehler?.message);
    res.status(503).json({ fehler: "nicht_verfuegbar" });
  }
});

/* Was die Oberfläche über die Kanäle wissen muss, ohne die Muster als
   regulären Ausdruck zu übertragen. */
const KANAELE_ANZEIGE = Object.entries(KANAELE).map(([art, k]) => ({ art, name: k.name }));

/** Alle Steckbriefe, die ich sehen darf. Für die Personenliste und das
 *  Dashboard -- dort steht dann ein Bild statt eines Buchstabens. */
steckbriefRouter.get("/workspace/api/steckbrief", (req, res) => {
  try {
    const erlaubt = sichtbareIds(req.person);
    const alle = db().prepare(
      `SELECT ${SPALTEN} FROM personen p WHERE p.aktiv = 1
       ORDER BY ${ROLLEN_SORTIERUNG.replace(/rolle/g, "p.rolle")}, p.name`).all();
    const meine = erlaubt ? alle.filter((z) => erlaubt.has(z.id)) : alle;
    res.json({ steckbriefe: meine.map(hinaus) });
  } catch (fehler) {
    console.error("[workspace] Steckbriefe lesen:", fehler?.message);
    res.status(503).json({ fehler: "nicht_verfuegbar" });
  }
});

steckbriefRouter.get("/workspace/api/steckbrief/:id(\\d+)", (req, res) => {
  try {
    const erlaubt = sichtbareIds(req.person);
    const id = Number(req.params.id);
    if (erlaubt && !erlaubt.has(id)) return res.status(404).json({ fehler: "nicht_gefunden" });
    const z = db().prepare(`SELECT ${SPALTEN} FROM personen p WHERE p.id = ?`).get(id);
    if (!z) return res.status(404).json({ fehler: "nicht_gefunden" });
    res.json({ steckbrief: hinaus(z) });
  } catch (fehler) {
    console.error("[workspace] Steckbrief lesen:", fehler?.message);
    res.status(503).json({ fehler: "nicht_verfuegbar" });
  }
});

/* ---------- Ändern ------------------------------------------------------

   Nur den EIGENEN. Auch die Leitung schreibt niemandem etwas ins Profil:
   Ein Satz über sich und der eigene Kanalname gehören der Person, nicht
   ihrem Vorgesetzten. (Löschen einer Person geht weiterhin über die
   Personenverwaltung -- das ist etwas anderes.) */

steckbriefRouter.patch("/workspace/api/steckbrief/mein", gleicheHerkunft,
  express.json({ limit: "16kb" }), (req, res) => {
    try {
      const setzen = [];
      const werte = [];
      const fehler = [];

      if (req.body.ueber_mich !== undefined) {
        const t = String(req.body.ueber_mich ?? "").trim();
        if (t.length > UEBER_MAX) fehler.push(`Der Text darf höchstens ${UEBER_MAX} Zeichen haben.`);
        else { setzen.push("ueber_mich = ?"); werte.push(t || null); }
      }

      for (const [art, k] of Object.entries(KANAELE)) {
        if (req.body[art] === undefined) continue;
        /* Ein führendes @ und eine ganze Adresse sind das, was Leute
           tatsächlich einfügen -- beides wird angenommen und auf den
           Namen zurückgeführt, statt es abzulehnen. Eine Fehlermeldung
           für ein vorangestelltes @ wäre schlechte Arbeit. */
        let h = String(req.body[art] ?? "").trim();
        h = h
          .replace(/^https?:\/\/[^/]+\//i, "")   // ganze Adresse -> Rest
          .replace(/^@/, "")                     // führendes @
          .replace(/[?#].*$/, "")                // Parameter und Anker
          .replace(/\/.*$/, "");                 // alles ab dem nächsten /
        /* Die Reihenfolge ist wichtig, und das ? kam erst nach einem
           Fehlschlag dazu: Was die TikTok-App beim Teilen kopiert, ist
           "https://www.tiktok.com/@name?lang=de&is_from_webapp=1" -- also
           genau das, was jemand einfügt. Ohne diese Zeile wurde daraus
           "name?lang=de", das Muster passte nicht, und der Nutzer bekam
           "sieht nicht richtig aus" zu lesen, obwohl er den offiziellen
           Link benutzt hat. */
        if (!h) { setzen.push(`${art} = ?`); werte.push(null); continue; }
        if (h.length > NAME_MAX || !k.muster.test(h)) {
          fehler.push(`Der ${k.name}-Name sieht nicht richtig aus.`);
          continue;
        }
        setzen.push(`${art} = ?`);
        werte.push(h);
      }

      if (fehler.length) return res.status(400).json({ fehler: fehler.join(" ") });
      if (!setzen.length) return res.status(400).json({ fehler: "Nichts zu ändern." });

      werte.push(req.person.id);
      db().prepare(`UPDATE personen SET ${setzen.join(", ")} WHERE id = ?`).run(...werte);
      protokolliere("steckbrief_geaendert", req.person, echteIp(req), `${setzen.length} Feld(er)`);

      const z = db().prepare(`SELECT ${SPALTEN} FROM personen p WHERE p.id = ?`).get(req.person.id);
      res.json({ steckbrief: hinaus(z) });
    } catch (fehler) {
      console.error("[workspace] Steckbrief ändern:", fehler?.message);
      res.status(503).json({ fehler: "nicht_verfuegbar" });
    }
  });

/* ---------- Das Bild ----------------------------------------------------- */

/** Erkennt den Bildtyp an der SIGNATUR der Datei. Der Content-Type, den
 *  der Browser mitschickt, ist nur eine Behauptung -- ein umbenanntes
 *  SVG mit Skript darin käme darüber durch. */
function bildart(puffer) {
  if (puffer.length < 12) return null;
  if (puffer[0] === 0xff && puffer[1] === 0xd8 && puffer[2] === 0xff) return { typ: "image/jpeg", endung: "jpg" };
  if (puffer[0] === 0x89 && puffer[1] === 0x50 && puffer[2] === 0x4e && puffer[3] === 0x47) {
    return { typ: "image/png", endung: "png" };
  }
  if (puffer.toString("ascii", 0, 4) === "RIFF" && puffer.toString("ascii", 8, 12) === "WEBP") {
    return { typ: "image/webp", endung: "webp" };
  }
  return null;
}

/* Ein zu grosses Bild ist kein Serverfehler, sondern eine ganz normale
   Eingabe -- und der Absender soll erfahren, WAS zu tun ist.

   Ohne diese Stelle wirft express.raw() bei Überschreitung einen
   PayloadTooLargeError, der bis in die allgemeine Fehlerbehandlung
   durchläuft: Der Nutzer bekäme "500 Serverfehler" zu lesen und wüsste
   nicht, dass sein Bild einfach zu gross ist. Aufgefallen ist das erst,
   als die Prüfung ein 5-MB-Bild geschickt hat -- von Hand probiert
   hätte das vermutlich nie jemand. */
function zuGross(fehler, req, res, next) {
  if (fehler?.type === "entity.too.large") {
    return res.status(413).json({
      fehler: `Das Bild ist zu gross. Erlaubt sind ${Math.round(MAX_BYTES / 1024 / 1024)} MB.` });
  }
  return next(fehler);
}

steckbriefRouter.post("/workspace/api/steckbrief/bild", gleicheHerkunft,
  express.raw({ type: "*/*", limit: MAX_BYTES }), zuGross, (req, res) => {
    try {
      const puffer = req.body;
      if (!puffer || !puffer.length) return res.status(400).json({ fehler: "Keine Datei angekommen." });

      const art = bildart(puffer);
      if (!art) {
        return res.status(400).json({
          fehler: "Das ist kein Bild. Erlaubt sind JPG, PNG und WebP." });
      }

      mkdirSync(ORDNER, { recursive: true });
      const datei = `${randomBytes(16).toString("hex")}.${art.endung}`;
      writeFileSync(join(ORDNER, datei), puffer);

      /* Das alte Bild wegräumen -- sonst sammelt sich bei jedem Wechsel
         eine weitere Datei an, die niemand mehr findet. */
      const vorher = db().prepare("SELECT bild FROM personen WHERE id = ?").get(req.person.id)?.bild;
      db().prepare("UPDATE personen SET bild = ? WHERE id = ?").run(datei, req.person.id);
      if (vorher && vorher !== datei) {
        try { unlinkSync(join(ORDNER, vorher)); } catch { /* war schon weg */ }
      }

      protokolliere("profilbild", req.person, echteIp(req), `${Math.round(puffer.length / 1024)} KB`);
      res.json({ bild: `/workspace/api/steckbrief/bild/${datei}` });
    } catch (fehler) {
      console.error("[workspace] Profilbild:", fehler?.message);
      res.status(503).json({ fehler: "nicht_verfuegbar" });
    }
  });

steckbriefRouter.delete("/workspace/api/steckbrief/bild", gleicheHerkunft, (req, res) => {
  try {
    const vorher = db().prepare("SELECT bild FROM personen WHERE id = ?").get(req.person.id)?.bild;
    db().prepare("UPDATE personen SET bild = NULL WHERE id = ?").run(req.person.id);
    if (vorher) { try { unlinkSync(join(ORDNER, vorher)); } catch { /* war schon weg */ } }
    res.json({ ok: true });
  } catch (fehler) {
    console.error("[workspace] Profilbild löschen:", fehler?.message);
    res.status(503).json({ fehler: "nicht_verfuegbar" });
  }
});

/** Ein Bild ausliefern. Der Name muss GENAU dem erzeugten Muster
 *  entsprechen -- damit kann kein Pfad verlassen werden, auch nicht
 *  über kodierte Zeichen. */
steckbriefRouter.get("/workspace/api/steckbrief/bild/:datei", (req, res) => {
  try {
    const datei = String(req.params.datei);
    if (!/^[a-f0-9]{32}\.(jpg|png|webp)$/.test(datei)) return res.status(404).end();
    const pfad = join(ORDNER, datei);
    if (!existsSync(pfad)) return res.status(404).end();

    const typ = datei.endsWith(".jpg") ? "image/jpeg"
      : datei.endsWith(".png") ? "image/png" : "image/webp";
    res.setHeader("Content-Type", typ);
    res.setHeader("X-Content-Type-Options", "nosniff");
    /* Eigene, alles verbietende Inhaltsregel: Selbst wenn eine Datei
       jemals durchkäme, die der Browser als etwas anderes liest, darf
       sie nichts nachladen und nichts ausführen. */
    res.setHeader("Content-Security-Policy", "default-src 'none'; sandbox");
    /* Der Dateiname ist zufällig und ändert sich bei jedem neuen Bild --
       er darf deshalb lange zwischengespeichert werden. */
    res.setHeader("Cache-Control", "private, max-age=604800");
    liefereDatei(req, res, pfad);
  } catch (fehler) {
    console.error("[workspace] Profilbild lesen:", fehler?.message);
    res.status(404).end();
  }
});