Bauplan Etappen 4 und 6: Kachelplatz, Aufstiegskarte, und das Alte raeumt ab

Drei Dinge, die zusammengehoeren, weil sie alle denselben Satz aus
Kapitel 01 des Bauplans beantworten: Wer neu ist, soll nicht alles
gleich wichtig vorgesetzt bekommen.

1) DIE KACHEL STEHT BEIM TEAM OBEN (Kapitel 03)
Gemessen stand "Willkommen & Anleitung" bei einem Modi in der Gruppe
"Community" -- der FUENFTEN von sechs, hinter allen Brettern, die er
moderiert. Der Plan sagt dazu "zusaetzlich als erste Kachel in 'Fuer
dich', weil sie bei ihnen sonst weit unten steht".

Ich habe sie VERSCHOBEN statt verdoppelt, und das ist eine bewusste
Abweichung vom Wortlaut: Zwei Kacheln mit demselben Namen und
demselben Ziel hatte dieses Haus am 19.09. schon einmal (zweimal
"Chat"), und der Satz, der daraus wurde, steht seitdem im Quelltext --
"Zwei gleich benannte Wege zum selben Ort sind schlimmer als ein
fehlender". Das Ziel des Plans ist so erreicht, der Nebeneffekt bleibt
aus. Fuer die Community aendert sich nichts: Bei ihr ist "Community"
die erste Gruppe, dort steht sie schon vorne und breit.
Entschieden wird das an AUSSEN_ROLLEN, nicht an Rollennamen.

2) "NEU FUER DICH" BEIM AUFSTIEG (Kapitel 10, Etappe 6)
Erreicht ein Mitglied "Dabei" oder "Stamm", steht auf der Zentrale
einmal eine Karte mit dem, was jetzt geht, und einem Sprung auf die
passende Karte der Anleitung.

WAS JETZT GEHT, IST ABGELEITET -- aus TREFF_SCHREIBEN, derselben
Tafel, die es auch ENTSCHEIDET. Eine Liste im Code haette beim
naechsten neuen Brett entweder etwas versprochen, das die Person gar
nicht darf, oder verschwiegen, was sie duerfte.

Der Schluessel ist (Person, STUFE) und nicht (Person): Wer von Neu auf
Dabei steigt, bekommt die Karte, und Wochen spaeter beim Sprung auf
Stamm noch einmal, mit anderem Inhalt. Eine einzelne Spalte "schon
gesehen" haette den zweiten Aufstieg verschluckt -- und das waere
niemandem aufgefallen, es fehlt ja nur etwas.

Gemerkt wird beim ZEIGEN, nicht beim Wegklicken. Dieselbe Entscheidung
wie bei der Begruessung, aus demselben gemessenen Grund.

Dazu springt `anleitung.html?karte=<schluessel>` jetzt auf eine
bestimmte Karte. Erst beim Messen fiel auf, dass der Sprung ins Leere
ging, obwohl Karte und Abschnitt richtig waren: Unter den Karten
werden danach noch drei Abschnitte eingehaengt, und das sanfte
Scrollen zielte auf eine Hoehe, die sich dabei verschob. Der Sprung
steht jetzt ganz am Ende des Aufbaus.

3) DAS ABGELOESTE WILLKOMMEN IST WEG
willkommen.html ist seit heute frueh eine Weiterleitung. Der Unterbau
lief aber weiter: eine Schnittstelle, die jede Kachel einer Rolle
gleich ausfuehrlich erklaerte (genau das, was Kapitel 01 als Problem
beschreibt), dazu ein Skript und ein Stilblatt, die keine Seite mehr
lud. Entfernt: server/workspace-willkommen.js, assets/js/willkommen.js,
assets/css/willkommen.css und der Router in index.js.

Aufgefallen ist es, weil pruef-willkommen rot wurde und danach in ihre
Notbremse lief -- eine Pruefung, die eine zurueckgenommene Regel
verteidigt. Sie ist mitgegangen: Die inhaltlichen Fragen beantwortet
jetzt pruef-anleitung; hier bleibt die eine, die sonst niemand stellt
("verliert die alte Adresse jemanden?") plus der Nachweis, dass das
Alte wirklich fort ist. 15 Pruefungen statt der alten Fassung, und der
Rueckgang ist damit erklaert.

Nebenbefund: tools/kachel-regenbogen.mjs verwies auf pruef-willkommen
als Wache ueber den gerechneten CSS-Block. Die Datei hat ihn nie
angesehen -- die Wache ist pruef-kachelfarben. Zeiger berichtigt.

