Florian WildeandClaude Opus 5
be2a674c7a
Die Abdeckung des Ausbildungsrahmenplans ist die Ansicht, die gegenueber
der IHK zaehlt. Sie unterscheidet vier Lagen statt "erledigt/offen":
vermittelt eine abgenommene Aufgabe oder ein abgeschlossener
Checklisten-Durchlauf, oder zwei gelesene Handouts
angefangen etwas erledigt, aber noch nicht genug
geplant Inhalt vorhanden, nichts davon bearbeitet
ohne Inhalt zu dieser Position gibt es im Lehrgang gar nichts
Die vierte Lage ist die wichtigste: Sie ist keine Luecke beim Azubi,
sondern eine im Lehrgang, und wird getrennt ausgewiesen. Die Regel steht
als reine Funktion in src/lib/auswertung/abdeckung.ts, mit 17 Tests.
Das Feedbackgespraech laesst beide Seiten getrennt bewerten. Wo sie um
zwei Stufen oder mehr auseinanderliegen, wird das hervorgehoben - in der
Ansicht, in der Uebersicht und im PDF, alle drei ueber dieselbe Funktion
liegtWeitAuseinander(). Nach beidseitiger Bestaetigung ist das Gespraech
unveraenderlich und wird nur noch gelesen.
Durchstich in scripts/pruefungen/baustein-9.mjs: alle fuenf Luecken
erkannt, getrennte Spalten, Sperre serverseitig, PDF nur mit Anmeldung,
ein fremder Azubi bekommt 404 - auch auf das PDF.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
6.3 KiB
6.3 KiB
Fahrplan
Die Bausteine werden der Reihe nach umgesetzt. Nach jedem Baustein gibt es einen lauffähigen Stand, einen Eintrag im Änderungsprotokoll und eine Zeitnotiz im Arbeitstagebuch.
Legende: [ ] offen · [~] in Arbeit · [x] fertig
0.1 – Fundament
- B1 · Gerüst, Docker, Datenbank, Migrationen, Anmeldung, zwei Rollen
- Next.js 15 (App Router), TypeScript, ESLint, Vitest, Playwright
- SQLite über Drizzle, eigener Migrationslauf beim Start
- Argon2id, serverseitige Sitzungen, HttpOnly-Cookie, SameSite=Lax
- Rollen
ausbilder/azubi, reine Rechteregeln getrennt testbar - Verwaltung: Azubikonto und Ausbildung anlegen, Passwort setzen, sperren
- Dockerfile (mehrstufig), docker-compose.yml, Lebenszeichen
update.shfür den Linux-Server mit Sicherung und Rückfallsicherung.sh/wiederherstellen.sh
0.2 – Inhalte
- B2 · Inhalte einlesen und validieren, Handouts anzeigen, Suche
- Markdown mit YAML-Frontmatter, Zod-Prüfung, Start bricht bei Fehler ab
- Fehlermeldung nennt Datei und Zeile
- Handout-Ansicht mit festem Aufbau, Themenblöcke, „gelesen" merken
- Volltextsuche über alle Handouts
- Neu einlesen bei Dateiänderung im Entwicklungsbetrieb
- Glossar mit automatischer Verlinkung in den Handouts
- Beispielinhalte: 4 Wochen, 12 Handouts, 24 Merkkarten, 4 Aufgaben, 4 Checklisten, 2 Lernzielkontrollen, 24 Glossareinträge
- Rahmenplan aus FIAusbV und KMK-Rahmenlehrplan als Nachschlagewerk
0.3 – Woche und Wiederholung
- B3 · Wochenplan als Startseite, Fortschritt, Wochen verschieben
- Wochenplan ist die Startseite des Azubis: Thema, Leitfrage, fünf Tage mit Theorie und Praxis, Fortschrittsbalken, was noch offen ist
- Ausbilder sieht dieselbe Woche plus den Stand seiner Azubis
- Geplantes und tatsächliches Datum je Woche
- Verschieben per Datumsfeld, wahlweise mit allen folgenden Wochen
- Reihenfolge per Ziehen und Ablegen und per Tastatur
- Zustand je Woche (geplant / läuft / abgeschlossen) und Notiz für den Azubi
- Warnung bei sich überlappenden Terminen
- B4 · Merkkarten mit Wiederholung nach Zeitabstand (SM-2)
- Vereinfachtes SM-2 mit drei Bewertungsstufen statt sechs
- Täglich fälliger Stapel, gedeckelt auf 20 Karten
- Fünf Fächer zur Anzeige, abgeleitet aus dem Abstand
- Filter nach Themenblock für gezieltes Üben vor der Kontrolle
- Lernmodus fürs Handy: große Flächen, Antippen, Wischen, kein Hover
- Am Rechner zusätzlich Leertaste und Tasten 1 / 2 / 3
- Jede Bewertung wird mitgeschrieben (Verlauf für die spätere Auswertung)
- Merkkarten zählen im Wochenfortschritt mit
0.4 – Nachweise
- B5 · Praxisaufgaben mit Anhängen und Abnahme
- Status offen / in Arbeit / zur Abnahme / abgenommen
- Notizen des Azubis, Dateianhänge (Fotos, Bildschirmfotos, PDF)
- Ausbilder hakt Kriterien einzeln ab, Note und Rückmeldung
- Abnehmen sperrt die Aufgabe, Zurückgeben zur Nacharbeit
- Anhänge nur über Kennung, Berechtigung bei jedem Abruf geprüft
- „Was auf dich wartet" zeigt offene Abnahmen
- Aufgaben zählen im Wochenfortschritt mit
- B6 · Checklisten mit Durchläufen und PDF
- Durchlauf aus einer Vorlage, mit Datum, Ticket und Kunde
- Schritt für Schritt abhaken, Bemerkung je Schritt
- Fortschritt je Gruppe (Vorbereiten / Durchführen / Prüfen / Abschließen)
- Abschließen erst, wenn alles abgehakt ist
- Abgeschlossene Durchläufe bleiben als Nachweis und sind gesperrt
- PDF-Export mit Unterschriftenzeilen
- Ausbilder liest mit, hakt aber nicht für den Azubi ab
- B7 · Berichtsheft: Tagesnotizen, Vorschläge, Prüfung, Abzeichnen, PDF
- Tägliche Stichworte, je Tag ein eigenes kleines Formular
- Vorschläge aus Tagesnotizen, Aufgaben, Checklisten und Handouts
- Formulierungshilfe: Tätigkeitsverben und „so besser nicht / so ist es richtig"
- Prüfung auf fehlende Stunden, Floskeln und schützenswerte Angaben
- Warnung, keine Sperre – Einreichen ist immer möglich
- Einreichen, zurückgeben mit Anmerkung, abzeichnen; danach gesperrt
- Fehlende Wochen werden benannt und lassen sich nachtragen
- PDF im IHK-Layout, einzeln oder als ganzer Zeitraum
0.5 – Bewertung
- B8 · Lernzielkontrollen mit Freigabe, Abgabe, Korrektur
- Ausbilder gibt frei, kann die Freigabe vor der Abgabe zurücknehmen
- Fragen erst ab der Freigabe sichtbar
- Antworten werden beim Tippen zwischengespeichert
- Musterlösungen erst nach dem Absenden – serverseitig entfernt, nicht in der Oberfläche versteckt
- Korrektur mit Punkten je Frage, Anmerkung je Frage und gesamt
- Notenschlüssel der IHK, Zwischenstand beim Korrigieren sichtbar
- Ergebnis bei beiden sichtbar, Verlauf über alle Kontrollen
- B9 · Auswertung, Rahmenplanabdeckung, Feedbackgespräch
- Stand des Azubis: Handouts, Merkkarten, Aufgaben, Berichtsheft
- Rahmenplanabdeckung mit vier Lagen statt „erledigt/offen"
- Lücken im Lehrgang werden getrennt ausgewiesen
- Lernfeldabdeckung nach Ausbildungsjahr
- Ergebnisverlauf der Lernzielkontrollen
- Feedbackgespräch mit Leitfaden und Bewertungsbogen
- Beide Seiten bewerten getrennt, Abweichungen werden hervorgehoben
- Nach beidseitiger Bestätigung unveränderlich, PDF für die Akte
1.0 – Abrundung
- B10 · PWA, Offlinebetrieb, Druckansichten, Feinschliff
- Anleitung mit Screenshots (
docs/ANLEITUNG.md), Bilder automatisiert übernpm run screenshots - Ende-zu-Ende-Test über den Hauptweg
- Abnahmekriterien einzeln durchgespielt und protokolliert
- Anleitung mit Screenshots (
Danach – bewusst zurückgestellt
- Erinnerung freitags per E-Mail (in der Anwendung reicht zunächst)
- Importskript für vorhandenes Material (52 Handouts, 8 Checklisten, …), sobald die Quelldateien vorliegen
- Wechsel auf PostgreSQL (vorbereitet durch die Repository-Schicht, aber ohne Anlass nicht sinnvoll)
Ausdrücklich nicht geplant
Mehrmandantenfähigkeit · Chat und Kommentare · Gamification · Inhaltseditor in der Oberfläche · IHK-Schnittstellen · KI-Funktionen