Anleitung, Etappen 3 bis 7: alle vier Fassungen, Pflege, Suche, Rundgang, Abnahme

Der Bauplan ist damit vollstaendig umgesetzt.

ETAPPE 3 -- SCOUT, MANAGER UND SPICY MEDIA.
Woertlich aus Kapitel 07 bis 09, zusammen 84 Karten. Die Zahlen des
Bauplans stimmen auf die Karte genau: 18/21/22/23, verteilt 5/6/7,
5/7/9, 6/9/7, 5/5/13.

EINE ZWEIDEUTIGKEIT IM PDF, GEMESSEN STATT GERATEN. Beim Manager
nennt die Merke-Spalte "61, 58, 51 feste Punkte", und Layout- und
Raw-Auszug ordnen sie verschiedenen Kacheln zu. Nachgezaehlt im Code:
LIVE 69, Content-Ideen 61, Community 58, Technik 51. Damit ist die
zeilenweise Lesart bewiesen richtig -- die Layout-Lesart haette "61"
der LIVE-Analyse gegeben, die 69 hat.

Die Zuordnungspruefung laeuft jetzt fuer alle vier Rollen, und die
erwartete Kartenzahl wird AUS DER KACHELLISTE abgeleitet, nicht aus
der Abnahmeliste abgeschrieben. Dazu eine Gegenprobe, dass sich die
vier Fassungen wirklich unterscheiden -- sonst waeren alle Zeilen
gruen, solange die Kachellisten zufaellig passen.

ETAPPE 4 -- DIE PFLEGE, fuer DogFather UND Spicy.
Bearbeitet wird an Ort und Stelle: Stufe und die drei Zeilen je Karte,
Titel und Text je Listenzeile, Leitgedanke je Rolle. Fehlende Karten
werden benannt und lassen sich mit einem Griff anlegen -- das ist der
Fall "Fuer diese Kachel fehlt ein Eintrag" aus Kapitel 11. Dazu "Wer
ist wie weit": eine Arbeitslage, keine Ueberwachung.

KEINE ZWEITE ROLLENAUSWAHL. Die Vorschau gibt es schon -- sie heisst
"Meine Sicht" und steht in der Kopfleiste. Geprueft wird fuers Pflegen
`req.person` und nicht `req.sicht`: Wer durch fremde Augen sieht, soll
nicht aus Versehen in fremdem Namen aendern.

DIE MARKE "NEU" HAT EIN ENDE: 14 Tage ODER bis die Person die Seite
nach der Aenderung geoeffnet hat. Der Bauplan sagt dazu nichts, und
ohne Ende waere nach einem halben Jahr alles neu.

ETAPPE 5 -- DIE SUCHE.
Die Karten stehen in der Kopfleisten-Suche, aber nur die der EIGENEN
Rolle: Faende ein Creator die Manager-Karte, stuende dort "Zuteilen,
freigeben" neben einer Kachel, die er nicht hat. Der Treffer traegt
den Zusatz hinter dem Fragezeichen, sonst landen fuenf Karten auf
derselben Seite.

ETAPPE 6 -- BEGRUESSUNG UND RUNDGANG.
Fuenf Schritte ueber die Zentrale, im letzten leuchten nur die
Muss-Kacheln. EIGENE DATEI (`rundgang.js`) und nicht ein Stueck
start.js: Er laeuft auf der meistbenutzten Seite des Hauses, und wenn
hier etwas schiefgeht, darf davon nichts anderes betroffen sein.
Keine gerechnete Koordinate, kein Loch in einer Abdeckung -- die Seite
wird leiser, das Ziel bleibt hell. Faellt das Skript aus, ist beim
naechsten Laden alles normal.

DER ROLLENWECHSEL IST KEINE SONDERREGEL, sondern der Schluessel:
`(Person, Rolle)`. Die neue Rolle hat schlicht noch keine Zeile, also
startet die Einweisung von selbst noch einmal. Eine Spalte
"zuruecksetzen", an die jemand denken muesste, waere die Stelle, an
der es vergessen wird.

