Baustein 10b: Anleitung mit Screenshots, Abnahmelauf, Fassung 1.0.0

docs/ANLEITUNG.md: 20 Abschnitte, 27 Bildschirmfotos, getrennt fuer
Ausbilder und Azubi, dazu "Wenn etwas nicht geht". Die Bilder entstehen
automatisiert ueber npm run screenshots - was dort steht, ist gemessen
und nicht gemalt.

scripts/pruefungen/abnahme.mjs (npm run abnahme) laeuft gegen eine
frische, leere Datenbank in einem Wegwerfverzeichnis: aufsetzen, Konten
anlegen, arbeiten, abnehmen, sichern, beschaedigen, zurueckspielen. Eine
Sicherung, die nie zurueckgespielt wurde, ist keine Sicherung. 33 von 33
Pruefungen erfuellt, Protokoll in docs/ABNAHME.md.

Dabei drei echte Fehler gefunden, alle in Wegen, die nie ausgefuehrt
worden waren:

- Die Sicherungsskripte liefen nicht in Git Bash, obwohl das in ihrem
  Kopf stand: tar deutet den Doppelpunkt in "C:\..." als Rechnernamen.
  Beide wechseln jetzt erst ins Verzeichnis und uebergeben einen blossen
  Dateinamen.
- Auf einer frischen Datenbank gibt es noch kein Wochenblatt; der Weg
  jedes neuen Azubis war nie durchlaufen worden.
- Der Abnahmelauf selbst liess unter Windows seinen Server ueberleben
  (kill() beendet nur die cmd.exe) und prueft deshalb jetzt vorher, ob
  der Port frei ist - sonst haette er gegen fremde Daten geprueft.

Fassung 1.0.0: package.json stand noch auf 0.1.0, waehrend das
Aenderungsprotokoll bei 0.9.0 war.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Florian Wilde
2026-09-11 19:26:34 +02:00
co-authored by Claude Opus 5
parent 2babef9293
commit c61d5711e0
21 changed files with 1201 additions and 15 deletions
+49
View File
@@ -26,6 +26,54 @@ Vor `npm version` wandert der Abschnitt „Unveröffentlicht" unter eine neue
## [Unveröffentlicht]
## [1.0.0] – 2026-09-11
Die erste abnahmefähige Fassung. Alle zehn Bausteine sind fertig, die
Abnahmekriterien einzeln durchgespielt und protokolliert.
### Hinzugefügt
- **Installierbar** als Anwendung auf dem Startbildschirm: Manifest, Symbole
in drei Fassungen (darunter eine für den Beschnitt unter Android), erzeugt
aus dem eigenen Zeichen mit `npm run symbole` – ohne Bilddienst, ohne Netz
- **Offlinebetrieb** für den Fall, für den er gedacht ist: der Azubi im
Serverraum, im Keller, im Zug
- Merkkarten und schon geöffnete Handouts funktionieren weiter
- Bewertungen gehen in eine Warteschlange und werden nachgereicht, sobald
die Verbindung wieder steht. Angerechnet wird der Tag, an dem **gelernt**
wurde, nicht der Tag des Absendens
- Eine schmale Leiste sagt, wie viele Bewertungen warten – und meldet sich,
wenn sie angekommen sind
- **Nichts Bewertungsrelevantes liegt im Browserspeicher.** Weder
Lernzielkontrollen noch Berichtsheft, Bewertungen, Feedbackgespräche,
Anhänge oder PDFs. Was im Cache liegt, ist an der serverseitigen
Rechteprüfung vorbei – deshalb liegt es dort nicht
- Beim Abmelden wird alles Zwischengespeicherte weggeräumt
- **Druckansichten** mit Knöpfen bei Handout, Glossar und Auswertung
- **`docs/ANLEITUNG.md`** – Anleitung mit 27 Bildschirmfotos, für Ausbilder
und Azubi getrennt, dazu ein Abschnitt „Wenn etwas nicht geht"
- **`scripts/pruefungen/abnahme.mjs`** – der Abnahmelauf gegen eine frische,
leere Datenbank in einem Wegwerfverzeichnis: aufsetzen, Konten anlegen,
arbeiten, abnehmen, sichern, beschädigen, zurückspielen. Das Protokoll
landet in `docs/ABNAHME.md`
- `scripts/pruefungen/baustein-10.mjs` – Durchstich mit echtem Abschalten des
Netzes
### Behoben
- **Im Druck wurde die dunkle Fassung mitgedruckt.** Wer dunkel eingestellt
hatte, bekam schwarze Flächen aufs Papier. Für den Druck wird jetzt die
vollständige helle Palette gesetzt, dazu A4-Ränder, keine Umbrüche mitten in
Karten und Zeilen, und aufklappbare Abschnitte drucken aufgeklappt
- **Die Sicherungsskripte scheiterten an Pfaden mit Doppelpunkt.** `tar` deutet
einen Doppelpunkt im Dateinamen als Rechnernamen – aus `C:\...` wurde der
Rechner `C`. Beide Skripte wechseln jetzt erst ins Verzeichnis und
übergeben einen blossen Dateinamen. Im Kopf der Skripte stand, sie liefen
auch in Git Bash; das stimmte bis jetzt nicht
- Das Skript für die Bildschirmfotos suchte Wochenblatt und
Checklisten-Durchlauf auf der Kontrollseite, wo es sie nicht gibt – zwei
Bilder waren seit Wochen veraltet
## [0.9.0] – 2026-09-11
Auswertung, Rahmenplanabdeckung und das Feedbackgespräch.
@@ -401,6 +449,7 @@ anmelden und verwalten.
- `npm run konto:anlegen` für das erste Ausbilderkonto
[Unveröffentlicht]: #unveröffentlicht
[1.0.0]: #100--2026-09-11
[0.9.0]: #090--2026-09-11
[0.8.0]: #080--2026-09-11
[0.7.0]: #070--2026-09-10