- Wochenplan ist die Startseite des Azubis: Thema, Leitfrage, fuenf Tage mit Theorie und Praxis, Fortschrittsbalken, was noch offen ist - Ausbilder sieht je Azubi die laufende Woche mit Stand und offenen Punkten - /woche/<nr> fuer jede Woche, Ausbilder waehlt ueber ?azubi= den Stand; Zugriff wird serverseitig bei jedem Aufruf geprueft - Tabelle wochenplanung mit geplantem und tatsaechlichem Datum, Zustand und Notiz fuer den Azubi - Verschieben per Datumsfeld, wahlweise mit allen folgenden Wochen - Reihenfolge per Ziehen und Ablegen sowie per Tastatur (Alt + Pfeil) - Warnung bei sich ueberlappenden Terminen - Plan entsteht automatisch beim Anlegen eines Azubikontos - Planungs- und Fortschrittslogik als reine Funktionen, 36 Tests dafuer - Insgesamt 104 Tests Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
3.4 KiB
3.4 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)
0.4 – Nachweise
- B5 · Praxisaufgaben mit Anhängen und Abnahme
- B6 · Checklisten mit Durchläufen und PDF
- B7 · Berichtsheft: Tagesnotizen, Vorschläge, Prüfung, Abzeichnen, PDF
0.5 – Bewertung
- B8 · Lernzielkontrollen mit Freigabe, Abgabe, Korrektur
- 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