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 @@ + + + + +Dieselbe Aufnahme, zwei Formate + + + +

Dieselbe Aufnahme, zwei Formate

+
3 Sekunden Snare-Hit mit Cymbal-Tail · 44,1 kHz Sample-Rate · Stereo
+ +
+ +
+
+ Lossless + FLAC +
+
verlustfrei · alle Frequenzen 0–22 kHz erhalten
+ + + + + + + + + + + + + +
+
Dateigröße
5,3 MB
+
Bitrate
1.411 kbit/s
+
+
+ +
+
+ Lossy + MP3 128 kbit/s +
+
verlustbehaftet · hohe Frequenzen weggeworfen, Transienten geglättet
+ + + + + + + + + + + + + +
+
Dateigröße
0,48 MB
+
Bitrate
128 kbit/s
+
+
+ +
+ +
+
Hört man den Unterschied?
+
Auf dem Smartphone-Lautsprecher: meist nicht. Im Studio-Monitor mit Kopfhörer: oft schon. — MP3 wirft 91 % der Daten weg, die der Mensch im Alltag nicht vermisst.
+
+ + diff --git a/slides/223015b/assets/demos/kap02-eroeffner.png b/slides/223015b/assets/demos/kap02-eroeffner.png new file mode 100644 index 0000000..1a37960 Binary files /dev/null and b/slides/223015b/assets/demos/kap02-eroeffner.png differ diff --git a/slides/223015b/assets/demos/kap03-eroeffner.html b/slides/223015b/assets/demos/kap03-eroeffner.html new file mode 100644 index 0000000..1f0bf24 --- /dev/null +++ b/slides/223015b/assets/demos/kap03-eroeffner.html @@ -0,0 +1,119 @@ + + + + +Drei Modalitäten, ein Hebel + + + +

Drei Modalitäten — derselbe Hebel

+
Bild, Audio, Video schrumpfen alle dramatisch. Warum? Weil Wahrnehmung Lücken hat.
+ +
+
+
Roh
+
Lossy (modern)
+
Lossy (aggressiv)
+ +
Bild12-MP-Foto
+
+
RAW
+
36 MB
+
+
+
+
JPEG · Q 90
+
4 MB
+
+
+
+
JPEG · Q 50
+
800 KB
+
+
+ +
Audio30 s Stereo
+
+
WAV · 44,1 kHz · 16 bit
+
5,3 MB
+
+
+
+
MP3 · 192 kbit/s
+
720 KB
+
+
+
+
MP3 · 64 kbit/s
+
240 KB
+
+
+ +
Video30 s · 4K · 30 fps
+
+
Roh · 8 bit
+
12 GB
+
+
+
+
H.264 · 25 Mbit/s
+
94 MB
+
+
+
+
H.265 · 12 Mbit/s
+
45 MB
+
+
+
+ +
+
Bilder schrumpfen ×45. Audio ×22. Video ×270.
+
Jede Reduktion nutzt eine andere Wahrnehmungs-Lücke: Bild die geringere Farbschärfe, Audio die Maskierung, Video die Frame-zu-Frame-Ähnlichkeit.
+
+ + diff --git a/slides/223015b/assets/demos/kap03-eroeffner.png b/slides/223015b/assets/demos/kap03-eroeffner.png new file mode 100644 index 0000000..a7e7cad Binary files /dev/null and b/slides/223015b/assets/demos/kap03-eroeffner.png differ