Anleitung, Etappe 1: die Einweisung fuer Creator steht

Erste von sieben Etappen aus dem geprueften Bauplan
(`02 Projekte/Anleitung-Kachel – Bauplan.md`). Ein Creator oeffnet die
neue Kachel und sieht seine vollstaendige Einweisung: drei Saetze „In
60 Sekunden", fuenf Erste Schritte, achtzehn Karten in drei Stufen,
„Das kannst du liegen lassen", sein Rhythmus und vier Fragen.

WAS NICHT IN DER DATENBANK STEHT -- und das ist der Kern.

Eine Karte zeigt Name, Symbol, Farbe und Adresse ihrer echten Kachel.
Nichts davon ist gespeichert. Es steht in bereiche.js, genau einmal,
und wird ueber einen abgeleiteten Schluessel verbunden
(`bereich.html?b=live` -> `bereich:live`). Haette ich den Namen
danebengeschrieben, erklaerte die Anleitung nach der ersten Umbenennung
eine Kachel, die es so nicht mehr gibt -- und niemandem fiele es auf.
Gespeichert ist nur, was der Bauplan NEU bringt: die Stufe und die drei
Saetze Wozu / Was du hier tust / Merke.

Der Schluessel muss abgeleitet sein, weil zwei Faelle sonst
zusammenfallen: `bereich.html` ist FUENF Kacheln, und `profil.html`
heisst beim Creator „Mein Profil" und beim Manager „Creator-Profile".

DIE WICHTIGSTE PRUEFUNG STEHT NICHT IM BAUPLAN.

pruef-anleitung.mjs fragt in BEIDE Richtungen: Hat jede Kachel, die
diese Rolle sieht, genau eine Karte -- und zeigt jede Karte auf eine
Kachel, die es wirklich gibt? Beides kann lautlos kaputtgehen, und der
Bauplan sah dafuer nur einen Hinweis in der Pflege-Ansicht vor. Der
hilft nur, wenn jemand hinsieht.

Dafuer wird bereiche.js in der Pruefung AUSGEFUEHRT (node:vm mit einem
winzigen Browser-Ersatz), nicht mit einem Muster durchsucht. Ein Muster
waere eine ungenaue Nachbildung und wuerde bei der ersten ungewohnten
Schreibweise „alles in Ordnung" melden.

DREI BEFUNDE BEIM BAUEN, ALLE GEMESSEN STATT GEAHNT:

1. Ton 48. Das Hauswerkzeug schlug #b0ec0a vor -- Abstand 0,0815 zur
   Kachel „Agentur", die ein Creator direkt daneben sieht, und 13,28:1
   Kontrast. Der Grund: Es rechnet gegen alle 47 Toene, aber die Haelfte
   gehoert zum anderen Haus und erscheint nie auf demselben Bildschirm.
   Gegen die 24 Toene DIESES Hauses gerechnet: #ff7eed, Abstand 0,1168
   (43 % mehr) bei sanfteren 8,46:1. Die Herleitung steht in start.css,
   samt Warnung, dass ein erneuter Werkzeuglauf es verschlechtern wuerde.

2. Die Erste-Schritte-Verweise waren 20 px hoch. Gemessen bei 412 px --
   die halbe Hausgroesse fuer einen Daumen, auf der Seite, die fuer
   Leute gebaut ist, die zum ersten Mal hier sind und auf dem Handy
   sitzen. Jetzt ist die ganze Zeile das Ziel, 44 px.

3. Die Textbloecke standen ohne Flaeche auf der Seite. Auf dem ersten
   Bild lief „Fast alles andere fuellt deine Betreuung fuer dich" quer
   ueber das helle Wasserzeichen des Hintergrundbildes. Deshalb hat im
   Haus jeder Textträger `--flaeche`: Ein Kontrast, der vom
   Bildausschnitt abhaengt, ist keiner.

