- 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>
4.4 KiB
4.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)
- 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 ü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