Florian WildeandClaude Opus 5
d226a6bae8
- Ausbilder gibt frei; vorher sieht der Azubi die Fragen nicht - Freigabe laesst sich zuruecknehmen, solange nicht abgegeben wurde - Antworten werden beim Tippen je Frage zwischengespeichert - Musterloesungen erst nach dem Absenden: sichtbareKontrolle() entfernt sie serverseitig, bevor die Daten in die Ausgabe gelangen - Korrektur mit Punkten und Anmerkung je Frage, Summe und Note laufen mit - Notenschluessel der IHK; solange eine Frage offen ist, bleibt das Ergebnis vorlaeufig und die Kontrolle gilt nicht als korrigiert - Ergebnis bei beiden sichtbar, Schnitt ueber alle Kontrollen - Abgegebene Kontrollen unter "Was auf dich wartet" und im Wochenfortschritt - scripts/pruefungen/musterloesung-dichtheit.mjs prueft die Sperre gegen den echten Wortlaut aus der Inhaltsdatei im rohen Seitenquelltext 36 neue Tests, davon 21 fuer die Sichtbarkeit der Musterloesung. Insgesamt 277. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
5.9 KiB
5.9 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
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