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:
co-authored by
Claude Opus 5
parent
2babef9293
commit
c61d5711e0
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user