Regresijske provjere i Worker
npm run check, baseline, ručna provjera u pregledniku, deploy i povrat (25.9.2026.)
# Regresijske provjere weba i Worker hosting
2026-09-25. Trajne upute za svaku buduću promjenu u web/: kako dokazati da ništa nije pokvareno i da stari
linkovi i dalje rade. Nastalo nakon prelaska s hash ruta na prave rute, prerendera i selidbe s Cloudflare Pagesa
na Worker (plan: 2026-09-25-seo-rute-plan.md).
# Ukratko
cd web
npm run dev:worker # build + wrangler dev na http://localhost:8787
npm run check -- http://localhost:8787 # u drugom terminalu; izlazni kod 1 = regresija
Prije i poslije deploya na produkciju, s usporedbom sa stanjem prije refaktora:
npm run check -- https://maksimir.domovina.ai \
--alias https://stadion-maksimir.domovina.ai \
--baseline https://dd23a1dd.stadion-maksimir-8cl.pages.dev
Traje oko 3 minute. Samo čita stranice: ne prijavljuje se, ne glasa i ne dira ničiji localStorage.
# Kako je site posložen (od 25. 9. 2026.)
flowchart LR
U["preglednik / crawler"] --> Z{"zona domovina.ai<br/>ruta Workera"}
Z -->|"maksimir.domovina.ai/*"| W["Worker maksimir<br/>web/worker/index.ts"]
Z -->|"stadion-maksimir.domovina.ai/*"| W
W -->|"sporedni host"| R301["301 → maksimir.domovina.ai"]
W -->|"/g/<id>"| OG["OG kartica<br/>worker/share.ts"]
W -->|"/glasanje/g/<id>"| SH["dist/_share.html"]
W -->|"ostalo"| A["dist/ (prerender)<br/>404.html sa statusom 404"]
P["stadion-maksimir-8cl.pages.dev"] -->|"Pages _middleware"| R301
- Worker
maksimir(račun D.O.M.), konfiguracijaweb/wrangler.jsonc, kodweb/worker/. Sva pravila usmjeravanja su na jednom mjestu, uworker/index.ts(run_worker_first: true). - DNS se nije mijenjao. CNAME zapisi i dalje pokazuju na Pages, ali ruta Workera na zoni presreće promet prije
origina. Wrangler token nema
dns:write, a rute traže samoworkers_routes. - Pages projekt
stadion-maksimiri dalje postoji. Njegov zadnji produkcijski deploy je cijeli site plusfunctions/_middleware.ts, koji preusmjerava samo*.pages.devna kanonski host. https://maksimir.d-o-m.workers.devi preview URL-ovi verzija rade za provjeru, ali šaljuX-Robots-Tag: noindex. Certilia prijava na njima ne radi, jer nisu uALLOWED_ORIGINS. Isto je bilo s Pagesovim preview URL-ovima.
# Deploy i povrat
| Što | Naredba |
|---|---|
| Produkcija | cd web && npm run deploy (= build + wrangler deploy) |
| Preview bez diranja produkcije | npm run deploy:preview (= wrangler versions upload, daje preview URL verzije) |
| Povrat Workera na prethodnu verziju | npx wrangler rollback (ili Workers → maksimir → Deployments u dashboardu) |
| Povrat na Pages u cijelosti | ukloniti routes iz wrangler.jsonc i wrangler deploy, ili obrisati dvije rute u dashboardu. Pages tada opet poslužuje obje domene (middleware preusmjerava samo *.pages.dev, pa nema petlje). |
# Što skripta provjerava i zašto
web/scripts/regression.mjs. Rute čita iz <base>/sitemap.xml, dakle iz istog allRoutes() koji koristi
prerender. Nova ruta ili dokument se time automatski provjerava.
| # | Provjera | Što dokazuje |
|---|---|---|
| 1 | HTTP statusi i Location (bez preglednika) |
/x/ i /x.html → 308 na /x, nepoznat put → 404 s noindex, /g/<id> daje OG karticu i JS preusmjeravanje, /g/nevaljan → 302 na /glasanje, canonical i og:image u HTML-u |
| 2 | #content iz prerenderiranog HTML-a == #content nakon JavaScripta, za svaku rutu |
prerender i klijent crtaju isto, pa nema treptaja ni razlike za crawlere |
| 2b | --baseline: isti #content na starom deployu (hash rute) |
nema regresije u odnosu na stanje prije refaktora; jedina dopuštena razlika je href="#/x" → href="/x" |
| 2c | nijedan <a href="#/…"> na cijeloj stranici |
i ljuska iz index.html je prebačena, ne samo #content |
| 3 | stari linkovi /#/<ruta> za svaku rutu, plus sidro i objava |
poveznice podijeljene prije 25. 9. 2026. vode na pravu stranicu (replaceState, bez novog unosa u povijesti) |
| 4 | klik, natrag, naprijed, izravan ulaz sa sidrom, Mermaid | navigacija ne učitava stranicu ponovno (window.__sameDoc preživi), sidro skrola, dijagrami se crtaju |
| 5 | preglednik bez JavaScripta | naslov, h1 i navigacija su u HTML-u |
| 6 | --baseline: screenshotovi 6 stranica na 390 i 1280 px, pixelmatch (prag 0.1) |
izgled je isti; parovi -novo/-staro.png za pregled ostaju u privremenoj mapi |
| — | greške u konzoli preglednika | nijedna |
Dopuštene razlike (skripta ih izuzima, i to s razlogom):
- panel „Glasanje javnosti” na stranici rada (
#gl-rad-panel) i sadržaj/glasanjepune se uživo iz Supabasea; - Mermaid: prerender ima izvor (
mermaid-source), preglednik SVG. Uspoređuje se samo broj i mjesto blokova; - rute koje na baselineu još ne postoje (novi dokument) javljaju se kao „nove od baselinea”.
Baseline je deploy dd23a1dd (commit 4e1ec0f, zadnji s hash rutama). Pages čuva svaki deploy na
<id>.stadion-maksimir-8cl.pages.dev, a middleware za preusmjeravanje nije u tom starom deployu, pa baseline
ostaje dostupan. Za buduće promjene kao baseline se može uzeti i trenutna produkcija prije deploya.
Od 29. 9. je dd23a1dd zastario kao baseline: 8 padova (/rezultati/1, /radovi/6TVJ3MUHR, dokumenti glasanja,
/ops-status-deploy i screenshotovi) su namjerne promjene nakon 25. 9. (3D model, puna širina, novi tekstovi).
Kad prod provjera javi samo BASELINE i screenshot padove, a HTTP, DOM, stari linkovi i navigacija prođu, nema regresije.
Za čistu usporedbu prije sljedećeg deploya pokreni provjeru s produkcijom kao baselineom (vidi gore).
# Kad je promjena namjerna (izmijenjen tekst dokumenta)
--baseline tada javi pad, ali pokaže samo prvu razliku po stranici. Da iza nje nema još nečega, usporedi
cijeli #content s prethodnom verzijom Workera. Svaka verzija ima svoj URL:
https://<prvih 8 znakova version id>-maksimir.d-o-m.workers.dev (npx wrangler versions list). Postupak:
- Nova verzija se usporedi s prethodnom (curl svih ruta iz sitemapa, diff samo dijela od
id="content"dalje). Razlike smiju biti samo izmjene koje su namjerno napravljene. - Prethodna verzija je već prošla
--baselinebez razlika, pa je lanac zatvoren.
Tako je 25. 9. 2026. potvrđeno da je verzija 8f464584 (ispravljeni linkovi #/glasanje u dokumentima, napomena
„zastarjelo” u starom dokumentu o deployu, novi dokument) jednaka verziji fb9e6d58 osim u tim izmjenama.
# Ručna provjera u pravom pregledniku (claude-in-chrome)
Skripta ne vidi što vidi prijavljeni korisnik. Nakon deploya zato slijedi i provjera u korisnikovom Braveu
(profil ms@ff.hr, deviceId u globalnom CLAUDE.md), samo čitanjem:
https://maksimir.domovina.ai/#/glasanje→ URL postaje/glasanje, prijava i listić su i dalje tu (isti origin, palocalStorageostaje). Stanje provjeravati JS-om, i to samo oblik:!!localStorage.getItem("maksimir-zk-identity")i popis ključeva. Vrijednosti se nikad ne čitaju ni ne ispisuju, a gumbi koji mijenjaju stanje (predaja, povlačenje, objava, uvoz ključa) se ne klikaju./g/abcdefabcdef→/glasanje/g/abcdefabcdefs porukom „Objava ne postoji”; zatim pravim klikom „← Na glasanje” i logo. Prije toga postavitiwindow.__sameDoc = truei provjeriti da je preživio./#/radovi→ filter „Nagrađeni” (5 od 88) → klik na rad → natrag u pregledniku (filter ostaje)./#/glasanje-kako-radi#<sidro>→ sidro na vrhu ekrana, dijagrami nacrtani.read_console_messagessonlyErrors. Konzola se prati tek od prvog poziva, pa nakon njega treba ponovno učitati stranicu. Upozorenjachrome-extension://nkbih…dolaze od ekstenzije za novčanik, ne od sitea.
Ključ maksimir-zk-share sadrži kodirane podatke objave. Ne otvarati ga radi traženja id-ja objave: /g/<id> se
provjerava izmišljenim id-jem, a stvarnu karticu pokriva provjera 1.
# Listić glasanja: glasanje-ui.mjs
npm run check samo čita stranice, pa ne klikne ništa na listiću. Za promjene u glasanjeView.ts pokreni i
node scripts/glasanje-ui.mjs <url>, lokalno ili na produkciji. Svi pozivi prema api.domovina.ai su presretnuti,
pa ništa ne ide u bazu. Detalji: 2026-09-26-glasanje-ux.md.
Trajanje: produkcijski npm run check traje oko 3 minute. Pokreni ga jednom i uzmi izlazni kod iz istog runa
(; echo $?), ne ponovnim pokretanjem. --baseline dd23a1dd… je od 26. 9. zastario: dokumenti su se od tada
mijenjali, pa javlja razlike BASELINE i time izlazni kod 1. Za rutinski deploy usporedi s produkcijom prije deploya
ili izostavi --baseline.
# Zamke otkrivene pri ovoj selidbi
wrangler pages deploybez--branchna gitovoj granimainide na produkciju. Wrangler uzima granu iz gita. Stara skriptadeploy:previewtako je 25. 9. 2026. otišla na produkciju. Sad jedeploy:previewpostavljen nawrangler versions upload; ako se ikad opet deploya Pages, uvijek treba eksplicitno--branch preview.- Wrangler u novoj mapi ne zna račun („More than one account available”).
account_idje uwrangler.jsonc; zawrangler pages …izvanweb/trebaCLOUDFLARE_ACCOUNT_ID=7dc7167b7e2e00923bfa7cd697df14e4. compatibility_datene smije biti noviji od lokalnog runtimea (wrangler 4.96 podržava do 2026-06-05), inačewrangler devne starta.- Workers assets preusmjeravaju s 307, Pages s 308. Worker 307 pretvara u 308, jer je kanonski put trajan.
_redirectsi_headersse ne primjenjuju kad odgovara Worker (run_worker_first). Zato je ljuska objave i cache (/assets/*godinu dana, slike 4 h, HTML uvijek provjera) uworker/index.ts, a prerender više ne piše_redirects.- Logo u
index.htmlimao jehref="#/". Refaktor ruta ga je preskočio, jer je izvan#contenti nije išao krozlink(). Radio je samo zato što ga prevoditelj starih linkova pretvori u/. Provjera 2c sad to hvata. - PNG bajtovi dva ista screenshota se razlikuju. Usporedba ide pixelmatchom, ne
Buffer.equals.
# Mermaid „Syntax error” prolazi kroz npm run check (26. 9. 2026.)
Na /glasanje-odluke, /lanac-adr-kljuc, /lanac-verzije i /lanac-integracija dijagram se prikazivao kao
mermaidova bomba „Syntax error”, a npm run check je prošao. Za to postoje dva razloga:
- I poruka o grešci je
<svg>. Provjera broji#content svgsamo na/glasanje-kako-radi, pa ni neispravan dijagram ni ostale stranice ne pogađa. - U
sequenceDiagramje;kraj naredbe. PorukaA->>B: sesija; poziv()puca na dijelu iza;(„Expecting … SOLID_ARROW, got NEWLINE”). U tekstu poruke treba pisati zarez ili#59;. Popravljeno u8710f44.
Brza provjera svih dijagrama bez preglednika: mermaid iz web/node_modules i jsdom (jer flowcharti trebaju
DOMPurify, a bez window parse pada s „DOMPurify.addHook is not a function”, što je lažna greška):
// node check-mermaid.mjs $(grep -rl '```mermaid' docs research *.md) — jsdom instaliraj u privremenu mapu
import fs from "fs"; import { JSDOM } from "jsdom";
const w = new JSDOM("").window; globalThis.window = w; globalThis.document = w.document;
const { default: mermaid } = await import("<repo>/web/node_modules/mermaid/dist/mermaid.core.mjs");
for (const f of process.argv.slice(2))
for (const [i, b] of [...fs.readFileSync(f, "utf8").matchAll(/```mermaid\n([\s\S]*?)```/g)].entries())
await mermaid.parse(b[1]).catch((e) => console.log(f, i, e.message.split("\n")[0]));
Na stanju prije popravka ovo je uhvatilo sve četiri greške, a nakon njega su svi dijagrami u repou prošli.
Otvoreno: dodati ovaj korak u regression.mjs (ili u build), i u pregledniku tražiti tekst „Syntax error” na svim
rutama, a ne samo brojati SVG-ove.
# Prerender ne zna sve što zna preglednik (28. 9. 2026.)
Provjera uspoređuje HTML iz prerendera s DOM-om u pregledniku, pa svaka izmjena DOM-a nakon iscrtavanja mora
raditi i pod happy-domom. happy-dom nema table.tHead, table.tBodies ni row.cells, pa je
web/src/tableSort.ts u prvoj verziji prekidač dodao samo u pregledniku i provjera je pala na četiri rute.
Rješenje je koristiti samo querySelector/querySelectorAll. I: npm run check … | tail guta izlazni kod,
pa se lanac check && commit && deploy nastavi i kad provjera padne. Izlaz preusmjeri u datoteku.
# Prolazni 404 odmah nakon deploya (2. 10. 2026.)
npm run check pokrenut odmah nakon npm run deploy (verzija 56c00290) pao je s dvije greške u konzoli:
/radovi/GGWUGWAZB i /radovi/J8B0FD4Q0, „Failed to load resource: 404”. Same stranice su vraćale 200, a
ponovno učitavanje tih stranica (Playwright, praćeni svi odgovori ≥ 400) nije pokazalo nijedan 4xx. Isti sadržaj
je sat ranije prošao provjeru i prije i poslije deploya. Najvjerojatnije se dio zahtjeva u prvim sekundama
poslužio iz stare verzije koja traži hashirane assete kojih u novoj više nema.
Pravilo: nakon deploya pričekaj oko minutu prije provjere. Ako padne samo na „greške u konzoli” s 404 na
nekoliko ruta, ciljano ponovno učitaj baš te rute i zabilježi sve odgovore ≥ 400 (ne cijeli check ispočetka).
Ako se ponovi, to je stvarna greška.
# Vezani dokumenti
-
2026-09-28-3d-model-i-medijski-arhiv.md: 3D model i medijski arhiv -
2026-09-25-seo-rute-plan.md: plan i odluke (hash → prave rute, zašto bez Astra) -
2026-09-25-web-nice-to-have.md: odgođeno (2,27 MB JS po stranici,docs.tsglob, slike, Astro) -
2026-09-25-glasanje-javnosti.md: glasanje,ALLOWED_ORIGINS, E2E
# Normalizacija #/ daje lažne BASELINE razlike (8. 10. 2026.)
regression.mjs u baseline sadržaju mijenja href="#/ u href="/ (jedina dopuštena razlika iz
refaktora hash ruta). Zamjena ide po cijelom HTML-u, pa pokvari i doslovni tekst unutar <code> na
stranicama koje opisuju tu migraciju (/ops-seo-rute-plan, /ops-regresijske-provjere). Takva
razlika pri usporedbi s produkcijom nije regresija: potvrdi ju tako da usporediš sirovi HTML s
curl -s <url>/<ruta> | grep -o '…' na obje strane. Popravak skripte: zamjenjivati samo u atributu
href elemenata <a>, ne u tekstu.
# Preview kao „prije”, produkcija kao baseline (20. 10. 2026.)
--baseline dd23a1dd je zastario, pa usporedba s njim pada na svakoj kasnijoj izmjeni sadržaja.
Postupak koji je za deploy samo dokumenata trajao dva prolaza od ~3 min:
npm run deploy:preview→ URL verzije, npr.https://f2d528a8-maksimir.d-o-m.workers.dev.npm run check -- <preview> --baseline https://maksimir.domovina.ai: razlike smiju biti samo namjerne izmjene i dvije poznate lažne (#/gore).npm run deploy.npm run check -- https://maksimir.domovina.ai --alias https://stadion-maksimir.domovina.ai --baseline <preview>: ostaju samo dvije lažne razlike, dakle produkcija je ista kao provjereni preview.
Izlazni kod je zbog lažnih razlika 1, pa se izlaz čita, ne samo kod. Screenshot razlika
1280_radovi (područje prve kartice) bila je šum učitavanja slike, vizualno ista; prije nego se
proglasi regresijom, izreži područje razlike (ImageChops.difference(...).getbbox()) i pogledaj.
Za parsiranje mermaida jsdom instaliraj u privremenu mapu (npr. scratchpad), a mermaid uvezi
apsolutnim putem iz web/node_modules; tako radi i za markdown iz drugih repoa (zajedno).