NEBENBEI ZWEI LUECKEN GESCHLOSSEN: `manager-ziele.html` und
`anleitung.html` fehlten in der Seitenliste von pruef-rollen. Ganz
ungeprueft waren sie nicht -- der Kachel-Durchgang oeffnet jede Kachel
--, aber er prueft nur, WO man landet. Konsolenfehler, 4xx-Antworten,
tote Verweise und Ueberstehen liefen fuer beide nie. Dieselbe Sorte
stiller Luecke wie am 28.08.2026 bei RunOne.

ENTSCHEIDUNGEN VON FILIPE (06.10.2026):
  Pflege durch DogFather UND Spicy (nicht nur DogFather wie im Bauplan)
  -- dieselbe Regel wie bei den Manager-Zielen am 02.10.
  Vorerst nur das Agenturhaus, die Daten aber haus-bewusst angelegt.

DogFather bekommt keine Kachel (er braucht keine Einweisung), darf die
Seite aber oeffnen: Ueber den vorhandenen Sicht-Umschalter sieht er
jede Fassung. Eine zweite Rollenauswahl auf der Seite waere dieselbe
Funktion an einer Stelle, an der sie niemand sucht.

Gemessen
  pruef-anleitung     47 Pruefungen, 0 Fehler (neu)
  pruef-rollen       401 Pruefungen, 0 Fehler (vorher 384)
  pruef-rechtetafel   19 Pruefungen, 0 Fehler
  pruef-css-klassen   alles in Ordnung, jetzt 40 Seiten, 42 Stellen
                      unter 11,5 px (unveraendert)
  mess-anleitung      kein Querschieben bei 412 und 1440 px, keine
                      Konsolenfehler, alle 18 Karten mit Kachelfarbe

Sicherung vor dem Ausliefern:
  ~/sicherungen/workspace-vor-anleitung-20261006-1325.db (integrity ok)

