lernbar/docs/ANLEITUNG.md

Lern-Bar – Anleitung

Diese Anleitung zeigt die Anwendung so, wie sie im Betrieb benutzt wird: erst der Ausbilder, dann der Azubi. Wer die Lern-Bar aufsetzen will, findet das im README – hier geht es um den Umgang damit.

Die Bilder stammen aus einer laufenden Anwendung mit den Beispielinhalten und werden mit npm run screenshots neu erzeugt. Was hier steht, ist also nicht gemalt, sondern gemessen.

---

Inhalt

Für den Ausbilder

1. Anmelden
2. Ein Azubikonto anlegen
3. Den Wochenplan festlegen
4. Eine Praxisaufgabe abnehmen
5. Das Berichtsheft abzeichnen
6. Eine Lernzielkontrolle korrigieren
7. Die Rahmenplanabdeckung lesen
8. Ein Feedbackgespräch führen
9. Module ein- und ausschalten

Für den Azubi

10. Die Woche
11. Handouts lesen und suchen
12. Merkkarten lernen
13. Eine Praxisaufgabe abgeben
14. Eine Checkliste abarbeiten
15. Das Berichtsheft führen
16. Eine Lernzielkontrolle schreiben

Überall

17. Auf dem Handy
18. Ohne Netz
19. Hell und dunkel
20. Drucken
21. Wenn etwas nicht geht

---

Für den Ausbilder

1. Anmelden

Es gibt keine Selbstregistrierung. Das erste Ausbilderkonto legst du auf der Kommandozeile an (siehe README, Abschnitt In fünf Minuten zum laufenden System), alle weiteren Konten entstehen in der Verwaltung.

Nach dem Anmelden landest du auf deinem Überblick: was in dieser Woche ansteht, was offen ist, was auf dich wartet.

---

2. Ein Azubikonto anlegen

Verwaltung → Neues Azubikonto

Du gibst Name, E-Mail-Adresse, ein erstes Passwort (mindestens 10 Zeichen) und den Ausbildungsbeginn an; Probezeit und geplantes Ende sind freiwillig.

Das Passwort gibst du dem Azubi persönlich weiter – er kann es danach selbst ändern. Einsehbar ist es danach nirgends mehr, auch für dich nicht: In der Datenbank liegt nur ein Argon2id-Hash. Hat jemand sein Passwort vergessen, setzt du in der Verwaltung ein neues; das alte lässt sich nicht anzeigen.

Der Ausbildungsbeginn ist wichtiger, als er aussieht. Aus ihm ergeben sich das Ausbildungsjahr und damit die Wochennummern im Berichtsheft.

Ein Azubi hat genau einen Ausbilder. Das ist keine Einschränkung, die sich später aufheben ließe, sondern die Grundlage der Rechteprüfung: Der Azubi sieht ausschließlich seine eigenen Daten, der Ausbilder die seiner Azubis.

---

3. Den Wochenplan festlegen

Wochenplan

Die Wochen selbst stehen als Dateien unter content/wochen/. Hier legst du fest, wann welche Woche läuft, und kannst sie verschieben – Urlaub, Berufsschulblock, ein Projekt, das dazwischenkommt.

Verschiebst du eine Woche, wandern die folgenden mit. Was der Azubi schon erledigt hat, bleibt erledigt.

---

4. Eine Praxisaufgabe abnehmen

Aufgaben → eine abgegebene Aufgabe öffnen

Der Azubi gibt eine Aufgabe mit seiner Lösung und optional mit Anhängen ab – meist Fotos vom Handy. Du siehst die Abnahmekriterien aus der Aufgabendatei und hakst ab, was erfüllt ist.

Eine Aufgabe ist abgenommen, wenn du sie abgenommen hast. Nicht, wenn der Azubi sie abgegeben hat. Genau dieser Unterschied macht sie später in der Rahmenplanabdeckung zu einem belastbaren Nachweis.

Reicht etwas nicht, gibst du sie mit einer Bemerkung zurück. Der Azubi sieht, was fehlt, und kann nachbessern.

---

5. Das Berichtsheft abzeichnen

Berichtshefte → ein Wochenblatt öffnen

Der Ausbildungsnachweis ist der einzige Teil dieser Anwendung, den das Gesetz verlangt. Deshalb ist er der sorgfältigste.

Du liest das Blatt, siehst die Warnhinweise (leere Tage, Floskeln, mögliche Betriebs- oder Personennamen) und zeichnest ab. Nach dem Abzeichnen ist das Blatt unveränderlich – auch für dich. Willst du eine Änderung, gibst du es frei; das wird protokolliert.

