Florian WildeandClaude Opus 5
1af5613e9b
Die fachlichen Inhalte liegen als Dateien unter content/ und werden beim Start eingelesen, geprueft und in den Speicher geladen. - Inhaltslader mit Zod-Schemata und Querverweispruefung - Fehlermeldungen nennen Datei und Zeile, gesammelt statt beim ersten Fehler geworfen; die Anwendung startet bei Fehlern nicht - npm run inhalte:pruefen prueft ohne Start - Handout-Ansicht mit festem Aufbau, Uebersicht nach Themenbloecken - Volltextsuche mit Gewichtung und Trefferausschnitt - Gelesen-Markierung je Handout - Glossar mit Suche und automatischer Verlinkung in den Handouts - Beispielinhalte: 4 Wochen, 12 Handouts, 24 Merkkarten, 4 Aufgaben, 4 Checklisten, 2 Lernzielkontrollen, 24 Glossareintraege - rahmenplan.yaml aus FIAusbV 2020 und KMK-Rahmenlehrplan, mit Fundstellen - gray-matter entfernt, YAML-Kopf wird selbst herausgeloest - npm run screenshots nimmt die Bilder fuer die Anleitung auf - 39 neue Tests, insgesamt 68 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
74 lines
2.9 KiB
Markdown
74 lines
2.9 KiB
Markdown
# Fahrplan
|
||
|
||
Die Bausteine werden der Reihe nach umgesetzt. Nach jedem Baustein gibt es
|
||
einen lauffähigen Stand, einen Eintrag im [Änderungsprotokoll](CHANGELOG.md)
|
||
und eine Zeitnotiz im [Arbeitstagebuch](DEVLOG.md).
|
||
|
||
Legende: `[ ]` offen · `[~]` in Arbeit · `[x]` fertig
|
||
|
||
---
|
||
|
||
## 0.1 – Fundament
|
||
|
||
- [x] **B1 · Gerüst, Docker, Datenbank, Migrationen, Anmeldung, zwei Rollen**
|
||
- [x] Next.js 15 (App Router), TypeScript, ESLint, Vitest, Playwright
|
||
- [x] SQLite über Drizzle, eigener Migrationslauf beim Start
|
||
- [x] Argon2id, serverseitige Sitzungen, HttpOnly-Cookie, SameSite=Lax
|
||
- [x] Rollen `ausbilder` / `azubi`, reine Rechteregeln getrennt testbar
|
||
- [x] Verwaltung: Azubikonto und Ausbildung anlegen, Passwort setzen, sperren
|
||
- [x] Dockerfile (mehrstufig), docker-compose.yml, Lebenszeichen
|
||
- [x] `update.sh` für den Linux-Server mit Sicherung und Rückfall
|
||
- [x] `sicherung.sh` / `wiederherstellen.sh`
|
||
|
||
## 0.2 – Inhalte
|
||
|
||
- [x] **B2 · Inhalte einlesen und validieren, Handouts anzeigen, Suche**
|
||
- [x] Markdown mit YAML-Frontmatter, Zod-Prüfung, Start bricht bei Fehler ab
|
||
- [x] Fehlermeldung nennt Datei und Zeile
|
||
- [x] Handout-Ansicht mit festem Aufbau, Themenblöcke, „gelesen" merken
|
||
- [x] Volltextsuche über alle Handouts
|
||
- [x] Neu einlesen bei Dateiänderung im Entwicklungsbetrieb
|
||
- [x] Glossar mit automatischer Verlinkung in den Handouts
|
||
- [x] Beispielinhalte: 4 Wochen, 12 Handouts, 24 Merkkarten, 4 Aufgaben,
|
||
4 Checklisten, 2 Lernzielkontrollen, 24 Glossareinträge
|
||
- [x] Rahmenplan aus FIAusbV und KMK-Rahmenlehrplan als Nachschlagewerk
|
||
|
||
## 0.3 – Woche und Wiederholung
|
||
|
||
- [ ] **B3 · Wochenplan als Startseite, Fortschritt, Wochen verschieben**
|
||
- [ ] **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
|