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.