Über Als PDF bekommst du das Blatt im IHK-Layout, mit Unterschriftenfeldern. Ein Beispiel liegt unter docs/beispiel-ausbildungsnachweis.pdf.

---

6. Eine Lernzielkontrolle korrigieren

Kontrollen

Du gibst eine Kontrolle frei, der Azubi schreibt sie, du korrigierst. Punkte je Frage, daraus Prozent, daraus die Note nach dem IHK-Notenschlüssel (92/81/67/50/30 %).

Die Musterlösung bekommt der Azubi erst nach dem Absenden zu sehen. Vorher ist sie über keine Schnittstelle abrufbar – nicht im HTML, nicht in der Nachladung, nirgends. Das wird serverseitig entschieden, nicht in der Oberfläche, und mit einem eigenen Prüfskript nachgewiesen (scripts/pruefungen/musterloesung-dichtheit.mjs).

---

7. Die Rahmenplanabdeckung lesen

Auswertung

Das ist die Ansicht, die gegenüber der IHK zählt. Sie beantwortet die Frage, die im Prüfungsausschuss gestellt wird: Ist der Ausbildungsrahmenplan abgedeckt?

Statt „erledigt / offen" gibt es vier Lagen:

Lage	Bedeutung
vermittelt	eine abgenommene Praxisaufgabe oder ein abgeschlossener Checklisten-Durchlauf, oder mindestens zwei gelesene Handouts
angefangen	etwas erledigt, aber noch nicht genug – ein gelesenes Handout allein genügt bewusst nicht
geplant	Material vorhanden, aber unbearbeitet
ohne Inhalt	zu dieser Position gibt es im ganzen Lehrgang nichts

Die vierte Lage ist die wichtigste und wird rot ausgewiesen:

Das ist keine Lücke beim Azubi, sondern eine im Lehrgang. Dort hilft kein Lernen, sondern nur ein neues Handout oder eine neue Aufgabe unter content/. In den Beispielinhalten betrifft das fünf Positionen: A4, A10, C1, C2 und C5.

Jede Position führt ihre einzelnen Nachweise mit Kürzel und Zustand auf und nennt ihre amtliche Fundstelle in der Verordnung. Wenn jemand fragt, worauf sich die Bewertung stützt, steht die Antwort da.

---

8. Ein Feedbackgespräch führen

Feedback → Neues Gespräch anlegen

Monatlich, mit Leitfaden und Bewertungsbogen. Der Ablauf:

1. Du legst das Gespräch an und trägst deine Einschätzung ein: acht Kriterien auf einer Skala von 1 bis 5, dazu Stärken, Entwicklungsfelder und die vereinbarten Ziele.
2. Der Azubi trägt seine Selbsteinschätzung ein. Er sieht deine Freitexte, kann sie aber nicht ändern – und du kannst seine Selbsteinschätzung nicht eintragen. Eine Selbsteinschätzung, die der Ausbilder eintragen könnte, wäre keine.
3. Wo beide um zwei Stufen oder mehr auseinanderliegen, wird das hervorgehoben. Genau darüber lohnt das Gespräch – nicht über die Zahlen, sondern über die Stellen, an denen sie auseinandergehen.
4. Beide bestätigen. Danach ist das Gespräch unveränderlich.

Als PDF für die Akte gibt beide Einschätzungen nebeneinander aus, mit Unterschriftenfeldern. Abweichungen sind auch dort markiert.

Die Kriterien und der Leitfaden stehen in content/feedbackgespraech.yaml und lassen sich an den eigenen Betrieb anpassen. Ein bereits geführtes Gespräch behält seine Fassung, auch wenn du die Vorlage später änderst.

9. Module ein- und ausschalten

Verwaltung → Module

Nicht jeder Betrieb braucht alles. Führt ihr das Berichtsheft zum Beispiel im Portal der Kammer, schaltest du es hier ab – für die ganze Lern-Bar, für alle Azubis und Ausbilder zugleich.

Modul	Abschaltbar
Merkkarten, Praxisaufgaben, Checklisten, Berichtsheft, Lernzielkontrollen, Feedbackgespräch	ja
Wochenplan, Handouts, Glossar, Auswertung, Verwaltung	nein – das Gerüst

Was beim Abschalten passiert:

