{
  "$schema": "../../../schemas/card-source.schema.json",
  "schema": "esc-card-source.v1",
  "card": {
    "id": "demo-01",
    "series": "demo",
    "number": "01",
    "count": "02",
    "slug": "pierwszy-krok",
    "title": "DEMO-01: Jedno źródło, dwa formaty",
    "topic": "Generowanie TeX i HTML z mapą efektów nauczania",
    "project": "System kart pracy",
    "subject": "Zajęcia projektowe",
    "level": "przykład techniczny",
    "dominant": "informatyka i kompetencje techniczne",
    "revision_date": "15.07.2026",
    "status": "Przykład",
    "version": "v0.1",
    "uuid": "00000000-0000-4000-8000-000000000001",
    "author": "Zespół edukacyjny",
    "year": "2026"
  },
  "generated": {
    "tex": "build/tex/main.tex",
    "html": "build/html/index.html",
    "html_css": "build/html/style.css"
  },
  "template": "templates/karta-5b.json",
  "front_page_break": false,
  "metric_fill_fields": [
    {
      "label": "Uczeń",
      "kind": "fill_in_line"
    },
    {
      "label": "Klasa · data",
      "kind": "fill_in_line"
    }
  ],
  "side_margin_tree_layout": {
    "columns": [
      {
        "id": "zawodowe",
        "label": "TECH",
        "side": "left",
        "tree": "WE -> EK -> KW",
        "description": "Efekty techniczne po lewej stronie."
      },
      {
        "id": "ogolne",
        "label": "OG",
        "side": "right",
        "tree": "WE -> EN -> KW",
        "description": "Efekty ogólne po prawej stronie."
      }
    ]
  },
  "learning_effects": {
    "DEMO.EN01": {
      "bloom_level": "Zastosowanie",
      "label": "Generowanie",
      "text": "Uczeń generuje TeX i HTML z jednego pliku JSON.",
      "assessment_criteria": [
        "DEMO.KW01"
      ]
    },
    "DEMO.EK01": {
      "bloom_level": "Analiza",
      "label": "Spójność",
      "text": "Uczeń rozpoznaje wspólny model danych i layoutu.",
      "assessment_criteria": [
        "DEMO.KW01"
      ]
    }
  },
  "assessment_criteria": {
    "DEMO.KW01": {
      "text": "Generator kończy pracę kodem 0, a oba wyjścia zawierają tytuł, kroki i drzewka marginesowe.",
      "learning_effects": [
        "DEMO.EN01",
        "DEMO.EK01"
      ]
    }
  },
  "educational_requirements": {
    "DEMO.WE01": {
      "text": "Wygenerowanie spójnej karty pracy z jednego źródła.",
      "label": "Jedno źródło",
      "learning_effects": [
        "DEMO.EN01",
        "DEMO.EK01"
      ],
      "learning_tree": {
        "schema": "we-learning-tree.v1",
        "policy": "Każdy efekt ma co najmniej jedno mierzalne kryterium.",
        "ogolne": [
          {
            "effect_ref": "DEMO.EN01",
            "display": "EN IP WO 01.01.01",
            "source": "IP",
            "official": "01.01",
            "local": "01",
            "text": "Uczeń generuje TeX i HTML z jednego pliku JSON.",
            "kind": "WO",
            "tree_id": "DEMO.WE01.OG.IP.01.01.01",
            "kw": [
              {
                "criterion_ref": "DEMO.KW01",
                "display": "KW IP WS 01.01.01",
                "source": "IP",
                "kind": "WS",
                "official": "01.01",
                "local": "01",
                "text": "Oba artefakty zawierają te same metadane i kroki."
              }
            ]
          }
        ],
        "zawodowe": [
          {
            "effect_ref": "DEMO.EK01",
            "display": "EK INF04 01.01.01",
            "source": "I4",
            "official": "01.01",
            "local": "01",
            "text": "Uczeń rozpoznaje wspólny model danych i layoutu.",
            "kind": "EK",
            "tree_id": "DEMO.WE01.TECH.I4.01.01.01",
            "kw": [
              {
                "criterion_ref": "DEMO.KW01",
                "display": "KW INF04 01.01.01.01",
                "source": "I4",
                "kind": "KW",
                "official": "01.01.01",
                "local": "01",
                "text": "Uczeń wskazuje źródło treści, layout i oba artefakty."
              }
            ]
          }
        ]
      }
    }
  },
  "sections": [
    {
      "title": "Uruchomienie generatora",
      "content_kind": "prose",
      "content_tex": "Jedno źródło JSON jest renderowane do dwóch formatów.",
      "educational_requirement_refs": [
        "DEMO.WE01"
      ],
      "learning_effect_refs": [
        "DEMO.EN01",
        "DEMO.EK01"
      ],
      "assessment_criterion_refs": [
        "DEMO.KW01"
      ],
      "area_tree_refs": [
        "DEMO.WE01.OG.IP.01.01.01",
        "DEMO.WE01.TECH.I4.01.01.01"
      ],
      "steps": [
        {
          "id": "K1",
          "title": "Otwórz card_source.json i odczytaj metadane.",
          "tree_refs": [
            "DEMO.WE01.OG.IP.01.01.01",
            "DEMO.WE01.TECH.I4.01.01.01"
          ],
          "educational_requirement_refs": [
            "DEMO.WE01"
          ],
          "learning_effect_refs": [
            "DEMO.EN01",
            "DEMO.EK01"
          ],
          "assessment_criterion_refs": [
            "DEMO.KW01"
          ]
        },
        {
          "id": "K2",
          "title": "Uruchom generator i sprawdź oba wyjścia.",
          "tree_refs": [
            "DEMO.WE01.OG.IP.01.01.01",
            "DEMO.WE01.TECH.I4.01.01.01"
          ],
          "educational_requirement_refs": [
            "DEMO.WE01"
          ],
          "learning_effect_refs": [
            "DEMO.EN01",
            "DEMO.EK01"
          ],
          "assessment_criterion_refs": [
            "DEMO.KW01"
          ]
        }
      ]
    }
  ],
  "tasks": {
    "task01": {
      "prompt_tex": "Wygeneruj TeX i HTML oraz porównaj tytuł i identyfikatory efektów.",
      "criterion": "Oba pliki istnieją i pochodzą z tego samego źródła.",
      "educational_requirement_refs": [
        "DEMO.WE01"
      ],
      "learning_effect_refs": [
        "DEMO.EN01",
        "DEMO.EK01"
      ],
      "assessment_criterion_ref": "DEMO.KW01",
      "links": {
        "equations": [],
        "figures": []
      }
    }
  },
  "tasks_order": [
    "task01"
  ],
  "mission": "Wygeneruj kartę pracy do TeX i HTML z jednego źródła, a następnie potwierdź, że oba formaty pokazują tę samą mapę efektów i te same kroki.",
  "objectives": [
    "Rozpoznasz rozdzielenie treści, layoutu i manifestu serii.",
    "Wygenerujesz TeX i HTML jednym poleceniem.",
    "Powiążesz krok z wymaganiem, efektem i kryterium."
  ],
  "objective_refs": [
    {
      "tech": "01",
      "og": "01"
    },
    {
      "tech": "01",
      "og": "01"
    },
    {
      "tech": "01",
      "og": "01"
    }
  ],
  "agenda": [
    {
      "time": "0--5 min",
      "work": "Odczyt źródła i drzewek edukacyjnych."
    },
    {
      "time": "5--10 min",
      "work": "Generowanie TeX i HTML."
    },
    {
      "time": "10--15 min",
      "work": "Porównanie rezultatów i zapis PASS."
    }
  ],
  "hw_gate": {
    "title": "Bramka wejścia",
    "criteria": [
      {
        "check": "Python 3 jest dostępny.",
        "evidence": "python3 --version"
      },
      {
        "check": "Źródło JSON jest poprawne składniowo.",
        "evidence": "python3 -m json.tool json/card_source.json"
      }
    ]
  },
  "tech_stack": {
    "software": [
      {
        "name": "Python",
        "use": "walidacja i generowanie"
      },
      {
        "name": "LaTeX",
        "use": "skład PDF"
      },
      {
        "name": "HTML/CSS",
        "use": "wersja ekranowa i druk z przeglądarki"
      }
    ],
    "hardware": [
      {
        "name": "Komputer",
        "use": "uruchomienie przykładu"
      }
    ]
  },
  "theory_refs": {
    "intro": "Treść i layout są osobnymi warstwami. Identyfikatory WE, EN/EK i KW tworzą graf powiązań, który renderer umieszcza na marginesach.",
    "known_refs": [],
    "new_concepts": [
      {
        "term": "źródło prawdy",
        "definition": "Plik, z którego odtwarzamy wszystkie artefakty bez ręcznych poprawek."
      },
      {
        "term": "layout",
        "definition": "Kontrakt geometrii, komponentów i emiterów niezależny od treści karty."
      }
    ]
  },
  "math_block": {
    "title": "Kontrola liczby wyjść",
    "tasks": [
      {
        "prompt": "Policz formaty generowane z jednego źródła.",
        "equation_tex": "N_{wyjsc} = N_{TeX} + N_{HTML} = 1 + 1 = 2",
        "answer_hint": "Dwa formaty, jedno źródło."
      }
    ]
  },
  "parts": {
    "a": {
      "title": "CZĘŚĆ A -- model",
      "body": "Sprawdź identyfikatory i zależności przed generowaniem."
    },
    "b": {
      "title": "CZĘŚĆ B -- weryfikacja",
      "body": "Porównaj TeX, HTML i wynik PDF."
    }
  },
  "model_block": {
    "title": "Model danych",
    "notebook": "nie dotyczy",
    "output_constants": "json/card_source.json",
    "steps": [
      "Odczytaj metadane karty.",
      "Przejdź po relacji WE -> EN/EK -> KW.",
      "Sprawdź tree_refs dla każdego kroku."
    ],
    "constants": [
      {
        "name": "SOURCE_COUNT",
        "value": "1"
      },
      {
        "name": "OUTPUT_COUNT",
        "value": "2"
      }
    ]
  },
  "code_block": {
    "title": "Do wykonania: render przykładu",
    "context": "Pracujemy wyłącznie na plikach przykładowych w tym repozytorium.",
    "blocks": [
      {
        "title": "Bloczek 1 -- GENERATOR",
        "slug": "generator",
        "goal": "Wytworzyć oba formaty i sprawdzić ich spójność.",
        "context": "Kroki są zapisywane w JSON i emitowane do interaktywnego HTML.",
        "web_steps": [
          "Uruchom make render-example.",
          "Otwórz build/html/index.html.",
          "Sprawdź build/tex/main.tex.",
          "Potwierdź obecność TECH, OG i kroku K2."
        ],
        "web_commands": [
          {
            "label": "Render",
            "command": "make render-example"
          },
          {
            "label": "Kontrola",
            "command": "make check"
          }
        ],
        "web_files": [
          "json/card_source.json",
          "build/tex/main.tex",
          "build/html/index.html"
        ],
        "web_evidence": [
          "Polecenie kończy się kodem 0.",
          "Oba wyjścia zawierają tytuł karty."
        ],
        "web_safety": [
          "Nie edytuj ręcznie plików w build/."
        ],
        "columns": [
          {
            "title": "Artefakty",
            "items": [
              "build/tex/main.tex",
              "build/html/index.html",
              "build/html/style.css"
            ]
          },
          {
            "title": "Procedura",
            "items": [
              "render",
              "kontrola marginesów",
              "kontrola kroków"
            ]
          },
          {
            "title": "Uczeń oddaje",
            "items": [
              "wynik PASS",
              "krótkie porównanie obu formatów"
            ]
          }
        ],
        "pass_condition": "TeX i HTML istnieją oraz zawierają te same metadane."
      }
    ]
  },
  "container_test": {
    "title": "Test bez sprzętu",
    "commands": [
      "make render-example",
      "make check"
    ],
    "pass_condition": "Wszystkie kontrole kończą się kodem 0."
  },
  "bom": [
    {
      "item": "Python 3",
      "check": "Interpreter dostępny."
    },
    {
      "item": "latexmk",
      "check": "Wymagany tylko dla PDF."
    }
  ],
  "safety_rules": [
    {
      "title": "Jedno źródło",
      "body": "Nie poprawiaj osobno TeX i HTML; popraw card_source.json lub layout."
    },
    {
      "title": "Stabilne identyfikatory",
      "body": "Nie zmieniaj tree_id po opublikowaniu karty bez migracji odwołań."
    }
  ],
  "reference_settings": [
    {
      "test": "layout",
      "dps": "karta-5b",
      "xy": "TeX + HTML"
    }
  ],
  "figures": [],
  "connection_section": {
    "title": "Przepływ danych: JSON -> renderer -> TeX/HTML",
    "intro": "Źródło treści i layout są wczytywane osobno, a następnie przekazywane do dwóch emiterów.",
    "pin_table": [
      {
        "rp2350": "card_source.json",
        "isolator_a": "walidacja",
        "isolator_b": "emiter",
        "xy": "main.tex / index.html"
      }
    ],
    "parameters": [
      "Treść jest niezależna od geometrii.",
      "Oba emitery korzystają z przygotowanego modelu danych."
    ],
    "warnings": [
      "Ręczna zmiana artefaktu znika przy kolejnym generowaniu."
    ],
    "source_note": "Repozytorium card-layouts jest źródłem generatora, schematów i layoutów."
  },
  "hardware_procedure": [
    {
      "step": "1",
      "action": "Uruchom make render-example.",
      "condition": "Generator zwraca kod 0."
    },
    {
      "step": "2",
      "action": "Otwórz HTML i sprawdź marginesy TECH/OG oraz kroki.",
      "condition": "Widoczne są oba drzewka i lista kroków."
    },
    {
      "step": "3",
      "action": "Złóż PDF poleceniem make pdf-example.",
      "condition": "Powstaje main.pdf bez błędu LaTeX."
    }
  ],
  "observation_table": {
    "title": "Karta kontroli artefaktów",
    "columns": [
      "Artefakt",
      "Oczekiwany element",
      "Wynik"
    ],
    "rows": [
      {
        "cells": [
          "HTML",
          "tytuł, TECH, OG, kroki",
          ""
        ]
      },
      {
        "cells": [
          "TeX/PDF",
          "tytuł, TECH, OG, procedura",
          ""
        ]
      }
    ]
  },
  "troubleshooting": [
    {
      "symptom": "Brak layoutu",
      "hypothesis": "Błędna ścieżka template.",
      "action": "Sprawdź pole template i katalog templates/.",
      "result": ""
    },
    {
      "symptom": "Błąd tree_ref",
      "hypothesis": "Krok wskazuje nieistniejące drzewko.",
      "action": "Porównaj tree_refs z educational_requirements.*.learning_tree.",
      "result": ""
    }
  ],
  "analysis_tasks": [
    "Wyjaśnij, dlaczego treść i layout są osobnymi plikami.",
    "Wskaż relację między DEMO.WE01, DEMO.EN01 i DEMO.KW01.",
    "Porównaj elementy obecne w TeX i HTML."
  ],
  "team_decision": {
    "title": "Decyzja zespołu",
    "questions": [
      "Który layout wybieramy?",
      "Jakie były alternatywy?",
      "Jak potwierdziliśmy oba formaty?",
      "Który commit dokumentuje decyzję?"
    ]
  },
  "git_gate": {
    "title": "Brama wyjścia",
    "criteria": [
      {
        "criterion": "JSON przechodzi walidację generatora.",
        "evidence": "make check"
      },
      {
        "criterion": "TeX i HTML zostały wygenerowane.",
        "evidence": "examples/card/build/"
      },
      {
        "criterion": "PDF składa się bez błędu.",
        "evidence": "main.pdf"
      }
    ]
  },
  "session_record": {
    "title": "Rekord pracy",
    "files": [
      {
        "path": "README.md",
        "purpose": "opis wyniku i poleceń"
      }
    ],
    "timeline_sources": [
      "git log --oneline",
      "wynik make check"
    ]
  },
  "ai_rules": {
    "allowed": [
      "wyjaśnienie błędu walidacji",
      "review spójności identyfikatorów"
    ],
    "forbidden": [
      "fabrykowanie wyniku PASS",
      "ręczna poprawa wygenerowanego pliku zamiast źródła"
    ],
    "student_owns": [
      "treść kroków",
      "mapowanie efektów",
      "wynik kontroli"
    ],
    "log_path": "ai-log.md"
  },
  "references": []
}