diff --git a/docs/STATUS.md b/docs/STATUS.md new file mode 100644 index 0000000..ed70310 --- /dev/null +++ b/docs/STATUS.md @@ -0,0 +1,64 @@ +# Refactor-Status · `refactor/didaktik-rewrite-2026` + +Letzter Stand: 2026-05-14 + +## Was steht + +### Foundation (Phasen 0–1) +- [x] `CLAUDE.md` · `README.md` · `AGENTS.md` mit didaktischem Fundament (auf `main`) +- [x] `docs/klausur-themen-2026.md` — 9 Klausur-Blöcke für 223015b gelockt (D1–D4 entschieden) +- [x] `docs/223015b-lernziele.md` — 33 operative Lernziele im Fließsatz-Eichmaß +- [x] `docs/223015b/01-…-bogen.md` bis `05-…-bogen.md` — 5 Kapitel-Skelette mit Folien-Plan, Streichungs-Liste, Demo-TODO + +### Demos (Phase 3) +- [x] `kap02-eroeffner.png` — Lossless vs Lossy Wellenform-Vergleich (FLAC vs MP3 128) +- [x] `kap03-eroeffner.png` — Drei Modalitäten Datei-Größen-Tabelle (Bild/Audio/Video) +- [ ] **Kap 4 Eröffner** — Datei-Reise-Pfad (SSD → SATA → USB-C → HDMI → Display mit Datenraten) +- [ ] **Kap 5 Eröffner** — Foto mit EXIF-Overlay (Privacy-Reveal) +- [ ] Übrige ~40 unterstützende Demos pro Kapitel (siehe Visualisierungs-Listen in den Bogen-Docs) + +### Erste 5 Eröffner-Versuche (verworfen) +Frühere Advance Organizer (`kap01-advance-organizer`, `kap02-bogen`, `kap03-modalitäten-bogen`, `kap04-bogen`, `kap05-bogen`) waren plump, gleichförmig und nicht erkenntnisgewinnend. Per Commit `1c8185b` gelöscht. Begründung: Topic-Boxen mit Pfeilen statt konkrete Daten in Transformation. Neue Strategie: pro Kapitel eigene Konkret-Komposition. + +### Slides selbst (Phase 4) +- [ ] Komplett offen — die Bogen-Docs sind das Skelett, daraus werden in Phase 4 die Marp-Markdown-Files erzeugt +- Reihenfolge laut Plan: 01-fundamentale → 02-kompression → 03-inhalte → 04-speicher → 05-distribution +- Aktuelle Slide-Files (`01-grundlagen-text-audio.md` etc.) bleiben unangetastet bis die neuen Files stehen — kein „halb migriert"-Zustand +- Make-Pattern erlaubt es, die alten Files weiterzulaufen während neue gebaut werden (gleicher Build-Befehl) + +## Wo weitermachen + +**Empfohlene nächste Schritte (in dieser Reihenfolge):** + +1. Kap 4 Eröffner-Demo bauen — Datei-Reise-Pfad +2. Kap 5 Eröffner-Demo bauen — EXIF-Overlay +3. Pro Kapitel die 3–4 wichtigsten neuen Demos (z.B. JPEG-Pipeline-Stationen, USB-C-drei-Achsen, CDN-Schema) +4. Phase 4 starten: Slide-MD-Files pro Kapitel schreiben, dabei existierende + neue Demos einbinden +5. Build-Test (`make build-223015b`), Render-Spot-Check +6. Erste Dozenten-Lesart durch Kapitel 1+2, justieren +7. Iterativ Kap 3–5 +8. PR auf `main`, Review, Merge, Deploy + +## Wichtige Konventionen + +- **Keine Emojis** — auch nicht als Icons in HTML-Demos +- **„Bit"/„Byte" sind Maßwörter** — kein s-Plural („Bits"/„Bytes") +- **„Selbstlernen"**, nicht „Hands-On" +- **Klausur-Folien bleiben verstreut** — kein Sammelblock am Kapitel-Ende +- **Lernziele = Vorschläge** an den Dozenten, nicht gesetzte Anforderungen; Default Bloom-Level Verstehen +- **Render vor Layout-Aussage** — chromium-headless, dann PNG mit Read-Tool inspizieren +- **Advance Organizer = Erkenntnisgewinn**, nicht Topic-Boxen mit Pfeilen + +## Branch-Operationen + +```bash +# Stand sehen +git log --oneline refactor/didaktik-rewrite-2026 + +# Auf neuesten Stand bringen +git switch refactor/didaktik-rewrite-2026 +git pull origin refactor/didaktik-rewrite-2026 + +# Plan-Datei +cat ~/.claude/plans/1-infinity-2-neue-wild-ember.md +``` diff --git a/slides/223015b/assets/demos/kap02-eroeffner.html b/slides/223015b/assets/demos/kap02-eroeffner.html new file mode 100644 index 0000000..e3cebcf --- /dev/null +++ b/slides/223015b/assets/demos/kap02-eroeffner.html @@ -0,0 +1,158 @@ + + +
+ +