Files
lernbar/ROADMAP.md
T
Florian WildeandClaude Opus 5 ffbca01bdc Baustein 5: Praxisaufgaben mit Anhaengen und Abnahme
- Status offen / in Arbeit / zur Abnahme / abgenommen, mit Zeitstempeln
- Notizfeld fuer den Azubi, Dateianhaenge bis 25 MB
- Speicherpfad nur aus selbst erzeugter UUID, nie aus dem Dateinamen
- Auslieferung ueber /anhaenge/<kennung> mit Rechtepruefung bei jedem Abruf,
  CSP sandbox und nosniff; SVG ausdruecklich nicht erlaubt
- Anhaenge haengen an Aufgabe UND Azubi
- Ausbilder hakt Kriterien einzeln ab, Note und Rueckmeldung, Abnahme sperrt
- Zurueckgeben zur Nacharbeit
- "Was auf dich wartet" zeigt offene Abnahmen
- Abgenommene Aufgaben zaehlen im Wochenfortschritt mit

Behoben: Next.js deckelt Serveraktionen ab Werk bei 1 MB - damit waere kein
Handyfoto durchgekommen. bodySizeLimit jetzt 30 MB, Vorabpruefung im Browser,
client_max_body_size im Proxy-Beispiel auf 30m.

Geaendert: Seiten verweigern fremde Daten mit 404 statt mit einem Fehler.
Eigene Seiten fuer "Nicht gefunden" und Stoerfaelle.

24 neue Tests, insgesamt 157.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-10 12:18:54 +02:00

4.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)
    • 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
  • 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