Florian WildeandClaude Opus 5
c61d5711e0
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>
6.7 KiB
6.7 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
- Installierbar: Manifest, Symbole aus dem eigenen Zeichen erzeugt
- Offline: Merkkarten und gelesene Handouts, Bewertungen in einer Warteschlange, nachgereicht bei Verbindung
- Nichts Bewertungsrelevantes im Browserspeicher – nachgewiesen
- Druckansichten, auch bei eingestellter dunkler Fassung
- Anleitung mit Screenshots (
docs/ANLEITUNG.md), Bilder automatisiert übernpm run screenshots - Ende-zu-Ende-Test über den Hauptweg (
scripts/pruefungen/abnahme.mjs) - Abnahmekriterien einzeln durchgespielt und protokolliert
(
docs/ABNAHME.md)
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