# Arbeitstagebuch Zeiten in Europe/Berlin. Jeder Abschnitt entspricht einem Baustein aus dem [Fahrplan](ROADMAP.md). Format: `HH:MM–HH:MM (Dauer) · was gemacht wurde` --- ## 2026-09-10 · Baustein 7 – Berichtsheft | Von | Bis | Dauer | Tätigkeit | |---|---|---|---| | 21:50 | 22:05 | 0:15 | Prüflogik: Stunden, Floskeln, schützenswerte Angaben – mit 31 Tests | | 22:05 | 22:15 | 0:10 | Vorschläge aus dem System, Formulierungshilfe, 15 Tests | | 22:15 | 22:25 | 0:10 | Datenmodell, Migration, Repository | | 22:25 | 22:40 | 0:15 | PDF im IHK-Layout mit Kästen, Stundenspalten und Unterschriften | | 22:40 | 23:00 | 0:20 | Seiten, Formulare, Abzeichnen, Tagesnotizen | | 23:00 | 23:15 | 0:15 | Durchstich über den ganzen Weg, zwei Fehler behoben | **Summe Baustein 7: rund 1 h 25 min** ### Was aufgefallen ist - Die Floskelprüfung war der kniffligste Teil. „Diverse Arbeiten" ist eine Floskel, „Diverse Patchkabel konfektioniert und beschriftet" nicht. Gelöst über zwei Bedingungen: Die Prüfung schlägt an, wenn die Floskel den Eintrag im Wesentlichen ausmacht **oder** wenn im ganzen Eintrag kein einziges Tätigkeitsverb vorkommt. - Bei den Kundennamen hat ein Test einen echten Fehler gefunden: „Beispiel e. V." wurde nicht erkannt. Ursache war ein `\b` am Ende des Musters – nach einem Punkt gibt es vor einem Leerzeichen keine Wortgrenze. Ersetzt durch einen negativen Vorausblick. - ESLint hat wieder einen echten Bug gefunden: Das Abzeichnen-Formular hatte gar keine `action`, der Knopf hätte nichts bewirkt. Sichtbar wurde das nur über die Meldung „Serveraktion zugewiesen, aber nie benutzt". - Im PDF-Kopffeld liefen die beiden Spalten auseinander, weil ich `dokument.y` als Bezugspunkt in der Schleife benutzt habe – der Wert wandert aber bei jedem Schreibvorgang weiter. Wieder etwas, das erst beim Ansehen auffiel. - Beim Prüfen des PDF-Zugriffs ohne Anmeldung kam zunächst 200. Erst der zweite Blick mit `maxRedirects: 0` zeigte: 307 auf /anmelden, 0 Byte, kein PDF. Playwright war der Weiterleitung gefolgt. Merke: Bei Berechtigungsprüfungen nie den Weiterleitungen folgen lassen. - Die laufende Nummer eines Wochenblatts richtet sich nach dem Zeitraum, nicht nach der Reihenfolge des Anlegens. Wer eine Woche nachträgt, soll Nr. 3 bekommen und nicht Nr. 12 – die dahinterliegenden Blätter rücken auf. --- ## 2026-09-10 · Baustein 6 – Checklisten und PDF | Von | Bis | Dauer | Tätigkeit | |---|---|---|---| | 20:35 | 20:42 | 0:07 | Datenmodell, Migration, Schema | | 20:42 | 20:48 | 0:06 | Gruppenfortschritt als reine Rechnung, 16 Tests | | 20:48 | 20:52 | 0:04 | PDF-Grundlage und Checklisten-PDF | | 20:52 | 21:00 | 0:08 | Repository, Aktionen, Seiten, PDF-Route | | 21:00 | 21:10 | 0:10 | Durchstich; PDF gerendert und den Fußzeilenfehler gefunden | | 21:10 | 21:20 | 0:10 | Fehler behoben, Regressionstest, Dokumente | **Summe Baustein 6: rund 45 min** ### Was aufgefallen ist - **Das PDF hatte sechs Seiten, vier davon leer.** Aufgefallen ist das erst beim Ansehen – die Prüfung „Status 200, Content-Type application/pdf" war grün. Ursache: Die Fußzeile wird unterhalb des Satzspiegels gesetzt, und PDFKit hält das für überlaufenden Text und legt eine neue Seite an. Bei zwei Seiten mal zwei Textaufrufen macht das vier leere Seiten. Behoben, indem der untere Rand für die Dauer der Fußzeile auf 0 gesetzt wird. Ein Test zählt jetzt die Seitenobjekte im PDF und hätte den Fehler gefunden. - Headless-Chromium rendert keine PDFs. Für den Blick aufs Ergebnis musste der Browser mit Fenster starten (`headless: false`) – auf diesem Rechner geht das, auf einem Server nicht. Für die spätere Prüfstrecke heißt das: Seitenzahl und Inhalt maschinell prüfen, das Aussehen von Hand. - Titel und Schritttexte werden beim Start des Durchlaufs kopiert statt verwiesen. Ein Nachweis, der sich rückwirkend ändert, wenn jemand die Vorlage anfasst, wäre keiner. - Der Ausbilder darf das PDF abrufen und mitlesen, aber nicht abhaken. Erst beim Schreiben der Aktion ist mir aufgefallen, dass „darf sehen" und „darf bearbeiten" hier auseinanderfallen – daher zwei getrennte Prüffunktionen. --- ## 2026-09-10 · Baustein 5 – Praxisaufgaben | Von | Bis | Dauer | Tätigkeit | |---|---|---|---| | 11:55 | 12:05 | 0:10 | Datenmodell für Aufgabenstand und Anhänge, Migration, Schema | | 12:05 | 12:20 | 0:15 | Dateiregeln (Typen, Größe, Namenssäuberung, Speicherpfad) und 24 Tests dazu | | 12:20 | 12:35 | 0:15 | Repositories, Serveraktionen, Ausliefer-Route mit Rechteprüfung | | 12:35 | 13:00 | 0:25 | Aufgabenliste, Aufgabenseite, Bewertungsformular, Abnahme | | 13:00 | 13:20 | 0:20 | Durchstich – dabei den 1-MB-Deckel gefunden und behoben | | 13:20 | 13:35 | 0:15 | Fremdzugriff geprüft, Seiten auf 404 umgestellt, Screenshots, Dokumente | **Summe Baustein 5: rund 1 h 40 min** ### Was aufgefallen ist - **Der wichtigste Fund des Tages:** Next.js begrenzt Serveraktionen ab Werk auf 1 MB Rumpfgröße. Meine eigene Grenze von 25 MB war damit nie erreichbar – jedes Handyfoto (2 bis 5 MB) wäre stillschweigend gescheitert, mit einem Fehler nur im Serverprotokoll. Genau das Abnahmekriterium „eine Praxisaufgabe mit Foto abgeben" hätte nicht funktioniert. Gefunden hat den Fehler nur der Durchstich mit einer echten Datei, nicht die Testdatei mit 200 Byte. Gegenprobe danach: 3,8-MB-Foto hochgeladen, kommt mit 3 987 781 Byte zurück. - Die eigene Fehlerseite für „kein Zugriff" hat nicht funktioniert, weil Next.js Fehlermeldungen im Produktionsbetrieb schwärzt – der Text kommt nie im Browser an. Statt daran herumzubasteln liefern die Seiten jetzt 404. Das ist ohnehin die bessere Antwort: Ob es die Daten gibt, geht einen Unbefugten nichts an. Die Anhang-Route machte das von Anfang an so. - Anhänge hängen an Aufgabe **und** Azubi. Beim ersten Entwurf hätte ein zweiter Azubi die Fotos des ersten an derselben Aufgabe gesehen. - Geprüft mit einem eigens angelegten zweiten Ausbilderkonto: fremder Anhang 404, eigener 200, der zuständige Ausbilder 200. Danach wieder gelöscht. --- ## 2026-09-10 · Baustein 4 – Merkkarten | Von | Bis | Dauer | Tätigkeit | |---|---|---|---| | 11:00 | 11:20 | 0:20 | Wiederholungsverfahren: SM-2 auf drei Bewertungsstufen eingedampft, Fächer, Stapelauswahl | | 11:20 | 11:35 | 0:15 | 29 Tests dazu – einer schlug an, der Test war falsch, nicht der Code (siehe unten) | | 11:35 | 11:50 | 0:15 | Migration, Schema, Repository, Serveraktion für die Bewertung | | 11:50 | 12:15 | 0:25 | Lernmodus: Karte, Umdrehen, Wischen, Tastatur; Kartenübersicht mit Fächern | | 12:15 | 12:30 | 0:15 | Durchstich am Rechner und am Handy, zwei Mängel am Handy behoben | | 12:30 | 12:40 | 0:10 | Karten in den Wochenfortschritt gehängt, Dokumente nachgezogen | **Summe Baustein 4: rund 1 h 40 min** ### Was aufgefallen ist - Ein Test schlug fehl: „gibt einen leeren Stapel zurück, wenn nichts fällig ist". Der Code lieferte eine nie gelernte Karte zurück – und hatte recht. Eine Karte ohne Fälligkeitsdatum muss immer fällig sein, sonst käme sie nie dran. Ich habe die Erwartung korrigiert und den Fall in zwei Tests getrennt. - „nochmal" muss die Karte **in derselben Sitzung** wiederbringen. Sie nur auf morgen zu legen, wäre folgenlos gewesen – man drückt „nochmal" ja gerade, weil man sie jetzt noch einmal sehen will. - Am Handy legte der Browser beim Antippen eine blaue Fläche über die ganze Lernkarte. `-webkit-tap-highlight-color: transparent` behebt das; ohne einen Blick auf ein echtes Gerätemaß wäre es nie aufgefallen. - Die Kopfzeile brauchte am Handy drei Zeilen und schob die Karte nach unten. Jetzt: Marke und Bedienung in einer Zeile, Navigation darunter zum Schieben. - Der Stapel wird bei 20 Karten gedeckelt. Ohne Deckel sitzt jemand nach drei Wochen Pause vor 52 Karten und macht es gar nicht. --- ## 2026-09-10 · Baustein 3 – Wochenplan | Von | Bis | Dauer | Tätigkeit | |---|---|---|---| | 09:05 | 09:20 | 0:15 | Datenmodell der Wochenplanung, Migration, Drizzle-Schema | | 09:20 | 09:45 | 0:25 | Planungslogik als reine Funktionen: erzeugen, verschieben, umsortieren, „welche Woche ist dran", Überschneidungen; dazu die Fortschrittsrechnung | | 09:45 | 09:55 | 0:10 | 36 Tests dafür – liefen beim ersten Anlauf durch | | 09:55 | 10:10 | 0:15 | Repository-Schicht, Wochensicht aus Inhalt + Planung + Fortschritt | | 10:10 | 10:35 | 0:25 | Wochenansicht, Startseiten für beide Rollen, Wocheneinzelansicht | | 10:35 | 10:55 | 0:20 | Wochenplanseite: verlegen, umsortieren mit Ziehen und Tastatur, Zustand, Notizen | | 10:55 | 11:10 | 0:15 | Durchstich im Browser, Screenshots, Dokumente nachgezogen | **Summe Baustein 3: rund 2 h 05 min** ### Was aufgefallen ist - Beim Umsortieren war die erste Idee, die Termine mitzuziehen. Falsch: Dann entstehen Lücken und Überschneidungen. Richtig ist, die Folge der Kalenderwochen als festen Rahmen zu behandeln und nur die Zuordnung zu ändern – der Plan bleibt so immer lückenlos. - Der Lint-Fehler „azubiId is defined but never used" im Verlegen-Formular war kein Stilproblem, sondern ein echter Bug: Dem Formular fehlte das versteckte Feld, das die Serveraktion ausliest. Ein Lauf hätte den Fehler zwar auch gezeigt, aber erst nach dem Klick. - Ziehen und Ablegen allein reicht nicht. Wer mit der Tastatur arbeitet, kommt damit nicht weiter, deshalb tun es die Pfeilknöpfe und Alt + Pfeil genauso. - Die Erfolgsmeldung nach „Wochen einplanen" ist nicht zu sehen, weil das Formular danach verschwindet – die erscheinende Planliste ist die Rückmeldung. Kein Fehler, aber es hat mich im Testskript zunächst gekostet. --- ## 2026-09-10 · Baustein 2 – Inhalte | Von | Bis | Dauer | Tätigkeit | |---|---|---|---| | 07:05 | 07:15 | 0:10 | Remote eingetragen, Push scheitert an fehlenden Zugangsdaten – zurückgestellt, Arbeit läuft weiter | | 07:15 | 07:25 | 0:10 | Ausbildungsrahmenplan und Lernfelder aus den Quellen geholt statt geraten (FIAusbV Anlage, KMK-Rahmenlehrplan) | | 07:25 | 07:50 | 0:25 | Beispielinhalte geschrieben: 12 Handouts mit Merkkarten, 4 Wochenpläne, 4 Aufgaben, 4 Checklisten, 2 Lernzielkontrollen, 24 Glossareinträge | | 07:50 | 08:20 | 0:30 | Inhaltslader: YAML-Dokumentmodell für Zeilennummern, Zod-Schemata, Fehlersammler, Querverweisprüfung | | 08:20 | 08:35 | 0:15 | Handout-Ansicht, Übersicht nach Blöcken, Volltextsuche, Glossar mit automatischer Verlinkung | | 08:35 | 08:50 | 0:15 | 39 neue Tests; zwei echte Fehler dabei gefunden (siehe unten) | | 08:50 | 09:00 | 0:10 | Screenshot-Skript, Bilder aufgenommen, Fahrplan und Änderungsprotokoll nachgezogen | **Summe Baustein 2: rund 1 h 55 min** ### Was aufgefallen ist - Die Zeilennummer in der Fehlermeldung war den Aufwand wert. Beim ersten Lauf gegen die echten Inhalte kam sofort `content/glossar.yaml:8 – Expected string, received number`: `formen: [169.254]` hatte YAML als Gleitkommazahl gelesen. Ohne Zeilenangabe hätte ich das in 24 Einträgen gesucht. - `gray-matter` liefert beim zweiten Einlesen desselben Textes ein Objekt ohne das Feld `matter` – im Betrieb fällt das nie auf, im Test sofort. Den YAML-Kopf selbst herauszulösen ist zehn Zeilen Arbeit und beseitigt gleich zwei Probleme. - Zod-Schemata mit `.default()` haben verschiedene Ein- und Ausgabetypen. Mit `z.ZodType` erzwingt TypeScript Gleichheit und leitet den falschen Typ ab; `` mit `z.output` ist die richtige Form. - Der Auftrag nennt für den Rahmenplan `C1` bis `C4`. Die Verordnung führt in Abschnitt F aber **fünf** integrativ zu vermittelnde Positionen. Ich habe alle fünf aufgenommen – sonst fehlt in der Abdeckung ausgerechnet die Position, die 2020 neu dazugekommen ist („Vernetztes Zusammenarbeiten unter Nutzung digitaler Medien"). Siehe ENTSCHEIDUNGEN.md, E10. --- ## 2026-09-10 · Baustein 1 – Fundament | Von | Bis | Dauer | Tätigkeit | |---|---|---|---| | 00:15 | 00:20 | 0:05 | Auftrag gesichtet, fehlende Stackvorgabe geklärt (Next.js 15 + React 19 + TypeScript), Repository angelegt | | 00:20 | 00:28 | 0:08 | Abhängigkeiten installiert; `better-sqlite3` auf v12 gehoben, weil es für Node 24 sonst keine fertige Binärdatei gibt und der Bau über Visual Studio scheiterte | | 00:28 | 00:40 | 0:12 | Datenbankschicht: Drizzle-Schema, eigener Migrationslauf mit Prüfsummen, Verbindung als Prozess-Singleton | | 00:40 | 00:52 | 0:12 | Zeitrechnung (Europe/Berlin, ISO-Kalenderwochen), Argon2id, serverseitige Sitzungen, Rechteregeln als reine Funktionen | | 00:52 | 01:10 | 0:18 | Gestaltung: Farbwelt Petrol/Bernstein, helle und dunkle Darstellung, Bedienelemente, Druckansicht | | 01:10 | 01:25 | 0:15 | Anmeldung, Rahmenlayout, Startseite, Verwaltung (Konto und Ausbildung anlegen, Passwort, Sperren) | | 01:25 | 01:32 | 0:07 | Erstes Ausbilderkonto über Skript angelegt, Typprüfung und Bau grün, Server geprüft | | 01:32 | 01:50 | 0:18 | Dockerfile, docker-compose, Lebenszeichen, `update.sh` mit Rückfall, Sicherung und Wiederherstellung | | 01:50 | 02:05 | 0:15 | Fahrplan, Änderungsprotokoll, Arbeitstagebuch, Entscheidungen, README | **Summe Baustein 1: rund 1 h 50 min** ### Was aufgefallen ist - Der Auftrag verweist zweimal auf einen „Kopf des Prompts" (Stack, Anmeldung), der nicht mitgeliefert wurde. Die Anmeldung war aus den technischen Vorgaben ableitbar, der Stack nicht – dafür gab es eine Rückfrage. - `npm` blockiert seit Version 11 Installationsskripte fremder Pakete. `better-sqlite3`, `esbuild` und `unrs-resolver` mussten einmalig über `npm approve-scripts` freigegeben werden. Das gehört in die README, sonst läuft ein Fremder in genau diese Wand. - Windows und LF: ohne `.gitattributes` hätte Git die Shell-Skripte mit CRLF ausgecheckt, und der Linux-Container hätte sie nicht mehr gestartet. ---