Co-Authored-By: Claude Opus 5 <[email protected]>
This commit is contained in:
2026-10-06 13:26:43 +02:00
co-authored by Claude Opus 5
parent 26aec420f4
commit a7b2ad77b8
59 changed files with 2864 additions and 684 deletions
+80
View File
@@ -123,6 +123,16 @@
'M4 5h6.4c.9 0 1.6.7 1.6 1.6V19c0-.9-.7-1.6-1.6-1.6H4z',
'M20 5h-6.4c-.9 0-1.6.7-1.6 1.6V19c0-.9.7-1.6 1.6-1.6H20z'
],
/* WEGWEISER, KEIN BUCH (06.10.2026). Die Anleitung steht direkt
neben der Wissens-Bibliothek, und die ist schon ein Buch. Ein
zweites daneben waere dieselbe Aussage zweimal -- und die
Anleitung sagt etwas anderes: nicht "hier steht alles", sondern
"da lang, das andere kannst du liegen lassen". Zwei Schilder in
verschiedene Richtungen sind genau das. */
anleitung: [
'M4.5 5.5h12l2.5 2-2.5 2h-12z',
'M19.5 12h-12L5 14l2.5 2h12z'
],
automation: [
'M13.2 3.2 6 13.4h5.2l-.8 7.4 7.6-10.6h-5.2z'
],
@@ -299,6 +309,17 @@
linien: ['M4 5h6.4c.9 0 1.6.7 1.6 1.6V19c0-.9-.7-1.6-1.6-1.6H4z',
'M20 5h-6.4c-.9 0-1.6.7-1.6 1.6V19c0-.9.7-1.6 1.6-1.6H20z'],
},
anleitung: {
/* Der Pfosten steht in den Linien und NICHT im Koerper: Die drei
versetzten Tiefenlagen machen aus einer Flaeche eine Seitenwand
-- bei einem 1,5 Punkt breiten Pfosten waere daraus ein Klumpen
geworden. Die Schilder tragen die Tiefe, der Pfosten nur den
Strich. */
fuellung: ['M4.5 5.5h12l2.5 2-2.5 2h-12z'],
linien: ['M12 4.5V20',
'M4.5 5.5h12l2.5 2-2.5 2h-12z',
'M19.5 12h-12L5 14l2.5 2h12z'],
},
automation: {
fuellung: ['M13.2 3.2 6 13.4h5.2l-.8 7.4 7.6-10.6h-5.2z'],
linien: ['M13.2 3.2 6 13.4h5.2l-.8 7.4 7.6-10.6h-5.2z'],
@@ -670,6 +691,31 @@
nameCreator: 'Wissen',
unterCreator: 'Nachschlagen, wenn du etwas brauchst',
bereiche: [
/* ============================================================
DIE ANLEITUNG STEHT GANZ VORN (06.10.2026)
Sie ist die einzige Kachel dieser Gruppe, die fuer JEDE der
vier Rollen "Muss" ist -- und die einzige, die man braucht,
bevor man die anderen versteht. Haette sie ihren Platz nach
dem Alphabet oder nach Alter, stuende die Einweisung hinter
den Dingen, in die sie einweisen soll.
Fuer einen Creator heisst die Gruppe "Wissen" (siehe
nameCreator darueber); dort steht sie damit vor der
Wissens-Bibliothek, so wie es der Bauplan verlangt.
OHNE 'admin'. DogFather bekommt keine Einweisung -- bei ihm
oeffnet dieselbe Adresse spaeter die Pflege-Ansicht
(Etappe 4). Bis die steht, hat er die Kachel nicht: Eine
Kachel, die auf eine Seite fuehrt, die es fuer ihn noch
nicht gibt, ist ein Knopf, der nichts tut.
Ton 48 gerechnet am 06.10.2026 gegen die 24 Toene DIESES
Hauses -- die Herleitung steht in start.css bei [data-ton="48"]. */
{ name: 'Anleitung', unter: 'Was du brauchst und was nicht',
zeichen: 'anleitung', ton: 48,
rollen: ['spicy', 'manager', 'scout', 'creator'],
ziel: 'anleitung.html', szene: 'halle' },
/* NUR DogFather (02.09.2026, Wunsch: "die manager sollen diese
kategorien garnicht sehen").
@@ -1240,8 +1286,42 @@
return [...nach].map(([titel, leute]) => ({ titel, rolle: leute[0].rolle, leute }));
}
/* =====================================================================
DER KACHEL-SCHLUESSEL (06.10.2026, fuer die Anleitung)
Die Anleitung speichert je Rolle und Kachel drei Saetze. Verbunden
wird ueber diesen Schluessel, und er wird ABGELEITET statt
vergeben:
uebersicht.html -> uebersicht
bereich.html?b=live -> bereich:live
Zwei Faelle zwingen dazu. `bereich.html` ist FUENF Kacheln (live,
community, technik, schutz, agentur) -- ueber die Seite allein
waeren sie eine, und fuenf Karten landeten uebereinander. Und
`profil.html` heisst beim Creator "Mein Profil" und beim Manager
"Creator-Profile"; die trennt die Rolle, nicht die Adresse.
NUR `b=` zaehlt. Ein Parameter, der nur an eine Stelle derselben
Seite springt, unterscheidet keine Kachel.
Sie steht HIER und nicht im Server: Die Kachelliste liegt in
dieser Datei, der Server kennt sie nicht (bereicheFuer gibt fuers
Agenturhaus `null` zurueck -- "nimm die Liste aus dem Browser").
Eine zweite Fassung dort haette nichts zu rechnen gehabt. */
function schluesselVonZiel(ziel) {
const roh = String(ziel || '').trim();
if (!roh) return '';
const teile = roh.split('?');
const name = teile[0].replace(/\.html$/i, '');
if (!teile[1]) return name;
const b = new URLSearchParams(teile[1]).get('b');
return b ? name + ':' + b : name;
}
window.Bereiche = {
ZEICHEN, GRUPPEN, zuSeite, zeichenBauen, merkzeichenBauen,
LEITUNG, ROLLENFOLGE, ROLLEN_NAME, ROLLEN_GRUPPE, gruppieren,
schluesselVonZiel,
};
})();