Seed struktury přepíše JSON config stránky a smaže hash importu – každý další import považuje obsah za ručně upravený
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Změna textu stránky v datovém modulu importu se lokálně propsala, na serveru import hlásí beze změny 88 a podrobný výpis = klub.clenstvi/cs (ručně upraveno – ponecháno, přepíše jen --force). V adminu přitom nikdo nic neupravoval. Uložený import_hash na serveru je undefined.
Root cause
Sekce “Root cause”Dva zapisovatelé do pages.template_config (JSON):
- importér obsahu po zápisu uloží
template_config.import_hash[locale], aby příště rozpoznal ruční úpravy (chybějící hash = fail-closed, stránka se bere jako ručně upravená); - seed struktury (spouštěný po každém nasazení kvůli novým stránkám) porovnával
JSON.stringify(existing.template_config) !== JSON.stringify(spec.templateConfig ?? {})a při rozdílu zapsalspec.templateConfig– tedy{}– a hash tím smazal u všech stránek (upraveno 28).
Fix
Sekce “Fix”const { import_hash, ...cfgRest } = (existing.template_config ?? {}) as Record<string, unknown>;if (JSON.stringify(cfgRest) !== JSON.stringify(spec.templateConfig ?? {})) { data.template_config = { ...(spec.templateConfig ?? {}), ...(import_hash ? { import_hash } : {}) };}Importér navíc „self-heal“: když obsah v DB odpovídá importu, ale uložený hash chybí/liší se, hash doplní bez změny obsahu. Jednorázová náprava na serveru: import --only pages --force (klient zatím nemá přístup do adminu, takže nehrozí přepsání ručních úprav). Test: import → seed → hash beze změny → import bez hlášky „ručně upraveno“.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
grep -rn "template_config\|settings_json" src scripts– víc míst zapisujících celý objekt; na serveru porovnat uložený hash s aktuálním. - Anti-pattern: idempotentní seed porovnává a nahrazuje celý JSON sloupec, který „patří“ i jinému procesu.
- Lepší přístup: oddělené sloupce pro cizí metadata, nebo merge jen vlastních klíčů + regresní test spolupráce seed × import.
Sister bugs / související
Sekce “Sister bugs / související”- Fail-closed ochrana je správně (chybějící hash nesmí znamenat „přepiš“), ale musí mít diagnostiku: výpis „ručně upraveno“ u desítek stránek najednou je signál smazaných hashů, ne ručních úprav.