Your NameandClaude Sonnet 5
df3c5df988
A CI mostantól a build-manifest.py előtt lefuttatja a render-templates.py-t, és a feloldott dokumentumokat is visszacommitolja a manifest+HTML mellé — mostantól a _data.json / _templates szerkesztése önmagában elég, nem kell kézzel futtatni és commitolni a render-templates.py-t. A trigger paths-ignore-ja kiegészült a '*/*.md' mintával (a generált fájlok commit-backje ne indítson újabb buildet), a _templates/ almappa mélyebben van, így ez nem szűri ki a tényleges szerkesztéseket. A "saját tulajdonú hardver" megfogalmazás mind a 4 dokumentumban javítva "a Nethely Kft.-től bérelt szerver"-re — a tényleges konstrukció klasszikus szerverbérlés, nem a Szolgáltató tulajdonában lévő, kolokált hardver. Co-Authored-By: Claude Sonnet 5 <[email protected]>
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 |