# 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/&lt;id&gt;"| OG["OG kartica<br/>worker/share.ts"]
  W -->|"/glasanje/g/&lt;id&gt;"| 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.), konfiguracija web/wrangler.jsonc, kod web/worker/. Sva pravila usmjeravanja su na jednom mjestu, u worker/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 samo workers_routes.
• Pages projekt stadion-maksimir i dalje postoji. Njegov zadnji produkcijski deploy je cijeli site plus functions/_middleware.ts, koji preusmjerava samo *.pages.dev na kanonski host.
• https://maksimir.d-o-m.workers.dev i preview URL-ovi verzija rade za provjeru, ali šalju X-Robots-Tag: noindex. Certilia prijava na njima ne radi, jer nisu u ALLOWED_ORIGINS. Isto je bilo s Pagesovim preview URL-ovima.

# Deploy i povrat

# Š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.

Dopuštene razlike (skripta ih izuzima, i to s razlogom):

• panel „Glasanje javnosti” na stranici rada (#gl-rad-panel) i sadržaj /glasanje pune 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.

# 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:

1. 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.
2. Prethodna verzija je već prošla --baseline bez 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:

1. https://maksimir.domovina.ai/#/glasanje → URL postaje /glasanje, prijava i listić su i dalje tu (isti origin, pa localStorage ostaje). 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.
2. /g/abcdefabcdef → /glasanje/g/abcdefabcdef s porukom „Objava ne postoji”; zatim pravim klikom „← Na glasanje” i logo. Prije toga postaviti window.__sameDoc = true i provjeriti da je preživio.
3. /#/radovi → filter „Nagrađeni” (5 od 88) → klik na rad → natrag u pregledniku (filter ostaje).
4. /#/glasanje-kako-radi#<sidro> → sidro na vrhu ekrana, dijagrami nacrtani.
5. read_console_messages s onlyErrors. Konzola se prati tek od prvog poziva, pa nakon njega treba ponovno učitati stranicu. Upozorenja chrome-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.

# Zamke otkrivene pri ovoj selidbi

• wrangler pages deploy bez --branch na gitovoj grani main ide na produkciju. Wrangler uzima granu iz gita. Stara skripta deploy:preview tako je 25. 9. 2026. otišla na produkciju. Sad je deploy:preview postavljen na wrangler 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_id je u wrangler.jsonc; za wrangler pages … izvan web/ treba CLOUDFLARE_ACCOUNT_ID=7dc7167b7e2e00923bfa7cd697df14e4.
• compatibility_date ne smije biti noviji od lokalnog runtimea (wrangler 4.96 podržava do 2026-06-05), inače wrangler dev ne starta.
• Workers assets preusmjeravaju s 307, Pages s 308. Worker 307 pretvara u 308, jer je kanonski put trajan.
• _redirects i _headers se ne primjenjuju kad odgovara Worker (run_worker_first). Zato je ljuska objave i cache (/assets/* godinu dana, slike 4 h, HTML uvijek provjera) u worker/index.ts, a prerender više ne piše _redirects.
• Logo u index.html imao je href="#/". Refaktor ruta ga je preskočio, jer je izvan #content i nije išao kroz link(). 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.