dogfather-universe/workspace/assets/js/anleitung.js

/* =====================================================================
   anleitung.js — die Einweisung je Rolle (Etappe 1)

   ---------------------------------------------------------------------
   DIE KARTEN ENTSTEHEN AUS ZWEI QUELLEN, UND DAS IST DER PUNKT

   Der Server liefert je Kachel die STUFE und drei Sätze. Name, Symbol,
   Farbe und Adresse kommen aus `window.Bereiche` — derselben Liste, aus
   der die Startseite ihre Kacheln baut.

   Deshalb sieht eine Karte hier aus wie die echte Kachel, und zwar
   dauerhaft: Wird eine Kachel umbenannt oder bekommt sie eine andere
   Farbe, ändert sich die Karte mit. Stünde der Name in der Datenbank,
   wäre die Anleitung ab diesem Tag eine Beschreibung von etwas, das es
   nicht mehr gibt — und niemandem würde es auffallen.

   Verbunden wird über `Bereiche.schluesselVonZiel`.
   ===================================================================== */
(() => {
  'use strict';

  const BASIS = '/workspace/api/anleitung';

  /* Der zuletzt geladene Stand. Gebraucht, weil die Pflege nach dem
     Speichern neu zeichnen muss -- und weil der Schalter "bearbeiten"
     dieselben Daten noch einmal braucht, ohne sie erneut zu holen. */
  let daten = null;
  let pflegeAn = false;

  const el = (tag, klasse, text) => {
    const k = document.createElement(tag);
    if (klasse) k.className = klasse;
    if (text !== undefined) k.textContent = text;
    return k;
  };
  const $ = (id) => document.getElementById(id);
  /** „2026-10-13" -> „13.10.2026". Der Server schickt den Tag in der
   *  sortierbaren Form; gelesen wird hier die gewohnte.
   *
   *  OHNE $ AM ENDE — und das ist nachgemessen, nicht geraten. Es
   *  kommen ZWEI Formen herein, und sie sehen nur am Anfang gleich aus:
   *    • `r.datum` ist ein reiner Tag („2026-10-13"), der Server
   *      schneidet ihn selbst zurecht (`toISOString().slice(0, 10)`).
   *    • `eintrag.geaendert` ist ein ganzer Zeitstempel
   *      („2026-10-06T18:22:31.123Z"), so wie `new Date().toISOString()`
   *      ihn schreibt — siehe anleitung-tabellen.js und
   *      workspace-anleitung.js.
   *  Mit dem $ hätte die zweite Form die Prüfung nicht bestanden und
   *  wäre UNVERÄNDERT durchgereicht worden: Auf der Karte stünde dann
   *  wörtlich „aktualisiert am 2026-10-06T18:22:31.123Z". Kein Fehler,
   *  kein Absturz — nur eine Zeile, die niemand lesen will. Genau die
   *  Sorte Schaden, die ein `node --check` nicht sieht.
   *  Die Uhrzeit wird bewusst weggelassen: Gefragt ist „habe ich die
   *  schon angefasst?", nicht die Minute. */
  const datumKurz = (iso) => {
    const m = /^(\d{4})-(\d{2})-(\d{2})/.exec(String(iso || ''));
    return m ? `${m[3]}.${m[2]}.${m[1]}` : String(iso || '');
  };

  async function hole(pfad, einst = {}) {
    const a = await fetch(pfad, { credentials: 'same-origin', ...einst });
    /* Abgemeldet heißt zurück zur Anmeldung — nicht eine leere Seite
       mit einer Fehlermeldung, die niemand einordnen kann. */
    if (a.status === 401) { location.assign('/workspace/'); throw new Error('abgemeldet'); }
    return a;
  }

  /* =====================================================================
     DER FORTSCHRITT

     Er kommt vom Server und wird hier NICHT nachgerechnet. Eine Seite,
     die selbst mitzählt, zählt irgendwann anders als der Server — und
     dann stehen zwei Zahlen auf einem Bildschirm, von denen eine falsch
     ist, ohne dass man ihr das ansieht.
     ===================================================================== */
  function standSetzen(f) {
    const kasten = $('stand');
    if (!f || !f.gesamt) { kasten.hidden = true; return; }
    kasten.hidden = false;
    const balken = $('stand-balken');
    balken.max = f.gesamt;
    balken.value = f.erledigt;
    const fertig = f.erledigt >= f.gesamt;
    kasten.dataset.fertig = fertig ? 'ja' : 'nein';
    $('stand-satz').textContent = fertig
      ? 'Alle Ersten Schritte erledigt. Den Rest holst du dir, wenn du ihn brauchst.'
      : `${f.erledigt} von ${f.gesamt} Schritten erledigt`;
  }

  /* =====================================================================
     EIN HAKEN

     Ein echtes `input type="checkbox"`: Tastatur, Vorleseprogramme und
     der Zustand „gedrückt" kommen damit mit. Ein nachgebauter Knopf
     vergisst davon immer mindestens eines.

     ES WIRD SOFORT GESCHICKT UND NICHT GESAMMELT. Ein „Speichern"-Knopf
     unter fünf Haken wäre die Stelle, an der jemand die Seite verlässt
     und sein Fortschritt weg ist.

     GEHT ES SCHIEF, GEHT DER HAKEN ZURÜCK. Ein Haken, der steht,
     obwohl der Server ihn nicht hat, ist schlimmer als keiner: Beim
     nächsten Laden ist er weg, und niemand weiß warum.
     ===================================================================== */
  function hakenBauen(s, li) {
    const schild = el('label', 'an-haken');
    const feld = document.createElement('input');
    feld.type = 'checkbox';
    feld.className = 'an-haken__feld';
    feld.checked = !!s.erledigt;
    /* Der Name des Schrittes steht im Verweis daneben; das Kästchen
       selbst braucht trotzdem eine eigene Ansage. */
    feld.setAttribute('aria-label', `„${s.titel}“ erledigt`);
    schild.append(feld);
    schild.append(el('span', 'an-haken__zeichen'));

    feld.addEventListener('change', async () => {
      const willErledigt = feld.checked;
      feld.disabled = true;
      try {
        const a = await hole(`${BASIS}/schritt/${s.id}`, {
          method: 'PUT',
          headers: { 'Content-Type': 'application/json' },
          body: JSON.stringify({ erledigt: willErledigt }),
        });
        if (!a.ok) throw new Error('abgelehnt');
        const r = await a.json();
        s.erledigt = r.erledigt;
        if (r.erledigt) li.dataset.erledigt = 'ja';
        else li.removeAttribute('data-erledigt');
        standSetzen(r.fortschritt);
      } catch {
        feld.checked = !willErledigt;
        melde('Der Haken ließ sich nicht speichern. Noch einmal versuchen?');
      } finally {
        feld.disabled = false;
      }
    });
    return schild;
  }

  /* =====================================================================
     DIE KACHELN DIESER ROLLE — abgeleitet, nicht abgeschrieben
     ===================================================================== */
  function kachelnFuer(rolle) {
    const B = window.Bereiche;
    const nach = new Map();
    if (!B) return nach;

    /* ==== ZWEI HAEUSER, ZWEI QUELLEN (06.10.2026) ==================

       Bis hierher kamen die Kacheln immer aus `Bereiche.GRUPPEN` --
       der Liste im Browser. Das stimmt fuer die Agentur: Dort schickt
       der Server bewusst `bereiche: null` ("nimm deine eigene
       Liste").

       Fuer Team Dogi schickt er eine ECHTE Liste, und die Browserliste
       kennt deren Kacheln gar nicht. Gemessen: Die Crew-Anleitung
       zeigte 0 Karten, obwohl die Schnittstelle 14 bzw. 34 lieferte --
       jede Karte wurde weggelassen, weil zu ihrem Schluessel keine
       Kachel zu finden war. Von aussen sah die Seite einfach leer aus.

       Dieselbe Unterscheidung, die auch die Startseite trifft: Ist es
       ein Feld, gilt es; ist es `null`, nimmt der Browser seine
       eigene. Eine zweite Kachelliste im Browser waere die, die beim
       naechsten Umbau des Rudels veraltet. */
    if (Array.isArray(serverKacheln)) {
      for (const k of serverKacheln) {
        const schluessel = B.schluesselVonZiel(k?.ziel);
        if (schluessel) nach.set(schluessel, k);
      }
      return nach;
    }

    if (!Array.isArray(B.GRUPPEN)) return nach;
    for (const gruppe of B.GRUPPEN) {
      for (const k of (gruppe.bereiche || [])) {
        if (Array.isArray(k.rollen) && !k.rollen.includes(rolle)) continue;
        const schluessel = B.schluesselVonZiel(k.ziel);
        if (schluessel) nach.set(schluessel, k);
      }
    }
    return nach;
  }

  /* =====================================================================
     EINE KARTE
     ===================================================================== */
  function karteBauen(eintrag, kachel, stufe) {
    const karte = el('article', 'an-karte');
    /* DER SCHLUESSEL BLEIBT AM ELEMENT STEHEN. Er kostet nichts und
       ist der einzige Weg, eine bestimmte Karte spaeter wiederzufinden
       -- „Neu fuer dich" auf der Zentrale springt darueber hierher.
       Eine ID waere dafuer schlechter: Schluessel wie `chat:treff`
       muessten dann in etwas umgerechnet werden, das als ID taugt,
       und diese Umrechnung stuende an zwei Stellen. */
    karte.dataset.kachel = String(eintrag.kachel || '');
    if (kachel.ton !== undefined && kachel.ton !== null) {
      karte.dataset.ton = String(kachel.ton);
    }

    const kopf = el('div', 'an-karte__kopf');
    const zeichen = el('span', 'an-karte__zeichen');
    zeichen.append(window.Bereiche.zeichenBauen(kachel.zeichen, 'an-karte__svg'));
    kopf.append(zeichen);

    const namen = el('div', 'an-karte__namen');
    namen.append(el('h3', 'an-karte__name', kachel.name));
    /* DIE STUFE STEHT ALS WORT DA, nicht nur als Farbe. Wer Farben
       schlecht unterscheidet, läse sonst eine Karte ohne Stufe — und
       die Stufe ist das Einzige, was diese Seite überhaupt sortiert. */
    namen.append(el('span', 'an-karte__stufe', stufe.name));
    /* DIE MARKE "NEU" steht als WORT da, nicht als farbiger Punkt.
       Ein Punkt ohne Wort ist eine Frage, keine Auskunft. Sie
       verschwindet von selbst: 14 Tage oder bis die Person die Seite
       nach der Änderung geöffnet hat -- gerechnet wird das im Server. */
    if (eintrag.neu) namen.append(el('span', 'an-karte__neu', 'Neu'));
    /* „AB DABEI" / „AB STAMM" (Bauplan Kapitel 04). Steht nur da,
       wenn es diese Person BETRIFFT -- der Server schickt das Feld
       gar nicht erst, wenn die Stufe reicht oder gar keine im Spiel
       ist. Eine Marke, die bei jedem steht, erklärt nichts.

       ALS WORT UND NICHT ALS SCHLOSS-SYMBOL: Ein Schloss sagt „du
       darfst nicht" und lässt offen, ob jemals. „ab Dabei" sagt, dass
       es kommt — und wann, steht in der Karte „Deine Stufe" weiter
       oben, mit Datum. */
    if (eintrag.erst_ab) {
      namen.append(el('span', 'an-karte__abstufe', `ab ${eintrag.erst_ab}`));
    }
    kopf.append(namen);
    if (pflegeAn) kopf.append(aendernKnopf(() => karteOeffnen(eintrag, kachel)));
    karte.append(kopf);

    const zeilen = el('dl', 'an-karte__zeilen');
    const zeile = (schild, text) => {
      if (!text) return;
      zeilen.append(el('dt', 'an-karte__schild', schild));
      zeilen.append(el('dd', 'an-karte__text', text));
    };
    zeile('Wozu', eintrag.wozu);
    zeile('Was du hier tust', eintrag.tust);
    zeile('Merke', eintrag.merke);
    karte.append(zeilen);

    /* „HINGEHEN" UND NICHT „ZUR KACHEL" (06.10.2026). So steht es im
       Bauplan, Kapitel 04 — und es ist die Sprache der Seite: Sie
       duzt, begrüßt mit Namen und sagt „Schön, dass du da bist".
       „Zur Kachel" ist das Wort, mit dem wir INTERN über die Dinge
       reden; wer neu ist, hat das Wort Kachel noch nie gehört. */
    const weg = el('a', 'an-karte__weg', 'Hingehen');
    /* MIT dem Zusatz hinter dem Fragezeichen. `bereich.html?b=live` und
       `bereich.html?b=technik` sind dieselbe Seite und verschiedene
       Kacheln; ohne den Zusatz landeten fünf Karten am selben Ort. */
    weg.href = kachel.ziel;
    karte.append(weg);

    /* „AKTUALISIERT AM" — NUR IN DER PFLEGE (Bauplan Kapitel 04).

       Der Plan nennt es bei der Karte. Für ein Mitglied beantwortet
       es aber keine Frage: Ob ein Text vor drei Wochen oder gestern
       geschrieben wurde, ändert nichts daran, was zu tun ist — und
       DASS sich etwas geändert hat, sagt ihm die Marke „Neu"
       daneben, die von selbst wieder verschwindet.

       Für DogFather beantwortet es eine sehr konkrete: „Habe ich die
       schon angefasst?" Deshalb steht es dort, wo die Frage gestellt
       wird, und nirgendwo sonst. Eine Zeile, die auf jeder der 34
       Karten steht und niemanden angeht, ist genau die Sorte
       Kleingedrucktes, die den Blick von den drei Zeilen darüber
       wegzieht. */
    if (pflegeAn && eintrag.geaendert) {
      karte.append(el('p', 'an-karte__stand',
        `aktualisiert am ${datumKurz(eintrag.geaendert)}`));
    }
    return karte;
  }

  /* =====================================================================
     EIN STUFENBLOCK — aufklappbar, Muss offen
     ===================================================================== */
  function stufeBauen(stufe, eintraege, kacheln) {
    const block = el('section', 'an-stufe');
    block.dataset.stufe = stufe.schluessel;

    /* <details> und kein nachgebautes Aufklappen: Es bringt Tastatur,
       Vorlesen und die Suche des Browsers mit. Jeder Nachbau vergisst
       davon mindestens eines. */
    const falte = el('details', 'an-stufe__falte');
    falte.open = !!stufe.offen;
    const griff = el('summary', 'an-stufe__griff');
    griff.append(el('span', 'an-stufe__titel', stufe.titel));
    griff.append(el('span', 'an-stufe__zahl', String(eintraege.length)));
    falte.append(griff);

    if (stufe.unter) falte.append(el('p', 'an-stufe__unter', stufe.unter));

    const gitter = el('div', 'an-stufe__gitter');
    let gebaut = 0;
    for (const e of eintraege) {
      const kachel = kacheln.get(e.kachel);
      /* EINE KARTE OHNE KACHEL WIRD NICHT GEZEIGT.
         Sie hätte keinen Namen, kein Symbol und keinen Weg — ein
         Kasten, der nichts tut. Dass das überhaupt nicht vorkommen
         darf, prüft pruef-anleitung.mjs in beide Richtungen; hier
         still zu übergehen ist die richtige Vorsicht, nicht die
         Prüfung. */
      if (!kachel) continue;
      gitter.append(karteBauen(e, kachel, stufe));
      gebaut++;
    }
    /* Die Zahl am Griff muss das zeigen, was wirklich dasteht. */
    griff.lastChild.textContent = String(gebaut);
    if (!gebaut) return null;

    falte.append(gitter);
    block.append(falte);
    return block;
  }

  /* =====================================================================
     DER SPRUNG AUF EINE BESTIMMTE KARTE (06.10.2026)

     `anleitung.html?karte=<schluessel>` -- benutzt von „Neu fuer dich"
     auf der Zentrale (Bauplan Kapitel 10: „mit Sprung zur passenden
     Karte").

     ZUERST AUFKLAPPEN, DANN HINSCROLLEN. „Das kommt regelmaessig" und
     „Nur bei Bedarf" sind zugeklappt; eine Karte, die darin liegt, hat
     ohne diesen Schritt die Hoehe null, und man landet an einer ganz
     anderen Stelle der Seite. Gemessen wird das nicht -- es ist der
     Grund, warum die Reihenfolge hier so herum steht.

     EIN ABSATZ ALS ANKER UND KEIN BLINKEN: Die Karte bekommt kurz
     eine ruhige Umrandung, damit man sieht, welche gemeint war. Nach
     ein paar Sekunden ist sie wieder wie die anderen.

     GEHT DER SCHLUESSEL INS LEERE (die Karte gibt es fuer diese Rolle
     nicht), passiert NICHTS. Die Seite ist dann einfach die Seite --
     besser als eine Fehlermeldung ueber etwas, das den Leser nichts
     angeht.
     ===================================================================== */
  function springeZurKarte() {
    let gesucht = '';
    try { gesucht = new URLSearchParams(location.search).get('karte') || ''; }
    catch { return; }
    if (!gesucht) return;
    const karte = document.querySelector(
      `.an-karte[data-kachel="${CSS.escape(gesucht)}"]`);
    if (!karte) return;
    const falte = karte.closest('details');
    if (falte) falte.open = true;
    karte.dataset.gesucht = 'ja';
    setTimeout(() => { delete karte.dataset.gesucht; }, 6000);
    try {
      karte.scrollIntoView({
        behavior: matchMedia('(prefers-reduced-motion: reduce)').matches
          ? 'auto' : 'smooth',
        block: 'center',
      });
    } catch { /* aeltere Browser: dann eben ohne */ }
  }

  /* =====================================================================
     DER FILTER
     ===================================================================== */
  function filterBauen(stufen, auswahl) {
    const leiste = $('filter');
    leiste.replaceChildren();
    const machen = (wert, text) => {
      const knopf = el('button', 'an-filter__knopf', text);
      knopf.type = 'button';
      knopf.dataset.wert = wert;
      knopf.setAttribute('aria-pressed', String(auswahl === wert));
      knopf.addEventListener('click', () => setzen(wert));
      leiste.append(knopf);
    };
    machen('alle', 'Alles');
    for (const s of stufen) machen(s.schluessel, s.name);

    function setzen(wert) {
      for (const k of leiste.querySelectorAll('.an-filter__knopf')) {
        k.setAttribute('aria-pressed', String(k.dataset.wert === wert));
      }
      for (const b of $('stufen').querySelectorAll('.an-stufe')) {
        const dran = wert === 'alle' || b.dataset.stufe === wert;
        b.hidden = !dran;
        /* EINE GEFILTERTE STUFE WIRD AUFGEKLAPPT. Wer auf „Muss"
           drückt und dann einen zugeklappten Kasten sieht, hat einen
           Knopf gedrückt, der scheinbar nichts getan hat. */
        if (dran && wert !== 'alle') {
          const f = b.querySelector('.an-stufe__falte');
          if (f) f.open = true;
        }
      }
    }
  }

  /* =====================================================================
     AUFBAUEN
     ===================================================================== */
  function zeigen(d) {
    daten = d;
    $('ohne-fassung').hidden = true;
    $('fassung').hidden = false;
    $('pflege').hidden = !d.darf_pflegen;
    /* Mit Fassung gibt es etwas zu bearbeiten -- der Knopf kommt
       zurueck, falls ihn der Weg ohne Fassung ausgeblendet hat. */
    $('pflege-an').hidden = false;
    document.body.dataset.pflege = pflegeAn ? 'ja' : 'nein';

    $('leitgedanke').textContent = d.leitgedanke || '';
    $('leitgedanke').hidden = !d.leitgedanke;

    $('saetze').replaceChildren(
      ...(d.saetze || []).map((t) => el('li', 'an-saetze__zeile', t)));

    /* ==================================================================
       DIE GANZE ZEILE IST DER KNOPF, NICHT NUR DAS WORT (06.10.2026)

       Zuerst war nur der Name verlinkt. Gemessen mit
       mess-anleitung.mjs bei 412 px: 20 Pixel hoch — die halbe
       Hausgröße für etwas, das ein Daumen treffen soll, und das
       ausgerechnet auf der Seite, die für Leute gebaut ist, die zum
       ersten Mal hier sind und auf dem Handy sitzen.

       Jetzt umschließt der Verweis Name UND Text. Das ist auch die
       ehrlichere Form: Der ganze Schritt ist eine Sache, nicht ein
       Stichwort mit Erklärung daneben.

       Ohne Ziel bleibt es ein `div` — „Installieren“ ist ein Knopf in
       der Kopfleiste, keine Seite. Ein Verweis ohne Ziel wäre genau
       der tote Knopf, den der Rollen-Rundgang sucht.

       DER HAKEN STEHT DANEBEN UND NICHT DRUMHERUM (Etappe 2). Ein
       Verweis in einem Kontrollkästchen-Label wäre eine Falle: Wer
       auf den Namen tippt, um zur Kachel zu springen, hätte den
       Schritt abgehakt. Zwei Dinge, zwei Flächen.
       ================================================================== */
    $('schritte').replaceChildren(
      ...(d.schritte || []).map((s) => {
        const li = el('li', 'an-schritt');
        if (s.erledigt) li.dataset.erledigt = 'ja';

        if (d.darf_abhaken) li.append(hakenBauen(s, li));

        const rumpf = s.ziel ? el('a', 'an-schritt__rumpf') : el('div', 'an-schritt__rumpf');
        if (s.ziel) rumpf.href = s.ziel;
        rumpf.append(el('span', 'an-schritt__name', s.titel));
        rumpf.append(el('span', 'an-schritt__text', s.text));
        li.append(rumpf);
        if (pflegeAn) li.append(aendernKnopf(() => zeileOeffnen(s, 'schritt')));
        return li;
      }));
    standSetzen(d.fortschritt);

    const kacheln = kachelnFuer(d.rolle);
    const stufen = $('stufen');
    stufen.replaceChildren();
    for (const s of (d.stufen || [])) {
      const eintraege = (d.karten || []).filter((k) => k.stufe === s.schluessel);
      const block = stufeBauen(s, eintraege, kacheln);
      if (block) stufen.append(block);
    }
    filterBauen(d.stufen || [], 'alle');

    const liste = (id, blockId, zeilen, bau) => {
      const ziel = $(id);
      ziel.replaceChildren(...zeilen.map(bau));
      $(blockId).hidden = !zeilen.length;
    };
    /* ---- Drei Dinge vorweg (nur die Community) --------------------
       Leere Liste heisst: Diese Rolle bringt keine mit, und der ganze
       Abschnitt bleibt weg. `liste()` macht das von selbst. */
    liste('vorweg', 'vorweg-block', d.vorweg || [], (z) => {
      const li = el('li', 'an-vorweg__zeile');
      li.append(el('strong', 'an-vorweg__was', z.titel));
      li.append(el('span', 'an-vorweg__text', z.text));
      if (pflegeAn) li.append(aendernKnopf(() => zeileOeffnen(z, 'vorweg')));
      return li;
    });

    /* ---- Deine Stufe (nur die Community) --------------------------
       KEINE EIGENE RECHNUNG IM BROWSER. Welche Stufe jemand hat und ab
       wann mehr geht, kommt fertig vom Server -- dort steht auch die
       Regel, die es entscheidet. Eine zweite Rechnung hier waere die,
       die irgendwann etwas anderes behauptet als das, was die Person
       dann tatsaechlich darf. */
    const st = d.stufe;
    $('stufe-block').hidden = !st;
    if (st) {
      $('stufe-jetzt').textContent = `Du bist gerade: ${st.name}`;
      $('stufe-liste').replaceChildren(...(st.reihen || []).map((r) => {
        const li = el('li', 'an-rang__zeile');
        if (r.schluessel === st.jetzt) li.dataset.jetzt = 'ja';
        li.append(el('span', 'an-rang__name', r.name));
        li.append(el('span', 'an-rang__ab', r.ab));
        li.append(el('span', 'an-rang__kann', r.kann));
        /* Das Datum steht nur dort, wo es etwas beantwortet: bei einer
           Stufe, die noch kommt. Bei der eigenen und bei schon
           erreichten waere es Vergangenheit. */
        const weiter = (st.jetzt === 'neu' && r.schluessel !== 'neu')
          || (st.jetzt === 'dabei' && r.schluessel === 'stamm');
        if (weiter && r.datum) {
          li.append(el('span', 'an-rang__wann', `frühestens ab ${datumKurz(r.datum)}`));
        }
        return li;
      }));
    }

    liste('nicht', 'nicht-block', d.nicht || [], (z) => {
      const li = el('li', 'an-nicht__zeile');
      li.append(el('span', 'an-nicht__was', z.titel));
      li.append(el('span', 'an-nicht__wer', z.text));
      if (pflegeAn) li.append(aendernKnopf(() => zeileOeffnen(z, 'nicht')));
      return li;
    });
    liste('takt', 'takt-block', d.takt || [], (z) => {
      const teil = document.createDocumentFragment();
      teil.append(el('dt', 'an-takt__wann', z.titel));
      teil.append(el('dd', 'an-takt__was', z.text));
      return teil;
    });
    liste('fragen', 'fragen-block', d.fragen || [], (z) => {
      const falte = el('details', 'an-frage');
      falte.append(el('summary', 'an-frage__frage', z.titel));
      falte.append(el('p', 'an-frage__antwort', z.text));
      if (pflegeAn) falte.append(aendernKnopf(() => zeileOeffnen(z, 'frage'), 'an-frage__aendern'));
      return falte;
    });
    fehlendeZeigen(d);

    /* GANZ ZUM SCHLUSS, UND NICHT GLEICH NACH DEN KARTEN.
       Gemessen (mess-anleitung-crew, 06.10.2026): Der Sprung stand
       zuerst direkt hinter den Karten -- die Karte war markiert, ihr
       Abschnitt war aufgeklappt, und sie stand trotzdem NICHT im Bild.
       Grund: Darunter werden danach noch „Nicht deins", „Dein
       Rhythmus" und die Fragen eingehaengt. Das sanfte Scrollen zielte
       auf eine Hoehe, die sich waehrenddessen verschob. */
    springeZurKarte();
  }

  function ohneFassung(d) {
    $('fassung').hidden = true;
    /* DIE PFLEGE BLEIBT STEHEN, AUCH OHNE FASSUNG (06.10.2026).

       Gemessen auf der Crew-Adresse: DogFather oeffnete die Kachel und
       sah EINEN SATZ. Kein Knopf, keine Liste -- obwohl der Bauplan in
       Kapitel 11 sagt „Bei ihm oeffnet die Kachel die Pflege-Ansicht".
       Die Leiste hing an `zeigen()`, und das laeuft nur, wenn es eine
       Fassung gibt. Genau der eine Mensch, fuer den die Pflege gebaut
       ist, kam also ohne Umweg gar nicht an sie heran.

       „Texte bearbeiten" bleibt dabei weg: Ohne gewaehlte Rolle steht
       keine Karte da, die man bearbeiten koennte -- ein Knopf, der
       sichtbar nichts tut, ist schlimmer als keiner. „Wer ist wie
       weit?" dagegen braucht keine Rolle und ist genau das, wofuer man
       hier ohne Sicht hereinkommt. */
    $('pflege').hidden = !d.darf_pflegen;
    $('pflege-an').hidden = true;
    $('pflege-satz').textContent = d.darf_pflegen
      ? 'Zum Bearbeiten oben unter „Meine Sicht“ eine Rolle wählen.' : '';
    /* Kein Fortschritt ohne Schritte. Er steht in der HTML schon auf
       `hidden`; hier noch einmal, weil diese Seite spaeter (Etappe 4)
       die Rolle wechseln koennen soll, ohne neu zu laden. */
    $('stand').hidden = true;
    const p = $('ohne-fassung');
    p.textContent = d.satz || 'Für diese Rolle gibt es keine Einweisung.';
    p.hidden = false;
  }

  /* =====================================================================
     DIE PFLEGE (Etappe 4) — nur für DogFather und Spicy Media
     =====================================================================

     Bearbeitet wird AN ORT UND STELLE. Eine getrennte
     Verwaltungsansicht hieße, zwischen zwei Fenstern zu vergleichen –
     und genau dabei entstehen Texte, die nicht zueinander passen.

     Die Rolle wird nicht hier gewählt: Dafür gibt es den
     Sicht-Umschalter in der Kopfleiste.
     ===================================================================== */

  function aendernKnopf(beiKlick, klasse) {
    const k = el('button', 'an-aendern' + (klasse ? ' ' + klasse : ''), '✎');
    k.type = 'button';
    k.title = 'Bearbeiten';
    k.setAttribute('aria-label', 'Bearbeiten');
    k.addEventListener('click', (e) => { e.preventDefault(); e.stopPropagation(); beiKlick(); });
    return k;
  }

  /* Welche Kacheln dieser Rolle haben noch keine Karte?
     Derselbe Abgleich, den pruef-anleitung in beide Richtungen prüft –
     hier als Angebot, ihn zu schließen. */
  function fehlendeZeigen(d) {
    const kasten = $('fehlend-block');
    if (!d.darf_pflegen || !pflegeAn) { kasten.hidden = true; return; }
    const alle = kachelnFuer(d.rolle);
    alle.delete('anleitung');
    const haben = new Set((d.karten || []).map((k) => k.kachel));
    const fehlt = [...alle.entries()].filter(([s]) => !haben.has(s));
    kasten.hidden = !fehlt.length;
    $('fehlend').replaceChildren(...fehlt.map(([schluessel, kachel]) => {
      const li = el('li', 'an-fehlend__zeile');
      li.append(el('span', 'an-fehlend__name', kachel.name));
      const k = el('button', 'an-fehlend__knopf', 'Eintrag anlegen');
      k.type = 'button';
      k.addEventListener('click', async () => {
        k.disabled = true;
        try {
          const a = await hole(`${BASIS}/karte`, {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({ rolle: d.rolle, kachel: schluessel, stufe: 'bedarf',
              wozu: '', tust: '', merke: '' }),
          });
          if (!a.ok) throw new Error('abgelehnt');
          await laden();
        } catch { melde('Der Eintrag ließ sich nicht anlegen.'); k.disabled = false; }
      });
      li.append(k);
      return li;
    }));
  }

  /* ---- Das Fenster -------------------------------------------------- */
  let imFenster = null;      // { art: 'karte'|'zeile', id, unterart }

  function feld(id, schildId, schild, wert, sichtbar) {
    $(id).hidden = !sichtbar;
    if (schildId) $(schildId).textContent = schild;
    const eingabe = $(id).querySelector('input, textarea, select');
    if (eingabe) eingabe.value = wert ?? '';
  }

  function karteOeffnen(eintrag, kachel) {
    imFenster = { art: 'karte', id: eintrag.id };
    $('aendern-titel').textContent = kachel.name;
    $('aendern-unter').textContent = 'Stufe und die drei Zeilen dieser Karte.';
    const wahl = $('e-stufe');
    wahl.replaceChildren(...(daten.stufen || []).map((st) => {
      const o = document.createElement('option');
      o.value = st.schluessel;
      o.textContent = st.name;
      return o;
    }));
    wahl.value = eintrag.stufe;
    $('feld-stufe').hidden = false;
    feld('feld-a', 'schild-a', 'Wozu', eintrag.wozu, true);
    feld('feld-b', 'schild-b', 'Was du hier tust', eintrag.tust, true);
    feld('feld-c', 'schild-c', 'Merke', eintrag.merke, true);
    $('feld-ziel').hidden = true;
    $('aendern-fehler').textContent = '';
    $('aendern').showModal();
  }

  const ZEILEN_SCHILD = {
    schritt: ['Kachel', 'Was zu tun ist'],
    nicht: ['Was du liegen lassen kannst', 'Wer es erledigt'],
    takt: ['Wann', 'Was du aufmachst'],
    frage: ['Frage', 'Antwort'],
  };

  function zeileOeffnen(z, art) {
    imFenster = { art: 'zeile', id: z.id, unterart: art };
    const [a, b] = ZEILEN_SCHILD[art] || ['Titel', 'Text'];
    $('aendern-titel').textContent = z.titel || 'Eintrag';
    $('aendern-unter').textContent = '';
    $('feld-stufe').hidden = true;
    feld('feld-a', 'schild-a', a, z.titel, true);
    feld('feld-b', 'schild-b', b, z.text, true);
    $('feld-c').hidden = true;
    /* Ein Ziel gibt es nur beim Schritt -- bei den anderen wäre das
       Feld eine Zusage, die nirgends eingelöst wird. */
    feld('feld-ziel', null, null, z.ziel, art === 'schritt');
    $('aendern-fehler').textContent = '';
    $('aendern').showModal();
  }

  async function aendernSpeichern(e) {
    e.preventDefault();
    if (!imFenster) return;
    const knopf = $('aendern-speichern');
    knopf.disabled = true;
    try {
      const wohin = imFenster.art === 'karte'
        ? `${BASIS}/karte/${imFenster.id}` : `${BASIS}/zeile/${imFenster.id}`;
      const rumpf = imFenster.art === 'karte'
        ? { stufe: $('e-stufe').value, wozu: $('e-a').value,
            tust: $('e-b').value, merke: $('e-c').value }
        : { titel: $('e-a').value, text: $('e-b').value,
            ziel: imFenster.unterart === 'schritt' ? $('e-ziel').value : null };
      const a = await hole(wohin, {
        method: 'PUT',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify(rumpf),
      });
      if (!a.ok) throw new Error('abgelehnt');
      $('aendern').close();
      await laden();
    } catch {
      $('aendern-fehler').textContent = 'Das ließ sich nicht speichern.';
    } finally {
      knopf.disabled = false;
    }
  }

  /* ---- Wer ist wie weit --------------------------------------------- */
  async function standZeigen() {
    const ziel = $('stand-liste');
    ziel.replaceChildren(el('p', 'leise', 'wird geladen …'));
    $('stand-dialog').showModal();
    try {
      const a = await hole(`${BASIS}/stand`);
      if (!a.ok) throw new Error('abgelehnt');
      const r = await a.json();
      if (!r.leute.length) {
        ziel.replaceChildren(el('p', 'leise', 'Noch niemand im Team.'));
        return;
      }
      ziel.replaceChildren(...r.leute.map((p) => {
        const zeile = el('div', 'an-wer');
        if (p.fertig) zeile.dataset.fertig = 'ja';
        zeile.append(el('span', 'an-wer__name', p.name));
        zeile.append(el('span', 'an-wer__rolle', p.rolle));
        zeile.append(el('span', 'an-wer__stand',
          p.gesamt === 0 ? 'keine Schritte hinterlegt'
            : p.fertig ? 'fertig' : `${p.erledigt} von ${p.gesamt}`));
        /* Das Datum nur, wenn es eines gibt -- „zuletzt: nie" ist eine
           Zeile, die nichts sagt und trotzdem Platz braucht. */
        if (p.zuletzt) {
          zeile.append(el('span', 'an-wer__wann',
            new Date(p.zuletzt).toLocaleDateString('de-DE',
              { day: '2-digit', month: '2-digit', year: 'numeric' })));
        }
        return zeile;
      }));
    } catch {
      ziel.replaceChildren(el('p', 'leise', 'Der Stand ließ sich nicht laden.'));
    }
  }

  function melde(grund) {
    $('ladefehler-grund').textContent = grund || '';
    $('ladefehler').hidden = false;
  }

  /* Die Kacheln dieser Person, wenn der Server sie schickt (Crew).
     `null` heisst: Es gilt die Liste im Browser (Agentur). */
  let serverKacheln = null;

  async function laden() {
    $('ladefehler').hidden = true;
    /* ERST DIE KACHELN, DANN DIE TEXTE. Andersherum waere die erste
       Zeichnung ohne Kacheln -- und damit ohne eine einzige Karte. */
    try {
      const ich = await hole('/workspace/api/ich');
      if (ich.ok) {
        const j = await ich.json();
        const liste = [...(j.bereiche || []), ...(j.bereiche_zusatz || [])];
        serverKacheln = Array.isArray(j.bereiche) ? liste : null;
      }
    } catch { /* Dann gilt die Browserliste -- wie bisher. */ }

    let a;
    try { a = await hole(BASIS); } catch { melde('Keine Verbindung.'); return; }
    if (a.status === 404) {
      melde('Diese Seite gibt es auf dieser Adresse nicht.');
      return;
    }
    if (!a.ok) { melde('Der Server hat nicht geantwortet.'); return; }
    const d = await a.json();
    if (!d.hat_fassung) { ohneFassung(d); return; }
    zeigen(d);
  }

  $('pflege-an').addEventListener('click', () => {
    pflegeAn = !pflegeAn;
    $('pflege-an').setAttribute('aria-pressed', String(pflegeAn));
    $('pflege-satz').textContent = pflegeAn
      ? 'Änderungen gelten sofort für alle dieser Rolle.' : '';
    if (daten) zeigen(daten);
  });
  $('pflege-stand').addEventListener('click', () => { standZeigen().catch(() => {}); });
  $('stand-zu').addEventListener('click', () => $('stand-dialog').close());
  $('aendern-form').addEventListener('submit', (e) => { aendernSpeichern(e).catch(() => {}); });
  $('aendern-abbruch').addEventListener('click', () => $('aendern').close());
  $('nochmal').addEventListener('click', () => { laden().catch(() => {}); });
  laden().catch(() => melde('Unerwarteter Fehler.'));
})();