Frontend

Next.js App Router, React 19, TypeScript (strict), Tailwind 4, Motion. Kõik ekraanid on päris React-komponendid (src/components/screens); film, tooteavastaja ja tehniline ülevaade kasutavad samu komponente ja sama domeeni.

Olekuhaldus

Üks Zustand store (src/store/demo.ts) hoiab stsenaariumi, UI olekut ja viidet MockBackend-ile. Backend teavitab muudatustest (subscribe), store kopeerib hetktõmmise. Tuletatud vaatemudel useDerived() arvutab osalused, loosimise hetkeseisu, ametliku staatuse ja väljamaksed puhastest funktsioonidest.

Domeenimudelid

Group, Contribution (+ PaymentEvent ajalugu), TicketLine, DrawData,DrawSnapshot, OwnershipRow, PayoutRow. Raha on alati täisarvulised sendid; jaotus suurima jäägi meetodiga, BigInt korrutusega (täpne ka jackpoti suurusel).

Teenuseadapterid

src/services/contracts.ts kirjeldab 12 liidest (identiteet, sobivus, rahakott, pundid, kutsed, osalused, piletipaketid, loosimised, tulemused, väljamaksed, teavitused, audit). Demo kasutab deterministlikku MockBackend-i: ei mingit juhuslikkust, järjenumbrid kellaaja asemel. Päris Eesti Loto API-dele ligipääsu pole ja seda ei väideta.

Samaaegsus ja püsivus

Mahu reserveerimine on sünkroonne samm (prototüübis JS-i sündmustsükkel; tootmises tingimuslik INSERT/UPDATE või reaülene lukk ühes transaktsioonis koos idempotentsusvõtmega). Kaotaja lükatakse tagasi enne tasu võtmist. Hoidev olek (initiated/pending) arvestatakse vaba mahu hulka, nii et omandiosa ei ületa kunagi 100%. Prototüüp hoiab andmeid mälus; tootmises oleks pearaamat Eesti Loto serveris, klient ei arvuta kunagi lõplikke summasid.

Loosimise sünkroonimine

Draw engine (src/domain/games.ts) eraldab loosimise ajakava, piletiread, pallide järjekorra, sobitamise, ametliku staatuse ja väljamakse õiguse. Film, telefon ja pubi teler renderdavad sama PundiliveView-d samastDrawData-st, seega numbrid ei saa lahkneda. Eurojackpot ja Bingo loto on eraldi mudelid; Bingo loto tulemusi ei näidata enne volitatud avaldamist.

Tulemuste kinnitus ja väljamakse

officialStatus() ei tagasta kunagi „confirmed” enne ametlikku aega; „delayed” blokeerib väljamakse. Väljamakse algab ainult olekust results_confirmed. Väikesed summad lähevad (simuleeritud) rahakotti, limiidist suuremad isikutuvastuse ja pangaülekande järjekorda (demo limiit 1000,00 €, päris limiit Eesti Loto reeglitest).

Audit

Iga oleku muutus (makse, punt, väljamakse, tagasilükkamine) kirjutatakse järjestatud auditisündmusena. Vaata „Rikkestsenaariumid”.

Testid

Vitest: ühiku- ja integratsioonitestid (osalus, ümardus, valideerimine, elutsüklid, sobitamine, tulemuste kinnitus, samaaegne ost, väljamaksed). Playwright: marsruudid, liitumisvoog, rikked, Pundilive, esineja juhtimine, lõpumenüü. Käivita: npm test, npm run test:e2e.

Ausalt: mis on simuleeritud

Maksed, rahakott, identiteet, sobivuskontroll, piletid, loosimised, ametlikud tulemused, väljamaksed ja teavitused on simuleeritud. Sõprade Baar, tegelased ja jackpot on fiktiivsed. Pundikaart ja partnerkohad on Phase 2 kontseptsioon.