• Das Modul verschwindet aus der Navigation, aus dem Wochenplan, aus „Was auf dich wartet" und aus der Auswertung. Zu jedem Modul steht auf der Seite, was sich genau ändert.
• Seiten und PDFs sind gesperrt, nicht nur ausgeblendet. Wer sich die Adresse gemerkt hat, bekommt „Diese Seite gibt es nicht".
• Der Wochenfortschritt zählt das Modul nicht mehr mit. Eine Woche ohne Merkkarten erreicht also trotzdem 100 %.
• Die Rahmenplanabdeckung zählt abgeschaltete Aufgaben und Checklisten nicht mehr. Bleiben nur Handouts, gilt eine Position mit zwei gelesenen Handouts als vermittelt.
• Nichts wird gelöscht. Was im Modul schon geschrieben wurde – Berichtshefte, Bewertungen, Abnahmen –, bleibt gespeichert und ist nach dem Einschalten unverändert wieder da.

Unter jedem Modul steht, wer es wann zuletzt umgeschaltet hat.

Berichtsheft abschalten heißt nicht, kein Berichtsheft zu führen. Der Ausbildungsnachweis ist Pflicht und Voraussetzung für die Zulassung zur Abschlussprüfung. Er wird dann eben woanders geführt. In den Wochenplänen steht freitags weiterhin „Berichtsheft schreiben" – das gilt auch dann.

---

Für den Azubi

10. Die Woche

Die Startseite zeigt genau eine Woche: das Thema, was diese Woche zu tun ist, was schon erledigt ist, was drängt. Kein Dashboard mit zwölf Kacheln – die Frage lautet „Was mache ich jetzt?", nicht „Wie ist meine Gesamtlage?".

---

11. Handouts lesen und suchen

Die Handouts sind der Lesestoff: kurz, mit Beispielen, jeweils einem Thema zugeordnet. Die Suche geht über Titel und Volltext.

Unten markierst du ein Handout als gelesen. Das ist keine Spielerei: In der Auswertung zählen gelesene Handouts als stützende Nachweise für die Rahmenplanabdeckung.

Fachbegriffe, die dir unterwegs begegnen, stehen im Glossar – kurz erklärt, mit Querverweisen.

---

12. Merkkarten lernen

Die Karten gehören zu den Handouts und kommen nach dem Prinzip der Wiederholung nach Zeitabstand wieder: Was sitzt, kommt später wieder; was nicht sitzt, heute noch einmal.

Im Lernmodus:

• Antippen oder Leertaste – Karte umdrehen
• 1 / 2 / 3 – nochmal / unsicher / sitzt
• Wischen nach rechts für „sitzt", nach links für „nochmal"

Zehn Minuten am Tag reichen. Wer das durchhält, hat vor der Prüfung nichts nachzuholen.

---

13. Eine Praxisaufgabe abgeben

Du liest den Auftrag, siehst die Abnahmekriterien vorher – du weißt also, woran du gemessen wirst –, schreibst deine Lösung und hängst an, was dazugehört. Fotos vom Handy gehen direkt.

Dann gibst du ab. Der Ausbilder nimmt ab oder gibt zurück, mit Bemerkung.

---

14. Eine Checkliste abarbeiten

Checklisten sind für Abläufe, die immer gleich gehen: einen Arbeitsplatz übergeben, Windows installieren, einen Rechner zerlegen. Du startest einen Durchlauf und hakst Schritt für Schritt ab.

Ein Durchlauf kopiert die Schritte bei seinem Start. Ändert jemand die Checkliste, während du sie abarbeitest, bleibt dein Durchlauf so, wie du ihn begonnen hast. Am Ende gibt es ein PDF – ein Beispiel liegt unter docs/beispiel-checkliste.pdf.

---

15. Das Berichtsheft führen

Pro Kalenderwoche ein Blatt, gegliedert nach Tagen, mit Stunden. Die Anwendung hilft an drei Stellen:

• Vorschläge aus dem, was du in der Woche tatsächlich gemacht hast: abgenommene Aufgaben, abgeschlossene Checklisten, gelesene Handouts.
• Prüfung vor dem Abgeben: leere Tage, Floskeln („diverse Tätigkeiten", „wie immer"), verdächtige Namen von Firmen oder Personen. Der Ausbildungsnachweis geht an die IHK – da haben Kundennamen nichts verloren.
• Formulierungshilfe: aus „Drucker repariert" wird „Fehlerbild aufgenommen, Fixiereinheit getauscht, Testdruck geprüft, Ticket dokumentiert".

Nach dem Abzeichnen ist das Blatt unveränderlich.

---

16. Eine Lernzielkontrolle schreiben

