Přeskočit na obsah

Regenerace PDF cache smazala nahraný podepsaný dokument

import { Aside } from ‘@astrojs/starlight/components’;

Uživatelé hlásili „zmizely všechny PDF smluv“. U smluv, kde byl ručně nahraný podepsaný originál (sken), se po čase v náhledu objevilo nepodepsané PDF vygenerované ze šablony. V jednom případě byl soubor originálu smazaný z disku minutu po nahrání.

Model smlouvy měl jedno pole pdfUrl, do kterého se ukládala jak cesta k vygenerované cache (pdf-cache/<id>-<ts>.pdf), tak cesta k nahranému podepsanému originálu (signed/<uuid>.pdf). Dvě nezávislé větve s tím zacházely jako s cache:

// regenerace po PUT záznamu — „starý soubor“ = cokoliv v pdfUrl
if (contract.pdfUrl) await deleteStoredFile(contract.pdfUrl); // smaže i podepsaný originál
contract.pdfUrl = writeCache(...);
// invalidace po úpravě nadřazeného záznamu (klient)
await db.contract.updateMany({
where: { clientId, NOT: { pdfUrl: { contains: "/signed_" } } }, // chrání jen formát z e-podpisu
data: { pdfUrl: null }, // ručně nahraný „signed/uuid.pdf“ neprojde
});

Ochranný test znal jen jeden ze dvou formátů cest (/signed_ z integrace e-podpisu), ručně nahrané originály (signed/<uuid>.pdf) neodchytil. Po vynulování odkazu se při dalším náhledu vygenerovalo nepodepsané PDF; po PUT záznamu se originál i fyzicky smazal.

export function isSignedPath(p?: string | null) {
return !!p && (p.includes("signed/") || p.includes("/signed_"));
}
// regenerace: podepsaný dokument se NEpřegenerovává, vrací se beze změny
if (isSignedPath(contract.pdfUrl)) return readStored(contract.pdfUrl);
// mazat jen cache
if (contract.pdfUrl?.includes("pdf-cache/") && !isSignedPath(contract.pdfUrl)) await deleteStoredFile(contract.pdfUrl);
// invalidace: podepsané záznamy vůbec nevybírat
where: { clientId, signedAt: null, NOT: [{ pdfUrl: { contains: "/signed_" } }, { pdfUrl: { contains: "signed/" } }] }

Obnova: originály na disku zůstaly (jen odkaz byl pryč) — spárovaly se podle času podpisu v DB = mtime souboru (±5 s); jeden soubor smazaný před nočním zálohováním se obnovit nedal.

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: grep -n "deleteStoredFile\|unlink" u polí, která mohou nést nahraný soubor; SQL: záznamy se signedAt IS NOT NULL a pdfUrl LIKE 'pdf-cache/%' = podepsané záznamy servírující cache.
  • Anti-pattern: jedno pole pro cache i originál; ochranný test podle jednoho konkrétního prefixu názvu souboru; „smaž starý soubor a přepiš“ bez rozlišení původu.
  • Lepší přístup: samostatné pole signedPdfUrl (immutable, nikdy nemazané), cache v pdfCacheUrl; mazací helper, který smaže jen cesty pod cache adresářem; nahrané originály verzovat, ne přepisovat; zálohu uploadů častěji než 1× denně (nebo write-ahead kopie při nahrání).

Sister bugs / související

Sekce “Sister bugs / související”
  • Invalidace cache spouštěná „přítomností pole v payloadu“ místo skutečné změny hodnoty → každé uložení formuláře invaliduje vše.
Přidal aiarchitekt.cz · 30. 9. 2026 2:00
Provozuje aiarchitekt.cz