Više sučelja, isti listić (/glasaj)
Jednostavnije glasanje u 3 koraka nad istim backendom i lancem; testovi pariteta
# Glasanje: više sučelja nad istim listićem (/glasaj)
Stanje: 2. 10. 2026. Na produkciji od 2. 10. 2026. (Worker verzija 3c3e3932), s poveznicom s klasičnog /glasanje.
# Sažetak
/glasaj je drugo sučelje za glasanje, usporedno s klasičnim /glasanje. Glasač izabere
favorite redom, dobije prijedlog bodova koji može mijenjati, vidi pregled listića i predaje ga.
Ispod su isti backend, isti ugovor na Gnosisu i isti tok predaje. Klasično sučelje radi kao prije;
jedina vidljiva izmjena na njemu je red „Novo: Jednostavnije glasanje u 3 koraka →” iznad koraka.
/glasanje (klasično) |
/glasaj (novo) |
|
|---|---|---|
| Kako se slaže listić | dodaj radove iz galerije, klizači i polja za bodove | favoriti redom (ili jedan po jedan: sviđa / ne sviđa), prijedlog bodova, gumbi − i + |
| Koliko odluka odjednom | sve na jednom ekranu (88 radova, listić, rezultati, dijeljenje) | jedna po ekranu, tri koraka |
| Redoslijed radova | abecedni / filtri | nasumičan po sesiji (nalaz O-5) |
| Rezultati uživo | na istoj stranici | ne prikazuju se dok se bira (poveznica na klasično) |
| Dijeljenje, potvrde, provjera | da | poveznica na klasično |
| Nacrt listića | localStorage maksimir-draft |
isti ključ: prijelaz u oba smjera bez gubitka |
| Predaja | chainVoteView.startFlow("cast", items) |
isto |
# Arhitektura
flowchart LR
subgraph UI["Sučelja (usporedno)"]
K["/glasanje<br/>glasanjeView.ts"]
G["/glasaj<br/>glasajView.ts + ballotMath.ts"]
end
K --> D[("nacrt<br/>maksimir-draft")]
G --> D
K --> F["chainVoteView.ts<br/>zajednički tok predaje"]
G --> F
F --> C["Certilia"] --> R["registrar"] --> Z["ZK dokaz u pregledniku"] --> L["relayer"] --> V[("MaksimirGlasanjeV1<br/>Gnosis")]
chainVoteView.ts je od početka odvojen od stranice sučeljem Host (crtanje, prijava, moj
listić, nacrt, poruke). Novo sučelje implementira svoj Host i poziva iste funkcije
(initChain, startFlow, flowHtml, bindChain, receiptHtml, needsTransfer,
serverItems). Ugovor, registrar, relayer i baza ne znaju koje je sučelje korišteno.
Četiri pravila iz README-a prototipa i kako su ispunjena:
- Ono što vidiš je ono što potpisuješ. Ekran „Provjeri svoj listić” prikazuje točno objekt
koji ide u
startFlow. Test to provjerava usporedbom stanja pregleda i stanja toka. - Varijanta se ne zapisuje na lanac. Sučelje ne dodaje ništa u listić. Nema telemetrije.
- Sučelje mijenja rezultat, i to se mora reći. Prijedlog je javna formula (Borda nad
favoritima, raspodjela najvećim ostatkom,
web/src/ballotMath.ts) i uvijek je samo nacrt. - Izravan unos se ne skriva. Svaki redak ima polje za bodove, a ekran načina vodi i na klasični listić.
# Tok za glasača
- Početak. Ako se glas već broji: popis bodova, „Promijeni bodove”, „Izaberi ispočetka”, potvrda s lanca i povlačenje (isti blok kao na klasičnom). Ako glas iz faze 1 nije prenesen: „Prenesi glas na lanac”. Ako postoji nedovršen nacrt: „Nastavi gdje si stao/la”.
- Način. „Izaberi svoje favorite” (do 10, redom) ili „Pogledaj radove jedan po jedan” (sviđa / ne sviđa, ↩ vraća zadnju odluku, „Dosta, idem dalje” nakon 10 radova).
- Bodovi. Prijedlog po redoslijedu (npr. 5 favorita: 33 / 27 / 20 / 13 / 7), brzi izbori „Svima jednako” i „Sve prvom”, gumbi ±5 i polje za točan broj. Zbroj je stalno vidljiv; „Svedi na 100” razmjerno popravlja zbroj.
- Pregled. Popis radova s bodovima, „Što slijedi” u tri reda, tehnički zapis listića
(kanonski oblik
ŠIFRA:bodovi). „Predaj glas” otvara zajednički tok.
U fazi 1 (bez lanca) predaja ide kroz klasični listić; nacrt je već ondje.
# Što je promijenjeno u postojećem kodu
| Datoteka | Izmjena |
|---|---|
web/src/glasanjeView.ts |
jedan red s poveznicom na /glasaj iznad koraka (.gl-alt) |
web/src/chainVoteView.ts |
testni hook __chainVote izlaže i items toka (javni podaci; ponašanje isto) |
web/src/app.ts |
ruta glasaj, stavka u navigaciji, puna širina |
web/src/meta.ts |
naslov, opis i OG za /glasaj; ruta ulazi u prerender i sitemap |
web/scripts/regression.mjs |
/glasaj se puni uživo, pa se ne uspoređuje s prerenderom (kao /glasanje) |
web/src/style.css |
nove klase .gj-*; postojeće nisu dirane |
Logika glasanjeView.ts (osim te poveznice), glasanje.ts, chainVote.ts, chain/, relayer i worker nisu mijenjani.
# Testovi
| Naredba | Što provjerava |
|---|---|
npm run test:glasanje |
ballotMath.ts: raspodjela, preseti za 1–88 favorita, validacija (ista pravila kao ugovor i baza), kanonski oblik, nasumičan redoslijed |
npm run test:paritet |
isti scenariji nad oba sučelja uz lažni backend: neprijavljen, bez ključa, prijenos iz faze 1, glas na lancu + povlačenje. U oba slučaja u tok mora ući isti listić i tok mora stati na istom koraku. Plus pet scenarija samo za /glasaj |
node scripts/glasanje-ui.mjs |
postojeći test klasičnog listića (nepromijenjen, prolazi) |
npm run check |
regresija cijelog sitea (138 ruta) |
test:paritet treba Vite (npx vite --port 5173). Lažni backend (scripts/lib/glasanje-mock.mjs)
presreće Supabase, GitHub i Gnosis RPC (ballotOf, results, voters kodirani kao ugovor), pa
ništa ne ide na produkciju. Paritetni scenariji prvo su napisani i pušteni samo nad klasičnim
sučeljem (commit d2c7eb6), a tek onda je dodano novo.
Provjera osjetljivosti testa: dvije namjerne greške u glasajView.ts (u tok ide prijedlog umjesto
listića s pregleda; prijenos šalje nacrt umjesto glasa iz faze 1) test je uhvatio, pa su vraćene.
Stanje 2. 10. 2026.: typecheck čist, test:glasanje 10/10, test:relayer 8/8, glasanje-ui
prolazi, test:paritet 72/72, check prolazi nad lokalnim workerom.
# Otvoreno
- Deploy (napravljeno 2. 10. 2026.).
npm run checknad produkcijom prije (137 ruta) i poslije (139 ruta) prošao. Read-only obilazak u Braveu: poveznica na/glasanjevidljiva, klik vodi na/glasaj, glas na lancu (revizija 4) prikazan jednako u oba sučelja, nacrt nije diran, konzola bez grešaka. - Kako ljudi dolaze na
/glasaj. Poveznica s/glasanjei stavka u navigaciji. Nasumična dodjela sučelja (A/B/C iz istraživanja) nije uvedena: bez mjerenja ne bi ništa pokazala, a mjerenje traži odluku što se i gdje bilježi (pravilo 2: ništa na lancu, samo zbirno offchain) i unaprijed objavljena mjerila. - Ostale varijante iz prototipa (dvoboj, MaxDiff, žetoni) mogu se dodati na isti način:
novi ekran izbora koji puni
st.picksilist.items, ostalo je zajedničko. - Swipe: drugi prolaz kroz odbijene radove (protiv pada prihvaćanja kroz niz) nije napravljen.
- Slijepi mod (imena timova skrivena dok se bira) iz prototipa nije prenesen, radi jednostavnosti. Ako se uvede, treba biti isti u svim sučeljima.
# Prijava na iPhoneu: prozor Certilije se odmah zatvarao (2. 10. 2026.)
Simptom. Na iPhoneu, u pregledniku bez aktivne Certilia sesije, „Prijavi se eOsobnom” otvori prozor koji se odmah zatvori. Isto se događalo i kad je korisnik nakon uspješne prijave ručno kliknuo „Zatvori” umjesto da pričeka automatsko zatvaranje. U Braveu s aktivnom Certilia sesijom sve je radilo.
Uzrok. Certilia proxy (certilia.domovina.ai, repo stepanic/flutter_certilia,
certilia-server) ima express-rate-limit od 100 zahtjeva / 15 min po IP-u na cijelom /api.
Klijent je za vrijeme prijave pitao GET /api/auth/polling/:id/status svake 2 s (30/min), pa je
prijava dulja od otprilike 3 min sama potrošila limit. Sljedeći poziv (initialize pri novom
pokušaju ili exchange nakon uspjeha) dobio je 429. finally u signInWithCertilia zatvorio je
prozor, a poruka je završila u st.msg stranice iza chain modala, gdje se ne vidi. Brza prijava
s aktivnom sesijom stane u limit, zato je tamo radilo. U trenutku dijagnoze naš IP je imao
ratelimit-remaining: 0.
sequenceDiagram
participant T as Tab glasanja
participant P as Certilia prozor
participant S as certilia.domovina.ai
T->>S: initialize, polling/start
T->>P: otvori authorization_url
loop svake 2 s
T->>S: polling status (brojao se u limit)
end
S-->>T: 429 nakon 100 zahtjeva
T->>P: finally zatvara prozor
Note over T: greška u st.msg iza modala
Ručni „Zatvori” se činio kao zaseban bug jer gumb u public/callback.js radi drugo od
automatskog zatvaranja (window.close() + odmah history.back(), pa history.go(-1) i
about:blank). Server, međutim, sprema uspjeh prije nego što prikaže stranicu, a
updateSessionByState mijenja samo sesije u stanju pending, pa povratak u povijest ne može
pregaziti uspjeh. Nakon popravka limita ručni „Zatvori” radi (korisnik potvrdio na iPhoneu), dakle
i to je bio isti limit: ručno zatvaranje je značilo dulju prijavu.
Popravak.
- Server (
9327e92, Coolify appv1373oj6valkmqebdugaacmu, deploy preko Coolify API-ja/api/v1/deploy?uuid=…):skipzaGET /auth/polling/:id/status.polling_idse ne može pogoditi, a čitanje je iz memorije. Ostali/apipozivi i dalje se broje. - Web (
ab01bb5):Host.signIn()vraća poruku greške, a chain modal je prikazuje na koraku prijave; polling svake 3 s, nakon 429 pričeka 30 s; 429 priinitialize/exchangedaje poruku „Previše pokušaja prijave s ove mreže”.
Zamke.
Retry-AfteriRateLimit-*zaglavlja nisu izložena kroz CORS (nemaAccess-Control-Expose-Headers), pa ih skripta ne vidi i ne zna koliko čekati.- Redeploy Certilia servera prekida prijave u tijeku: polling sesije i limiter žive u memoriji (restart ujedno resetira limit).
- Provjera stanja limita:
curl -sD- -o/dev/null "https://certilia.domovina.ai/api/health" | grep -i ratelimit(troši jedan zahtjev). Polling status na produkciji više nemaRateLimitzaglavlja. - Mobilni operateri stavljaju puno korisnika iza istog IP-a (CGNAT), pa je 100 / 15 min za
initialize+polling/start+exchange(3 zahtjeva po prijavi) i dalje oko 33 prijave po IP-u u 15 min. Ako se glasanje jako proširi, treba podićiRATE_LIMIT_MAX_REQUESTSna Coolifyju.