Files
lernbar/ROADMAP.md
T
Florian WildeandClaude Opus 5 103a603eb4 Baustein 3: Wochenplan als Startseite, Fortschritt, Wochen verschieben
- 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>
2026-09-10 09:04:39 +02:00

3.4 KiB
Raw Blame History

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.sh für den Linux-Server mit Sicherung und Rückfall
    • sicherung.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 über npm run screenshots
    • Ende-zu-Ende-Test über den Hauptweg
    • Abnahmekriterien einzeln durchgespielt und protokolliert

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