Florian WildeandClaude Opus 5.5
44e6c8bb79
Merkkarten, Praxisaufgaben, Checklisten, Berichtsheft, Lernzielkontrollen und Feedbackgespraech lassen sich unter Verwaltung -> Module fuer die ganze Lern-Bar ab- und einschalten. Wochenplan, Handouts, Glossar, Auswertung und Verwaltung bleiben immer an. Gesperrt wird an drei Stellen, nicht im Layout (Next rendert Layouts beim Seitenwechsel darunter nicht neu): Seiten mit erfordereModul, Routen fuer PDF, Anhaenge und Lernstand mit modulAn, alle 37 Serveraktionen der Module mit pruefeModul. Die Anmeldepruefung kommt jeweils zuerst, damit ein Unangemeldeter nicht am 404 abliest, was abgeschaltet ist. Ein abgeschaltetes Modul traegt nirgends bei: Wochenplan, Fortschritt, Was-wartet, Mein Stand, Ergebnisverlauf, Rahmenplanabdeckung, Vorschlaege fuers Berichtsheft, Karten im Handout, Kurzbefehle im Manifest. Die Lernstand-Schnittstelle antwortet mit 410, das Geraet verwirft daraufhin seine Offline-Warteschlange. Abschalten loescht nichts. Gespeichert in modul_einstellung (Migration 0010); fehlt die Zeile, ist das Modul an, eine bestehende Datenbank verhaelt sich also wie vorher. 12 Tests fuer die Regeln, Abschnitt A8 im Abnahmelauf, Anleitung Kapitel 9 mit Bildschirmfoto, README, E43. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
7.2 KiB
7.2 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)
1.1 – Module
- Module abschaltbar unter Verwaltung → Module
- Merkkarten, Praxisaufgaben, Checklisten, Berichtsheft, Lernzielkontrollen, Feedbackgespräch; das Gerüst bleibt immer an
- Gesperrt in Seiten, Routen und Serveraktionen, nicht nur ausgeblendet
- Wochenplan, Fortschritt, Auswertung, Rahmenplanabdeckung, Vorschläge und App-Kurzbefehle richten sich nach dem Stand
- Abschalten löscht nichts
- Im Abnahmelauf geprüft (A8)
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