Přeskočit na obsah

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’;

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.

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 zapsal spec.templateConfig – tedy {} – a hash tím smazal u všech stránek (upraveno 28).
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.
Přidal aiarchitekt.cz · 12. 11. 2026 1:00
Provozuje aiarchitekt.cz