AUSSERDEM: .zeileneditor__weg war 34x34 und das einzige ungedeckte
Tippziel des Hauses (pruef-tippziele war deshalb rot). Er wirft eine
Zeile aus einem Eintrag. Auf Fingergeraeten jetzt 44x44, das Kreuz
mitgerechnet statt geraten. Der Knopf stammt aus einer anderen
Sitzung; ich habe ihn Filipe gemeldet und keine Antwort bekommen --
eine rote Pruefung, die liegen bleibt, wird nach dem zweiten Mal
weggeklickt, deshalb jetzt behoben statt weiter gemeldet.

GEPRUEFT
  pruef-anleitung     137 -> 166 (neu: Kachelplatz je Rolle mit
                      Gegenprobe aufs Agenturhaus, der ganze
                      Aufstiegsweg inkl. ZWEITEM Aufstieg, und die
                      Abnahme-Checkliste aus Kapitel 13 -- 14/29/29/34
                      Karten MIT ihrer Aufteilung 5/4/5, 7/7/15,
                      7/7/15, 8/7/19 und "Nicht deins")
  pruef-willkommen    neu gefasst, 15, gruen
  pruef-sackgassen    14, 145 Kacheln, 0 ins Leere
  pruef-start-ansicht gruen, keine Konsolenfehler
  pruef-rollen        454, gruen (das eine "nicht nachsehbar" ist das
                      Haus-Wechsel-Feld und war immer so)
  pruef-tippziele     13, jetzt 0 Fehlschlaege

Gegenproben gefahren: Umsortierung ausgebaut -> drei FEHL (und die
Meldung zeigte den alten Zustand, Gruppe 5 von 6). Datenbank vor der
Schemaaenderung gesichert (sicherungen/vor-aufstieg-20261006-172614.db,
integrity_check ok).

Im Browser nachgemessen (echte Anmeldung, 390 px, HTTPS-Vorbau):
Karte da, Satz richtig, drei Wege, 0 zu kleine Tippziele, Sprung
landet auf der richtigen Karte, Abschnitt aufgeklappt, im Bild -- und
beim zweiten Aufruf ist sie weg.

Co-Authored-By: Claude Opus 5 <[email protected]>

workspace/assets/js/anleitung.js

@@ -172,6 +172,13 @@
      ===================================================================== */
   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);
     }
@@ -258,6 +265,49 @@
     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
      ===================================================================== */