Der Ausbilder gibt die Kontrolle frei, du siehst sie unter Kontrollen. Du schreibst deine Antworten und sendest ab.

Erst nach dem Absenden siehst du die Musterlösung – vorher nicht, und auch nicht über Umwege. Das ist keine Gängelei, sondern der Sinn der Sache: Eine Kontrolle, deren Lösung vorher abrufbar wäre, misst nichts.

---

Überall

17. Auf dem Handy

Die Anwendung ist für das Handy gebaut, nicht dafür angepasst. Der Azubi hat es in der Tasche, nicht den Laptop.

Handout	Lernmodus, Frage	Lernmodus, Antwort

Auf den Startbildschirm legen: Die Lern-Bar ist eine installierbare Anwendung.

• Android (Chrome): Menü → App installieren
• iPhone (Safari): Teilen → Zum Home-Bildschirm

Danach startet sie ohne Adresszeile und mit eigenem Symbol.

---

18. Ohne Netz

Im Serverraum, im Keller, im Zug gibt es kein Netz. Deshalb:

• Merkkarten und Handouts, die du schon einmal geöffnet hattest, funktionieren weiter.
• Deine Bewertungen werden gemerkt und gehen ab, sobald du wieder verbunden bist. Eine schmale Leiste sagt dir, wie viele warten – und meldet sich, wenn sie angekommen sind.
• Der Tag zählt, an dem du gelernt hast, nicht der Tag des Absendens.

Was nicht offline liegt: Lernzielkontrollen, Berichtsheft, Bewertungen, Feedbackgespräche, Anhänge und jedes PDF. Das ist Absicht. Diese Dinge stehen hinter einer eigenen Rechteprüfung, und was im Browserspeicher liegt, ist an dieser Prüfung vorbei.

Auf einem geteilten Gerät wird beim Abmelden alles Zwischengespeicherte weggeräumt.

---

19. Hell und dunkel

Oben rechts in der Kopfzeile schaltest du um. Die Einstellung bleibt auf dem Gerät. Beim Drucken wird immer hell gedruckt, auch wenn du dunkel eingestellt hast – sonst käme schwarzes Papier aus dem Drucker.

---

20. Drucken

Für die Dokumente, die eine Unterschrift tragen, gibt es PDFs: Wochenblatt, Checklisten-Durchlauf, Feedbackgespräch.

Für alles andere gibt es einen Druckknopf: Handout, Glossar, Auswertung. Die Navigation, Knöpfe und Hinweise werden nicht mitgedruckt, Karten werden nicht mitten durchgeschnitten, aufklappbare Abschnitte drucken aufgeklappt.

---

21. Wenn etwas nicht geht

Beobachtung	Woran es liegt
„Zu viele Fehlversuche" bei der Anmeldung	Nach fünf falschen Passwörtern wird die Adresse für eine Minute gesperrt, bei weiteren Fehlversuchen länger, höchstens 15 Minuten. Abwarten – oder Passwort vom Ausbilder neu setzen lassen. Hat sich das einzige Ausbilderkonto ausgesperrt: docker compose restart lernbar setzt die Sperre zurück.
Ein Bereich fehlt in der Navigation, oder seine Seite meldet „Diese Seite gibt es nicht"	Das Modul ist abgeschaltet. Ein Ausbilder schaltet es unter Verwaltung → Module wieder ein; die Daten sind noch da.
„Diese Seite gibt es nicht" bei fremden Daten	Kein Fehler, sondern die Rechteprüfung. Ob es zu einer Kennung überhaupt Daten gibt, geht Unbefugte nichts an – deshalb 404 und nicht „kein Zugriff".
Die Anwendung startet nicht, nennt aber Datei und Zeile	Ein Inhaltsfehler unter content/. Die Meldung sagt genau, wo. npm run inhalte:pruefen prüft ohne Start.
Ein Anhang lässt sich nicht hochladen	Über 25 MB. Bei einem Reverse Proxy zusätzlich client_max_body_size 30m setzen (siehe README).
Ein abgezeichnetes Blatt lässt sich nicht ändern	So gewollt. Der Ausbilder kann es freigeben; das wird protokolliert.
Offline erscheint „Kein Netz"	Diese Seite lag nicht auf dem Gerät. Merkkarten und schon geöffnete Handouts gehen weiter.

Bleibt etwas offen: docker compose logs -f zeigt, was der Server sagt, und /api/gesundheit antwortet nur dann mit 200, wenn die Datenbank ansprechbar ist.