Publikusan kiszolgálandó jogi dokumentumok forrása, projektenkénti almappákba szervezve, hogy egy repóból több H2W-projekt jogi tartalmát is le lehessen kezelni.

Struktúra

<projekt-mappa>/
  aszf.md
  adatkezelesi-tajekoztato.md
  adatfeldolgozoi-melleklet.md
  impresszum.md
  ...

Jelenleg egy projekt van itt:

H2W-Ticketing/ — a H2W Ticketing landing page (H2W_Ticketing_home) és a ResidentFirst /manager portál közös jogi tartalma:
- aszf.md — Általános Szerződési Feltételek
- adatkezelesi-tajekoztato.md — Adatkezelési tájékoztató
- adatfeldolgozoi-melleklet.md — Adatfeldolgozói szerződési feltételek (DPA)
- impresszum.md — Impresszum

Új projekt bevonásakor egyszerűen egy új, hasonló szerkezetű almappát kell létrehozni (pl. H2W-Business/, ResidentFirst-sajat/), a meglévők érintése nélkül.

Szerkesztés — ismétlődő adatok egy helyen

A H2W-Ticketing/*.md fájlok generáltak, ne szerkeszd őket közvetlenül — a legközelebbi python3 scripts/render-templates.py futás felülírja a kézi módosítást.

A tényleges szerkesztési forrás projektenként két hely:

<projekt-mappa>/_data.json — az összes dokumentumban ismétlődő tény (a szolgáltató azonosító adatai, a tárhelyszolgáltató, az al-adatfeldolgozók neve/országa)
<projekt-mappa>/_templates/*.md — maga a dokumentumszöveg, {{ dotted.path }} jelölésű helyeken hivatkozva a fenti adatokra

Adatváltozás után (pl. cím- vagy adatfeldolgozó-csere):

python3 scripts/render-templates.py

Ez feloldja a sablonokat, és felülírja velük a <projekt-mappa>/*.md fájlokat — ugyanazokat, amiket a build-manifest.py és a fogyasztó szinkron-szkriptek olvasnak. A generált fájlok tartalma innentől semmiben sem különbözik a korábbi, kézzel írt verzióktól: a content_hash/version továbbra is a tényleges, feloldott szöveget hasheli, a fogyasztók (lásd lent) nem érzékelik a különbséget.

Szándékosan nincs tokenizálva minden ismétlődő szám (pl. a „30 nap" több, egymástól független jelentéssel fordul elő) — csak azok az adatok, amelyek ténylegesen ugyanazt a tényt jelentik mindenhol, ahol szerepelnek.

Drift-ellenőrzés (nem írja felül a fájlokat, csak jelzi az eltérést):

python3 scripts/render-templates.py --check

Fogyasztók

A tartalmat a fogyasztó alkalmazások saját maguk szinkronizálják egy build-/deploy-időben futtatott szkripttel — nincs futásidejű publikus git-fetch (lásd HT-3 a H2W_Ticketing_home repóban a részletes indoklásért: bizonyíthatóság, rendelkezésre állás, adatvédelem).

Fogyasztó	Szkript	Melyik almappát olvassa
`H2W_Ticketing_home` (landing page)	`scripts/sync-legal.js`	`LEGAL_PROJECT_FOLDER` env var (`.env`), jelenleg `H2W-Ticketing`
`ResidentFirst` (`/manager` portál)	`backend/scripts/sync_legal.py`	`LEGAL_PROJECT_FOLDER` env var (`.env`), jelenleg `H2W-Ticketing`