Generátor webu potřebuje ke každé routě soubor. Kanonická data jsou ale JSON. Řeší to adaptéry: minimální stránky s ukazatelem na pohledový model, generované z dat.
Co je generované a co ne
Generované (nikdy needitovat ručně):
content/dossiers/<slug>/_index.mdcontent/dossiers/<slug>/{claims,sources,cases,gaps,relations}/*.mdcontent/entities/*.md
Ručně psané: koncepty, dokumentace, manifest, kořenové rozcestníky, tenké routovací indexy uvnitř dossierů — a tahle vzdělávací vrstva.
Jak ověřit podezřelý rozdíl
Když rozdíl v content/ vypadá divně, pusťte kontrolu parity samostatně, mimo pipeline:
npm run data:check-generated:content
Nad nesynchronizovaným stromem chybu ohlásí — na rozdíl od běhu uvnitř brány.
Správný postup změny
$EDITOR data/dossiers/<slug>/… # kanonický JSON
npm run data:validate # rychlá kontrola
npm run data:build # pohledové modely + adaptéry
npm run build # plná brána
Ověř si, že to sedí
Kolega tvrdí, že opravil překlep na stránce tvrzení, ale po sestavení je tam zase. Co se stalo? Editoval generovaný adaptér místo kanonických dat. Stránka pod Oprava patří do Poznávací znamení: generované stránky nesou v hlavičce příznak, že jsou generované, a ukazatel na pohledový model. Když ho v souboru vidíte, needitujete zdroj.Zobrazit odpověď Skrýt odpověď
content/dossiers/<slug>/claims/ je odvozený soubor. Při dalším data:build nebo plné bráně se přepsal obsahem vygenerovaným z JSON záznamu — a protože synchronizace běží před kontrolou parity, nikdo to neohlásil.data/dossiers/<slug>/claims/clm-NN.json. A protože jde o text tvrzení, i do odpovídajícího řádku přehledové tabulky v dossier.json — jinak spadne parita tabulky.