meta: add interactive draft URL

json/card_source.json

@@ -1,63 +1,284 @@
 {
-  "$schema": "../../../tools/card-layouts/schemas/card-source.schema.json", "schema": "esc-card-source.v1",
+  "$schema": "../../../tools/card-layouts/schemas/card-source.schema.json",
+  "schema": "esc-card-source.v1",
   "card": {
-    "id": "mpabi-freertos-cpp-13-event-group", "series": "freertos-cpp", "series_title": "FreeRTOS C++", "number": "13", "count": "16", "slug": "event-group",
+    "id": "mpabi-freertos-cpp-13-event-group",
-    "title": "EventGroup and Coordinated State", "topic": "Typed bit masks, any/all predicates, clear-on-exit and timeout snapshots", "project": "Freestanding C++ nad FreeRTOS", "subject": "Informatyka",
+    "series": "freertos-cpp",
-    "level": "Rok 2 · L12 · RV32I/Hazard3", "revision_date": "2026-07-19T00:00:00+02:00", "status": "Gotowa", "version": "v00.01",
+    "series_title": "FreeRTOS C++",
-    "uuid": "5fbcd7c6-3a73-4cd2-b76c-bdb016d1daaa", "author": "M. Pabiszczak", "year": "2026"
+    "number": "13",
+    "count": "16",
+    "slug": "event-group",
+    "title": "EventGroup and Coordinated State",
+    "topic": "Typed bit masks, any/all predicates, clear-on-exit and timeout snapshots",
+    "project": "Freestanding C++ nad FreeRTOS",
+    "subject": "Informatyka",
+    "level": "Rok 2 · L12 · RV32I/Hazard3",
+    "revision_date": "2026-07-19T00:00:00+02:00",
+    "status": "Gotowa",
+    "version": "v00.01",
+    "uuid": "5fbcd7c6-3a73-4cd2-b76c-bdb016d1daaa",
+    "author": "M. Pabiszczak",
+    "year": "2026"
+  },
+  "generated": {
+    "tex": "doc/generated/main.tex",
+    "html": "web/index.html",
+    "html_css": "web/style.css",
+    "html_tree_inspector": false,
+    "react_app": true
   },
-  "generated": {"tex": "doc/generated/main.tex", "html": "web/index.html", "html_css": "web/style.css", "html_tree_inspector": false, "react_app": true},
   "template": "templates/karta-klasyczna.json",
   "title_block": {
-    "category": "KARTA PRACY · INFORMATYKA", "prepared_by": "M. Pabiszczak", "prepared_on": "2026-07-19T00:00:00+02:00",
+    "category": "KARTA PRACY · INFORMATYKA",
-    "title": "EventGroup and Coordinated State", "repository_url": "https://zsl-gitea.mpabi.pl/edu-freertos-cpp/lab-rv32i-freertos-event-group",
+    "prepared_by": "M. Pabiszczak",
-    "revision": "v00.01", "issued_on": "2026-07-19T00:00:00+02:00", "series": "FREERTOS-CPP-13", "document_type": "karta pracy", "tool": "card-layouts",
+    "prepared_on": "2026-07-19T00:00:00+02:00",
-    "show_qr": false, "show_repository_qr": false, "height_cm": 2.6, "repeat_on_every_page": true, "replace_front_matter": true
+    "title": "EventGroup and Coordinated State",
+    "repository_url": "https://zsl-gitea.mpabi.pl/edu-freertos-cpp/lab-rv32i-freertos-event-group",
+    "revision": "v00.01",
+    "issued_on": "2026-07-19T00:00:00+02:00",
+    "series": "FREERTOS-CPP-13",
+    "document_type": "karta pracy",
+    "tool": "card-layouts",
+    "show_qr": false,
+    "show_repository_qr": false,
+    "height_cm": 2.6,
+    "repeat_on_every_page": true,
+    "replace_front_matter": true,
+    "url": "https://dce7fb9d-7b2f-5d49-96a2-3a30d3070b84.mpabi.pl/5fbcd7c6-3a73-4cd2-b76c-bdb016d1daaa"
   },
   "front_page_scope": {
-    "title": "Cel karty", "content_tex": "Uczeń modeluje skoordynowany stan trzema typowanymi bitami, wybiera predykat any/all oraz mierzy snapshot, clear-on-exit i timeout.",
+    "title": "Cel karty",
-    "scope_title": "Zakres karty", "scope_content_tex": "EventGroup przechowuje bity stanu, nie licznik zdarzeń ani payload. Wynik wait jest snapshotem i wymaga sprawdzenia wybranego predykatu."
+    "content_tex": "Uczeń modeluje skoordynowany stan trzema typowanymi bitami, wybiera predykat any/all oraz mierzy snapshot, clear-on-exit i timeout.",
+    "scope_title": "Zakres karty",
+    "scope_content_tex": "EventGroup przechowuje bity stanu, nie licznik zdarzeń ani payload. Wynik wait jest snapshotem i wymaga sprawdzenia wybranego predykatu."
+  },
+  "side_margin_tree_layout": {
+    "columns": [
+      {
+        "id": "zawodowe",
+        "label": "TECH",
+        "side": "left",
+        "tree": "WE -> EK -> KW",
+        "description": "Task states, bit transitions, timeout i clear policy."
+      },
+      {
+        "id": "ogolne",
+        "label": "OG",
+        "side": "right",
+        "tree": "WE -> EN -> KW",
+        "description": "State versus count/payload oraz any/all semantics."
+      }
+    ]
   },
-  "side_margin_tree_layout": {"columns": [
-    {"id": "zawodowe", "label": "TECH", "side": "left", "tree": "WE -> EK -> KW", "description": "Task states, bit transitions, timeout i clear policy."},
-    {"id": "ogolne", "label": "OG", "side": "right", "tree": "WE -> EN -> KW", "description": "State versus count/payload oraz any/all semantics."}
-  ]},
   "learning_effects": {
-    "K13.EN01": {"bloom_level": "Analiza", "label": "Semantyka bitów", "text": "Uczeń odróżnia bit stanu od licznika i payloadu oraz analizuje race przy clear-on-exit.", "assessment_criteria": ["K13.KW01"]},
+    "K13.EN01": {
-    "K13.EK01": {"bloom_level": "Zastosowanie", "label": "Koordynacja any/all", "text": "Uczeń buduje typed mask, mierzy wait all/any, snapshot timeoutu i jawne czyszczenie bitów.", "assessment_criteria": ["K13.KW01"]}
+      "bloom_level": "Analiza",
+      "label": "Semantyka bitów",
+      "text": "Uczeń odróżnia bit stanu od licznika i payloadu oraz analizuje race przy clear-on-exit.",
+      "assessment_criteria": [
+        "K13.KW01"
+      ]
+    },
+    "K13.EK01": {
+      "bloom_level": "Zastosowanie",
+      "label": "Koordynacja any/all",
+      "text": "Uczeń buduje typed mask, mierzy wait all/any, snapshot timeoutu i jawne czyszczenie bitów.",
+      "assessment_criteria": [
+        "K13.KW01"
+      ]
+    }
   },
   "assessment_criteria": {
-    "K13.KW01": {"text": "Program kończy się PASS; maska all=0x7, repeated UART=0x1, clear GPIO daje 0x7->0x5, timeout 3 zwraca snapshot 0x5/false, a any clear kończy maską 0x0 bez zmiany heapu.", "learning_effects": ["K13.EN01", "K13.EK01"]}
+    "K13.KW01": {
+      "text": "Program kończy się PASS; maska all=0x7, repeated UART=0x1, clear GPIO daje 0x7->0x5, timeout 3 zwraca snapshot 0x5/false, a any clear kończy maską 0x0 bez zmiany heapu.",
+      "learning_effects": [
+        "K13.EN01",
+        "K13.EK01"
+      ]
+    }
   },
   "educational_requirements": {
     "K13.WE01": {
-      "text": "Implementacja i pomiar EventGroup jako współdzielonego bitowego stanu.", "label": "EventGroup i koordynacja", "learning_effects": ["K13.EN01", "K13.EK01"],
+      "text": "Implementacja i pomiar EventGroup jako współdzielonego bitowego stanu.",
+      "label": "EventGroup i koordynacja",
+      "learning_effects": [
+        "K13.EN01",
+        "K13.EK01"
+      ],
       "learning_tree": {
-        "schema": "we-learning-tree.v1", "policy": "Każdy wait ma jawną maskę, predykat any/all, politykę clear oraz timeout.",
+        "schema": "we-learning-tree.v1",
-        "ogolne": [{"effect_ref": "K13.EN01", "display": "EN LOCAL RTOS.EVENT.01", "source": "LOCAL", "official": "RTOS.EVENT", "local": "01", "kind": "EN", "tree_id": "K13.WE01.OG.LOCAL.RTOS.EVENT.01", "text": "Analizuje stan bitowy, utratę informacji i granice EventGroup.", "kw": [{"criterion_ref": "K13.KW01", "display": "KW LOCAL RTOS.EVENT.01", "source": "LOCAL", "kind": "KW", "official": "RTOS.EVENT", "local": "01", "text": "Nie używa bitów jako licznika ani payloadu i uzasadnia race clear-on-exit."}]}],
+        "policy": "Każdy wait ma jawną maskę, predykat any/all, politykę clear oraz timeout.",
-        "zawodowe": [{"effect_ref": "K13.EK01", "display": "EK LOCAL DBG.EVENT.01", "source": "LOCAL", "official": "DBG.EVENT", "local": "01", "kind": "EK", "tree_id": "K13.WE01.TECH.LOCAL.DBG.EVENT.01", "text": "Mierzy transitions, task blocking, snapshots i timeout ticks.", "kw": [{"criterion_ref": "K13.KW01", "display": "KW LOCAL DBG.EVENT.01", "source": "LOCAL", "kind": "KW", "official": "DBG.EVENT", "local": "01", "text": "Pokazuje 0x7, 0x5, timeout false, final 0x0 i PASS."}]}]
+        "ogolne": [
+          {
+            "effect_ref": "K13.EN01",
+            "display": "EN LOCAL RTOS.EVENT.01",
+            "source": "LOCAL",
+            "official": "RTOS.EVENT",
+            "local": "01",
+            "kind": "EN",
+            "tree_id": "K13.WE01.OG.LOCAL.RTOS.EVENT.01",
+            "text": "Analizuje stan bitowy, utratę informacji i granice EventGroup.",
+            "kw": [
+              {
+                "criterion_ref": "K13.KW01",
+                "display": "KW LOCAL RTOS.EVENT.01",
+                "source": "LOCAL",
+                "kind": "KW",
+                "official": "RTOS.EVENT",
+                "local": "01",
+                "text": "Nie używa bitów jako licznika ani payloadu i uzasadnia race clear-on-exit."
+              }
+            ]
+          }
+        ],
+        "zawodowe": [
+          {
+            "effect_ref": "K13.EK01",
+            "display": "EK LOCAL DBG.EVENT.01",
+            "source": "LOCAL",
+            "official": "DBG.EVENT",
+            "local": "01",
+            "kind": "EK",
+            "tree_id": "K13.WE01.TECH.LOCAL.DBG.EVENT.01",
+            "text": "Mierzy transitions, task blocking, snapshots i timeout ticks.",
+            "kw": [
+              {
+                "criterion_ref": "K13.KW01",
+                "display": "KW LOCAL DBG.EVENT.01",
+                "source": "LOCAL",
+                "kind": "KW",
+                "official": "DBG.EVENT",
+                "local": "01",
+                "text": "Pokazuje 0x7, 0x5, timeout false, final 0x0 i PASS."
+              }
+            ]
+          }
+        ]
       }
     }
   },
   "sections": [
-    {"title": "Typed masks i wait all", "content_kind": "prose", "content_tex": "Zbuduj maskę UART/GPIO/APP, zablokuj coordinator, opublikuj trzy stany i zachowaj maskę po wait all.", "educational_requirement_refs": ["K13.WE01"], "learning_effect_refs": ["K13.EK01"], "assessment_criterion_refs": ["K13.KW01"], "area_tree_refs": ["K13.WE01.TECH.LOCAL.DBG.EVENT.01"], "steps": [
+    {
-      {"id": "S01", "title": "Potwierdź Blocked oraz set 1, 2 i 4.", "tree_refs": ["K13.WE01.TECH.LOCAL.DBG.EVENT.01"]},
+      "title": "Typed masks i wait all",
-      {"id": "S02", "title": "Zapisz all snapshot i current 0x7.", "tree_refs": ["K13.WE01.TECH.LOCAL.DBG.EVENT.01"]}
+      "content_kind": "prose",
-    ]},
+      "content_tex": "Zbuduj maskę UART/GPIO/APP, zablokuj coordinator, opublikuj trzy stany i zachowaj maskę po wait all.",
-    {"title": "Clear, timeout i wait any", "content_kind": "prose", "content_tex": "Usuń GPIO, zmierz timeout all z częściową maską, a następnie skonsumuj UART i APP przez any/clear-on-exit.", "educational_requirement_refs": ["K13.WE01"], "learning_effect_refs": ["K13.EK01"], "assessment_criterion_refs": ["K13.KW01"], "area_tree_refs": ["K13.WE01.TECH.LOCAL.DBG.EVENT.01"], "steps": [
+      "educational_requirement_refs": [
-      {"id": "S03", "title": "Pokaż transition 0x7 do 0x5.", "tree_refs": ["K13.WE01.TECH.LOCAL.DBG.EVENT.01"]},
+        "K13.WE01"
-      {"id": "S04", "title": "Zmierz timeout 3 i final mask 0x0.", "tree_refs": ["K13.WE01.TECH.LOCAL.DBG.EVENT.01"]}
-    ]},
-    {"title": "Stan, licznik i race", "content_kind": "prose", "content_tex": "Wyjaśnij, dlaczego repeated set pozostaje 0x1, dlaczego result!=0 nie dowodzi wait all i jak clear-on-exit wpływa na drugiego waitera.", "educational_requirement_refs": ["K13.WE01"], "learning_effect_refs": ["K13.EN01"], "assessment_criterion_refs": ["K13.KW01"], "area_tree_refs": ["K13.WE01.OG.LOCAL.RTOS.EVENT.01"], "steps": [
-      {"id": "S05", "title": "Dobierz queue/counter dla wielokrotnych zdarzeń.", "tree_refs": ["K13.WE01.OG.LOCAL.RTOS.EVENT.01"]},
-      {"id": "S06", "title": "Przeanalizuj dwóch waiterów z clear-on-exit.", "tree_refs": ["K13.WE01.OG.LOCAL.RTOS.EVENT.01"]}
-    ]}
       ],
-  "tasks": {"task01": {
+      "learning_effect_refs": [
-    "title": "Typed EventGroup i trzy źródła stanu", "uuid": "5fbcd7c6-3a73-4cd2-b76c-bdb016d1daaa",
+        "K13.EK01"
+      ],
+      "assessment_criterion_refs": [
+        "K13.KW01"
+      ],
+      "area_tree_refs": [
+        "K13.WE01.TECH.LOCAL.DBG.EVENT.01"
+      ],
+      "steps": [
+        {
+          "id": "S01",
+          "title": "Potwierdź Blocked oraz set 1, 2 i 4.",
+          "tree_refs": [
+            "K13.WE01.TECH.LOCAL.DBG.EVENT.01"
+          ]
+        },
+        {
+          "id": "S02",
+          "title": "Zapisz all snapshot i current 0x7.",
+          "tree_refs": [
+            "K13.WE01.TECH.LOCAL.DBG.EVENT.01"
+          ]
+        }
+      ]
+    },
+    {
+      "title": "Clear, timeout i wait any",
+      "content_kind": "prose",
+      "content_tex": "Usuń GPIO, zmierz timeout all z częściową maską, a następnie skonsumuj UART i APP przez any/clear-on-exit.",
+      "educational_requirement_refs": [
+        "K13.WE01"
+      ],
+      "learning_effect_refs": [
+        "K13.EK01"
+      ],
+      "assessment_criterion_refs": [
+        "K13.KW01"
+      ],
+      "area_tree_refs": [
+        "K13.WE01.TECH.LOCAL.DBG.EVENT.01"
+      ],
+      "steps": [
+        {
+          "id": "S03",
+          "title": "Pokaż transition 0x7 do 0x5.",
+          "tree_refs": [
+            "K13.WE01.TECH.LOCAL.DBG.EVENT.01"
+          ]
+        },
+        {
+          "id": "S04",
+          "title": "Zmierz timeout 3 i final mask 0x0.",
+          "tree_refs": [
+            "K13.WE01.TECH.LOCAL.DBG.EVENT.01"
+          ]
+        }
+      ]
+    },
+    {
+      "title": "Stan, licznik i race",
+      "content_kind": "prose",
+      "content_tex": "Wyjaśnij, dlaczego repeated set pozostaje 0x1, dlaczego result!=0 nie dowodzi wait all i jak clear-on-exit wpływa na drugiego waitera.",
+      "educational_requirement_refs": [
+        "K13.WE01"
+      ],
+      "learning_effect_refs": [
+        "K13.EN01"
+      ],
+      "assessment_criterion_refs": [
+        "K13.KW01"
+      ],
+      "area_tree_refs": [
+        "K13.WE01.OG.LOCAL.RTOS.EVENT.01"
+      ],
+      "steps": [
+        {
+          "id": "S05",
+          "title": "Dobierz queue/counter dla wielokrotnych zdarzeń.",
+          "tree_refs": [
+            "K13.WE01.OG.LOCAL.RTOS.EVENT.01"
+          ]
+        },
+        {
+          "id": "S06",
+          "title": "Przeanalizuj dwóch waiterów z clear-on-exit.",
+          "tree_refs": [
+            "K13.WE01.OG.LOCAL.RTOS.EVENT.01"
+          ]
+        }
+      ]
+    }
+  ],
+  "tasks": {
+    "task01": {
+      "title": "Typed EventGroup i trzy źródła stanu",
+      "uuid": "5fbcd7c6-3a73-4cd2-b76c-bdb016d1daaa",
       "prompt_tex": "Skoordynuj UART/GPIO/APP przez typed mask, wait all/any, keep/clear-on-exit oraz timeout snapshot i udowodnij granicę state versus count.",
       "criterion": "All 0x7; repeated 0x1; clear 0x7->0x5; timeout 3/snapshot 0x5/false; any snapshot 0x5/final 0; heap delta 0; pass=1.",
-    "educational_requirement_refs": ["K13.WE01"], "learning_effect_refs": ["K13.EN01", "K13.EK01"], "assessment_criterion_ref": "K13.KW01", "links": {"equations": [], "figures": []}
+      "educational_requirement_refs": [
-  }},
+        "K13.WE01"
-  "tasks_order": ["task01"]
+      ],
+      "learning_effect_refs": [
+        "K13.EN01",
+        "K13.EK01"
+      ],
+      "assessment_criterion_ref": "K13.KW01",
+      "links": {
+        "equations": [],
+        "figures": []
+      }
+    }
+  },
+  "tasks_order": [
+    "task01"
+  ]
 }