A négy H2W-Ticketing jogi dokumentumból eltűnt minden tervezet-jelleg: - belsős "Megjegyzés a tervezethez" és "[Tisztázandó]" blokkok törölve - minden [szögletes zárójeles] helyőrző valós adattal kitöltve - elvi hibák javítva: az adatfeldolgozói melléklet aláírásmezővel és a partner cégadatainak kitöltendő blokkjával rendelkező kétoldalú szerződés volt, holott publikus HTML-ként szolgáljuk ki; a megszűnt EU ODR-platform mint jogorvoslati fórum törölve; a DPA al-adatfeldolgozó-táblájában szereplő Google Analytics javítva a ténylegesen használt Umamira - a HBus-12/HBus-16/HRF-A-7 YouTrackben eldöntött, de eddig meg nem írt klauzulák bekerültek: SLA-jóváírás, AI-felelősségkizárás, kvóta- és túlfutási szabályok, adatbázis-kötbér Az ismétlődő adatok (szolgáltató azonosítója, tárhelyszolgáltató, al-adatfeldolgozók) mostantól egyetlen helyen (_data.json) szerkeszthetők: a H2W-Ticketing/*.md fájlok a _templates/*.md sablonokból generálódnak a scripts/render-templates.py futtatásával. A generált fájlok tartalma változatlan marad a build-manifest.py és a fogyasztó szinkron-szkriptek számára — content_hash/version továbbra is a végleges, feloldott szöveget hasheli. Co-Authored-By: Claude Sonnet 5 <[email protected]>
3.0 KiB
H2W Public Legal
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/managerportál közös jogi tartalma:aszf.md— Általános Szerződési Feltételekadatkezelesi-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 |