EIN FUND AUS DER MESSUNG: Gemerkt wurde zuerst erst am ENDE des
Rundgangs. Wer "Los geht's" drueckte und dann wegging, bekam die
Begruessung bei jedem Aufruf wieder -- fuer immer. Jetzt wird beim
ZEIGEN gemerkt; das ist die Tatsache, um die es geht.

ETAPPE 7 -- DIE ABNAHME.
Dabei fiel auf, dass der Rollen-Rundgang SPICY MEDIA gar nicht kannte:
fuenf Durchgaenge, aber zweimal Manager, zweimal Scout und Spicy nie.
Ihr gehoert die Gruppe "Rund um das Team" samt Team-Lage -- diese
Kachel ist in keinem Durchgang je geoeffnet worden. Jetzt laeuft sie
mit: 452 statt 406 Pruefungen.

MITGENOMMEN, WEIL ES ROT WAR: `pruef-eventkarte` und
`pruef-haus-luecke` bildeten ihr Tagesdatum aus UTC. Zwischen 00:00
und 02:00 deutscher Zeit liegt UTC im Vortag -- ein naechtlicher Lauf
haette an einem Datum gesucht, das er selbst nicht geschrieben hat.
Beide benutzen jetzt `helfer-zeit`. `pruef-struktur` ist damit gruen.

Gemessen (alle gruen, kein einziger Befund)
  pruef-anleitung        125 Pruefungen (vorher 70)
  pruef-rollen           452 Pruefungen (vorher 406) -- mit Spicy Media
  pruef-struktur         gruen (vorher rot)
  pruef-rechtetafel, pruef-css-klassen, pruef-kachel-universum,
  pruef-suchfeld, pruef-kachelraster, pruef-start-ansicht,
  pruef-sicht, pruef-eventkarte     alle gruen
  mess-anleitung         Rundgang fuenf Schritte, im letzten genau 5
                         Muss-Kacheln hervorgehoben; beim zweiten
                         Aufruf keine Begruessung mehr; kein
                         Querschieben bei 412 und 1440 px

Sicherung: ~/sicherungen/workspace-vor-anleitung-e37-20261006-1536.db

OFFEN, NICHT VON MIR UND NICHT AUS DIESEM BAUPLAN: pruef-haus-luecke
endet mit Rueckgabewert 3 ("konnte nicht nachsehen") -- eine der
beiden Adressen liefert das Anschlagbrett nicht. Nachgemessen: Das war
vor dieser Arbeit genauso.

Co-Authored-By: Claude Opus 5 <[email protected]>
This commit is contained in:
2026-10-06 15:37:00 +02:00
co-authored by Claude Opus 5
parent df67574f90
commit 98cfdc3ebc
58 changed files with 2765 additions and 707 deletions
+202
View File
@@ -21,6 +21,12 @@
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;
@@ -148,7 +154,13 @@
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'));
kopf.append(namen);
if (pflegeAn) kopf.append(aendernKnopf(() => karteOeffnen(eintrag, kachel)));
karte.append(kopf);
const zeilen = el('dl', 'an-karte__zeilen');
@@ -252,8 +264,11 @@
AUFBAUEN
===================================================================== */
function zeigen(d) {
daten = d;
$('ohne-fassung').hidden = true;
$('fassung').hidden = false;
$('pflege').hidden = !d.darf_pflegen;
document.body.dataset.pflege = pflegeAn ? 'ja' : 'nein';
$('leitgedanke').textContent = d.leitgedanke || '';
$('leitgedanke').hidden = !d.leitgedanke;
@@ -295,6 +310,7 @@
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);
@@ -318,6 +334,7 @@
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) => {
@@ -330,8 +347,10 @@
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);
}
function ohneFassung(d) {
@@ -345,6 +364,178 @@
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;
@@ -364,6 +555,17 @@
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.'));
})();