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`.
@@ -0,0 +1,41 @@
+{
+  "$schema": "../../schemas/series.schema.json",
+  "version": 1,
+  "series": "demo",
+  "org": "edu-demo",
+  "title": "Demonstracja generatora kart",
+  "default_branch": "deploy",
+  "cards": [
+    {
+      "id": "01",
+      "repo": "lab-demo-card-layout",
+      "branch": "deploy",
+      "title": "demo / pierwszy krok",
+      "summary": "Jedno źródło JSON generujące TeX i HTML z marginesami efektów nauczania.",
+      "kind": "lab",
+      "status": "example",
+      "area": "demo",
+      "card_series": "demo",
+      "card_number": "01",
+      "card_count": "02",
+      "slug": "pierwszy-krok",
+      "version": "v0.1",
+      "document_uuid": "00000000-0000-4000-8000-000000000001",
+      "pdf": "doc/pdf/demo-01-pierwszy-krok-v0.1.pdf",
+      "build": {
+        "driver": "make",
+        "all_target": "check",
+        "clean_target": "clean"
+      },
+      "tasks": [
+        {
+          "id": "task01",
+          "title": "Wygeneruj oba formaty",
+          "target": "render",
+          "source": "json/card_source.json",
+          "build_dir": "build"
+        }
+      ]
+    }
+  ]
+}