Obrázky (Image flow)

Architektura

Sdílený systém pro Mall, Alza, feedy a budoucí konzumenty. Žádný consumer NEdrží vlastní orig cache — všechny tahají z jednoho centrálního images_orig/ skladu, který se synchronizuje z Karat BLOB (databáze KARAT_PRILOHY).

Karat KARAT_PRILOHY.dba.w_WEB3_soubory_data
        │
        ↓ (BLOB hex chunks → hex2bin → ZIP unwrap)
        │
import-export/images_orig/{shard}/{idFile_filename}      ← orig cache
        │
        ↓ (variant processory - lazy on-demand nebo proaktivně)
        │
import-export/mallImage/{…}    ← Mall (2000px + 3:4 crop)
import-export/feedImage/{…}    ← Feed (watermark v centru)
        │
        ↓ (mirror do www pro public access)
        │
www/imagesMall/{shard}/{webalized}    ← Mall.si static URL
www/imagesFeed/{shard}/{raw}          ← Feed static URL (BC sove)

Sync z Karatu

Lazy on-demand

Kdykoliv variant processor (MallImageProcessor, FeedWatermarkProcessor) nebo public endpoint (PicturePresenter::actionFeed) potřebuje orig a nemá ho na disku, zavolá KaratImageDownloader::downloadIfMissing($idFile, $fileName):

1. SELECT data, poradi FROM KARAT_PRILOHY.dba.w_WEB3_soubory_data WHERE id_file = ?
2. Concatenace hex chunků → hex2bin()
3. Zápis do images_orig/{shard}/{idFile_filename}
4. Pokud ZIP, extract a přejmenuj first inner soubor

Proaktivní batch (cron)

NomenImageBatchSync::sync($type, $nomen, $minutes) — cron */15 sync-from-karat?type=update. Update mod = SELECT z w_WEB3_nomen_soubory WHERE ts >= now - 15 min. Plný mod (1× týdně manuálně) = vše.

Diff strategy: KaratImageSyncLog drží per-file karat_ts. Pokud logged_ts >= karat_ts a soubor existuje → cached (žádný download).

Varianty

Watermark image path v parameters.imageStorage.watermarkImagePath (common.neon) — aktivní: %wwwDir%/assets/feed-watermark.png (VAPOL.cz logo převzaté ze sovy, umístí se do středu). NULL = watermark vypnut, fallback raw orig kopie do mirroru.

Cache gotcha: ensureProcessed při existujícím mirroru vrací cache hit bez přegenerování. Při zapnutí/změně watermark PNG proto smaž www/imagesFeed/ + import-export/feedImage/, jinak se staré (nezvodoznakované) mirrory nepřegenerují.

Per-partner volba s/bez vodoznaku: partner_col_perm.obrazek_bez_vodoznaku (default true = raw orig BEZ znaku). false = watermarked /imagesFeed/. Viz feed docu.

Public endpointy

Generate-on-miss (watermark obrázky)

Feed emituje statickou URL {base}/imagesFeed/{shard}/{file} (bez hashe — partneři obrázky zobrazují dlouhodobě). Existující mirror servuje Apache přímo. Pokud soubor chybí, www/.htaccess (RewriteCond !-f + RewriteRule ^imagesFeed/ index.php) pošle request do PHP na routu imagesFeed/{shard}/{file} → PicturePresenter::actionFeedWatermark, která ho lazy vygeneruje do www/imagesFeed/ a pošle. Každý další hit už jde staticky přes Apache (bez PHP) — vhodné pro objem (obrázky = ~88 % feed provozu).

Today hash

md5('today is ' . date('Y-m-d'))
// rotuje denně, sove pattern 1:1 — jen raw orig (/picture/feed, /picture/alza)

Tracking (sync log)

Tabulka karat_image_sync_log drží per-file stav (single source of truth).

Variant processory volají markVariantProcessed($idFile, $tag) po prvním úspěšném runu (JSONB append, idempotent). Admin v UI vidí které varianty už mají mirror.

Microsecond precision gotcha: Karat w_WEB3_nomen_soubory.ts má .uuu. Log ukládá s format('Y-m-d H:i:s.u'), NEcastovat na string při čtení (ztratíš µs → diff vždy false → re-download).