@@ -423,6 +473,15 @@
       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) {

workspace/assets/js/aufstieg.js

@@ -0,0 +1,121 @@
+/* =====================================================================
+   aufstieg.js — „Neu für dich" beim Aufstieg der Stufe (Etappe 6)
+
+   Bauplan Kapitel 10: „Erreicht ein Community-Mitglied die Stufe Dabei
+   oder Stamm, zeige auf der Startseite einmal die Karte ‚Neu für dich:
+   Du kannst jetzt …' mit Sprung zur passenden Karte."
+
+   ---------------------------------------------------------------------
+   EIGENE DATEI, UND ZWAR AUS DEMSELBEN GRUND WIE rundgang.js
+
+   Sie läuft auf `start.html` — der meistbenutzten Seite des Hauses.
+   Geht hier etwas schief, darf davon nichts anderes betroffen sein:
+   eigenes `defer`, alles in `try`, und der Fehlerfall ist „nichts
+   tun". Der Server antwortet immer mit 200 (notfalls `zeigen: false`),
+   damit in der Konsole nichts Rotes steht.
+
+   Sie ist bewusst NICHT in rundgang.js gewandert, obwohl beides
+   „etwas, das einen auf der Zentrale begrüßt" ist: Der Rundgang
+   erscheint beim ERSTEN Anmelden, diese Karte Wochen später. Zwei
+   Anlässe, zwei Lebensdauern — in einer Datei wäre spätestens beim
+   nächsten Umbau unklar, welche Bedingung zu welcher gehört.
+
+   ---------------------------------------------------------------------
+   WAS JETZT GEHT, STEHT NICHT HIER
+
+   Der Server leitet es aus derselben Tafel ab, die es auch
+   entscheidet, und schickt fertige Kacheln mit. Eine Liste in dieser
+   Datei wäre die, die beim nächsten neuen Brett jemandem etwas
+   verspricht, das er gar nicht darf.
+
+   ---------------------------------------------------------------------
+   GEMERKT WIRD BEIM ZEIGEN, NICHT BEIM WEGKLICKEN
+
+   Dieselbe Entscheidung wie bei der Begrüßung, und aus demselben
+   gemessenen Grund: Wer die Seite schließt, ohne etwas anzuklicken,
+   hat die Karte trotzdem gesehen. Sonst kommt sie wieder. Und beim
+   übernächsten Mal auch.
+   ===================================================================== */
+(() => {
+  'use strict';
+
+  const BASIS = '/workspace/api/anleitung';
+
+  const el = (tag, klasse, text) => {
+    const k = document.createElement(tag);
+    if (klasse) k.className = klasse;
+    if (text !== undefined) k.textContent = text;
+    return k;
+  };
+
+  async function gesehenMerken() {
+    try {
+      await fetch(`${BASIS}/aufstieg/gesehen`, {
+        method: 'POST', credentials: 'same-origin',
+      });
+    } catch { /* Beim nächsten Mal eben noch einmal — kein Schaden. */ }
+  }
+
+  function bauen(d, platz) {
+    const kasten = el('section', 'aufstieg');
+    kasten.setAttribute('aria-labelledby', 'aufstieg-titel');
+
+    const text = el('div', 'aufstieg__text');
+    const titel = el('h2', 'aufstieg__titel', 'Neu für dich');
+    titel.id = 'aufstieg-titel';
+    text.append(titel);
+    text.append(el('p', 'aufstieg__satz',
+      `Du bist jetzt ${d.name}. Du kannst jetzt mehr als vorher.`));
+
+    /* DIE SPRÜNGE GEHEN AUF DIE KARTE, NICHT AUF DIE KACHEL.
+       Der Bauplan sagt „Sprung zur passenden Karte" — und das ist
+       auch das Richtige: Wer gerade erfährt, dass er etwas darf,
+       braucht zuerst die Erklärung, nicht das leere Formular.
+       Der Schlüssel wird mit derselben Funktion gerechnet, mit der
+       die Anleitung ihre Karten verbindet; eine zweite Rechnung hier
+       wäre die, die beim nächsten Fragezeichen in einer Adresse
+       danebenliegt. */
+    const B = window.Bereiche;
+    const wege = el('div', 'aufstieg__wege');
+    for (const k of (Array.isArray(d.kacheln) ? d.kacheln : [])) {
+      const schluessel = B && typeof B.schluesselVonZiel === 'function'
+        ? B.schluesselVonZiel(k.ziel || '') : '';
+      if (!schluessel) continue;
+      const a = el('a', 'aufstieg__weg', k.name || 'Ansehen');
+      a.href = `anleitung.html?karte=${encodeURIComponent(schluessel)}`;
+      if (k.ton !== undefined && k.ton !== null) a.dataset.ton = String(k.ton);
+      wege.append(a);
+    }
+    /* KEIN LEERER KASTEN: Gibt es zu nichts einen Weg, bleibt die
+       Karte trotzdem stehen — nur ohne die Knopfreihe. Den Aufstieg
+       zu verschweigen, weil ein Verweis fehlt, wäre der schlechtere
+       Tausch. */
+    if (wege.childElementCount) text.append(wege);
+
+    const schliessen = el('button', 'aufstieg__zu', 'Alles klar');
+    schliessen.type = 'button';
+    schliessen.addEventListener('click', () => { kasten.remove(); });
+
+    kasten.append(text, schliessen);
+    platz.append(kasten);
+  }
+
+  async function pruefen() {
+    const platz = document.getElementById('aufstieg-platz');
+    if (!platz) return;
+    let a;
+    try { a = await fetch(`${BASIS}/aufstieg`, { credentials: 'same-origin' }); }
+    catch { return; }
+    if (!a.ok) return;
+    let d;
+    try { d = await a.json(); } catch { return; }
+    if (!d || d.zeigen !== true) return;
+    bauen(d, platz);
+    gesehenMerken();
+  }
+
+  try {
+    if (document.readyState === 'complete') pruefen();
+    else window.addEventListener('load', pruefen);
+  } catch { /* dann eben nicht */ }
+})();

workspace/assets/js/willkommen.js

@@ -1,137 +0,0 @@
-/* =====================================================================
-   willkommen.js — die persönliche Einführung
-   =====================================================================
-
-   Auftrag vom 21.09.2026, Abschnitte 7 und 8.
-
-   DIESE DATEI ENTHÄLT KEINEN EINZIGEN ROLLENNAMEN und keine Liste von
-   Kacheln. Beides kommt vom Server, der die Rechte ohnehin kennt.
-   Stünde es hier, stünde es in einer Datei, die jeder herunterlädt —
-   und wäre am Tag nach der nächsten Änderung falsch.
-
-   Die Seite ist damit für jede Rolle dieselbe Datei und trotzdem für
-   jeden ein anderer Text. Genau das verlangt Abschnitt 8.
-   ===================================================================== */
-(() => {
-  'use strict';
-  const $ = (id) => document.getElementById(id);
-  const el = (was, klasse, text) => {
-    const e = document.createElement(was);
-    if (klasse) e.className = klasse;
-    if (text !== undefined) e.textContent = text;
-    return e;
-  };
-
-  /* Ein Zeichen aus dem Vorrat der Startseite, damit dieselbe Kachel
-     hier dasselbe Bild trägt wie dort. Fehlt es, bleibt die Stelle
-     leer -- lieber kein Zeichen als ein falsches. */
-  function zeichen(name) {
-    if (!name || !window.Bereiche || !window.Bereiche.zeichenBauen) return null;
-    try { return window.Bereiche.zeichenBauen(name); } catch (e) { return null; }
-  }
-
-  function kachelBauen(k) {
-    const a = el('a', 'w-kachel');
-    a.href = k.ziel;
-    /* Der Farbton kommt vom Server und wird hier nur gesetzt --
-       `[data-ton="N"]` in start.css macht daraus `--ton`. Damit traegt
-       jede Kachel hier genau die Farbe, die sie auf der Startseite
-       auch hat, ohne dass diese Datei eine einzige Farbe kennt. */
-    if (k.ton !== null && k.ton !== undefined) a.dataset.ton = String(k.ton);
-    if (k.gross) a.dataset.gross = 'ja';
-    const z = zeichen(k.zeichen);
-    if (z) {
-      const huelle = el('span', 'w-kachel__zeichen');
-      huelle.setAttribute('aria-hidden', 'true');
-      huelle.append(z);
-      a.append(huelle);
-    }
-    const text = el('span', 'w-kachel__text');
-    text.append(el('span', 'w-kachel__name', k.name));
-    if (k.unter) text.append(el('span', 'w-kachel__unter', k.unter));
-    /* Der lange Satz nur, wo es einen gibt. Ein leerer Absatz unter
-       jeder Kachel wäre ein Raster aus Lücken. */
-    if (k.lang) text.append(el('span', 'w-kachel__lang', k.lang));
-    a.append(text);
-    return a;
-  }
-
-  async function bauen() {
-    const laedt = $('laedt');
-    try {
-      const antwort = await fetch('/workspace/api/willkommen');
-      if (!antwort.ok) {
-        /* DER DRITTE AUSGANG: nicht "nichts da", sondern "konnte nicht
-           nachsehen" -- mit einem Weg zurück. */
-        window.ladefehler?.({ nochmal: bauen });
-        if (laedt) laedt.hidden = true;
-        $('haupt')?.removeAttribute('aria-busy');
-        return;
-      }
-      const d = await antwort.json();
-
-      $('gruss').textContent = d.gruss || 'Willkommen!';
-      document.title = `Willkommen, ${d.name} · Team Dogi`;
-
-      if (d.rollentext) {
-        const r = $('rollentext');
-        r.textContent = d.rollentext;
-        r.hidden = false;
-      }
-      $('einleitung-was').textContent = d.einleitung?.was || '';
-      $('einleitung-dazu').textContent = d.einleitung?.dazu || '';
-
-      /* ---- Die Hinweise zur Rolle ---- */
-      const hk = $('hinweise');
-      const hinweise = d.hinweise || [];
-      if (hinweise.length) {
-        hk.replaceChildren();
-        for (const h of hinweise) {
-          const k = el('div', 'w-hinweis');
-          k.append(el('h2', 'w-hinweis__titel', h.titel));
-          k.append(el('p', 'w-hinweis__text', h.text));
-          hk.append(k);
-        }
-        hk.hidden = false;
-      }
-
-      /* ---- Die Kacheln, nach Gruppen ---- */
-      const ziel = $('gruppen');
-      ziel.replaceChildren();
-      const gruppen = d.gruppen || [];
-      if (!gruppen.length) {
-        /* KEIN LEERER BILDSCHIRM. Das kommt vor, wenn jemand gerade
-           erst angelegt wurde -- dann ist das kein Fehler, sondern ein
-           Zustand, und er gehört erklärt. */
-        ziel.append(el('p', 'w-leer',
-          'Für dich ist im Moment noch nichts freigeschaltet. '
-          + 'Sag DogFather Bescheid — das ist schnell gemacht.'));
-      }
-      for (const g of gruppen) {
-        const abschnitt = el('section', 'w-gruppe');
-        abschnitt.append(el('h3', 'w-gruppe__titel', g.name));
-        const raster = el('div', 'w-raster');
-        for (const k of (g.kacheln || [])) raster.append(kachelBauen(k));
-        abschnitt.append(raster);
-        ziel.append(abschnitt);
-      }
-
-      const satz = $('bereiche-satz');
-      if (satz && d.kachelzahl) {
-        satz.textContent = d.kachelzahl + (d.kachelzahl === 1
-          ? ' Bereich ist für dich freigeschaltet — und wofür er da ist. '
-          : ' Bereiche sind für dich freigeschaltet — und wofür sie da sind. ')
-          + 'Tipp einen an, um hinzugehen.';
-      }
-
-      if (laedt) laedt.hidden = true;
-      $('haupt')?.removeAttribute('aria-busy');
-    } catch (f) {
-      window.ladefehler?.({ nochmal: bauen });
-      if (laedt) laedt.hidden = true;
-      $('haupt')?.removeAttribute('aria-busy');
-    }
-  }
-
-  bauen();
-})();