Add shared card schemas layouts and renderer

2026-07-15 08:41:20 +02:00
commit 65299458ed
19 changed files with 7786 additions and 0 deletions
@@ -0,0 +1,27 @@
+# Seria demo
+
+Minimalna seria pokazująca, jak opisywać kolejność kart niezależnie od ich
+layoutu i generatora.
+
+## Rezultat ścieżki
+
+Po przejściu serii uczeń potrafi wygenerować kartę z JSON, odczytać marginesy
+efektów nauczania oraz wykonać kroki zakończone jednoznacznym `PASS`.
+
+## Mapa
+
+| Karta | Temat | Rezultat | Stan |
+|---:|---|---|---|
+| 01 | źródło JSON i layout 5b | TeX, HTML i PDF z jednego źródła | gotowa |
+| 02 | własna karta | poprawny model WE → EN/EK → KW | planowana |
+
+## Kontrakt wspólny
+
+Każda karta:
+
+- posiada `json/card_source.json` zgodny ze schematem;
+- generuje TeX i HTML tym samym narzędziem;
+- ma jawne kroki oraz kryterium `PASS`;
+- nie wymaga ręcznej edycji artefaktów wygenerowanych.
+
+Maszynowym opisem tej kolejności jest `series.json`.