docs(marketplace): grade_levels + Kategorie-Cleanup live (Status §5/§8)
Some checks are pending
CI / validate (push) Waiting to run

Migration 0006+0007 + API/Web deployed auf prod 2026-05-25:
history 23→3, +19 geography +1 civics, grade_levels-Filter live.
Deploy-Notiz: .env.production fehlte auf mana-server, aus Container
rekonstruiert; --no-deps Pflicht, kein --remove-orphans (Landing).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Till JS 2026-05-25 16:49:29 +02:00
parent 236666bac2
commit cbeb6181b3

View file

@ -138,24 +138,21 @@ bzw. `mana-compliance`-Lauf.
## 5. Begleitspur — Bestand konsolidieren (klein, parallel)
Nicht als Phase-2-Priorität gewählt, aber billig und hebt die
Auffindbarkeit der neuen Decks mit. Reihenfolge nach Aufwand:
**✅ Großteils erledigt + live 2026-05-25** (Migration 0006+0007 +
API/Web, deployed). Reihenfolge nach Aufwand:
1. **Kategorie-Korrektur.** Live-Audit zeigt falsche `category`-Werte
(z.B. `geografie-welt-top30``history`, diverse Bodensee-Decks →
`history`). Einmaliger SQL-Pass gegen `marketplace.decks.category`.
2. **`geography`-Kategorie fehlt im Enum.** Aktuell:
`language|medicine|science|math|history|law|technology|arts|music|sport|other`.
Geografie-Decks haben keinen sauberen Bucket → Schema-Erweiterung um
`geography` (und ggf. `civics` für Spur C) erwägen.
3. **Grade-Level-Tagging** (CONTENT_PLAN §12, offener Punkt): Feld
`marketplace.decks.grade_levels text[]` für Discovery-Filter
„Sek 1 / Sek 2 / Erwachsene". Phase-2-Decks würden sofort davon
profitieren — sonst stehen A- und C-Decks ununterscheidbar neben den
Sek-1-Decks.
4. **Dubletten:** `geografie-welt-top30` (30 Karten, alt) vs.
`geografie-welt-hauptstaedte` (197, Phase-1-Kanon) — entweder
top30 als „Einsteiger-Teilmenge" framen oder takedownen.
1. ✅ **Kategorie-Korrektur live.** Migration 0007: `geografie-*` +
Orts-/Bodensee-Decks (19) `history → geography`, Factfulness →
`civics`. `history` jetzt nur noch die 3 echten Geschichts-Decks.
2. ✅ **`geography` + `civics` im Enum** (Schema + `@wordeck/domain` +
Web-Icons/Farben: MapPin / BookOpen).
3. ✅ **Grade-Level-Tagging live.** Feld `marketplace.decks.grade_levels
text[]` (Migration 0006), Werte `zyklus2|sek1|sek2|erwachsene`.
API: create/patch + browse-`?grade=`-Filter; Web: Schulstufen-Filter
auf `/explore` + Badge auf Karten. Backfill via 0007 + PATCH (Spanisch A1).
4. ⬜ **Dubletten (offen):** `geografie-welt-top30` (30, alt) vs.
`geografie-welt-hauptstaedte` (197, Kanon) — beide jetzt `geography`;
top30 als „Einsteiger-Teilmenge" framen oder takedownen. Noch offen.
## 6. Sequenzierung — empfohlene Wellen
@ -194,12 +191,15 @@ Die 🛑-Decks (C1/C2/C3/C8) erst nach `mana-mission-check` /
## 8. Offene Punkte
- **`geography`/`civics`-Kategorie:** vor Welle 2.3 entscheiden, sonst
landen C2/C3 unter `history` und die Geografie-Begleitspur bleibt
unsauber (§5.2).
- **Grade-Level-Schema:** ohne das Feld werden Sek-1- und Sek-2-Decks
in der Discovery vermischt — der ganze Sinn von Spur A (eine Stufe
höher) verpufft im UI. Sollte idealerweise **vor** Welle 2.1 stehen.
- ✅ **`geography`/`civics`-Kategorie** umgesetzt + live (2026-05-25).
- ✅ **Grade-Level-Schema** umgesetzt + live (2026-05-25, `grade_levels`
+ `?grade=`-Filter + Explore-UI). Neue Decks: `gradeLevels` beim
Publish/PATCH mitsetzen (alte prod-API hat es ignoriert → Backfill
via PATCH nötig, wie bei Spanisch A1 geschehen).
- **Infra-Notiz Deploy:** `infrastructure/.env.production` fehlte auf
mana-server (nur `.example`); am 2026-05-25 aus dem laufenden Container
rekonstruiert (chmod 600). Tills lokale Server-Edits an Landing/STATUS/
pnpm-lock liegen in `git stash@{0}` (review/pop offen).
- **Spanisch-Quelle:** für `target=es` brauchen wir eine belastbare
Frequenzliste (analog zu den EN/FR-Decks) — RAE-Korpus oder
Routledge-Frequency-Dictionary prüfen (Lizenz!).