Projekti: Tietovisa pikkujouluihin

Edellisessä artikkelissa toteutettiin Onnenpyörä pikkujouluihin. Tässä artikkelissa esitellään toinen pikkujouluprojekti, nimittäin Tietovisa.

Tarve syntyi oikeastaan siitä, että halusimme järjestää tietovisan, johon osallistutaan mobiililaitteilla. Tähän on olemassa maksullisiakin ratkaisuja, mutta mieleen tuli idea: mitä jos antaisi tekoälylle komennon: rakenna tietovisa pikkujouluihin? Kuinka nopeasti toimiva versio syntyisi? No kun kerran asiaa jo pohdittiin, niin eihän sitä voinut olla kokeilematta!

Suunnittelusta toteutukseen

Tietovisalle muodostettiin ensin suunnitelma ChatGPT:llä. Se teki melko pitkän ja yksityiskohtaisen suunnitelman, joka kopioitiin sellaisenaan Cline -työkalulle ja käynnistettiin toteutus DeepSeek v4.1 Flash -mallilla.

Suunnitelma perustui Next.js -sovellukseen, joka sisältää samassa kokonaisuudessa kaikki frontendit (juontajan ja pelaajan frontend) sekä backendin.

Tietokantakin tarvittiin kilpailujen tilan säilyttämiseen. ChatGPT ehdotti Supabase-tietokantaa ja sehän kuulosti oikein hyvältä vaihtoehdolta! Supabase tarjoaa helposti perustettavia ja hallittavia tietokantapalveluja, tässä kevyessä käyttötapauksessa vieläpä täysin ilmaiseksi!

Kuva: Supabasen mainontaa

Perustin ennen toteutuksen käynnistämistä Supabase-tietokannan ja laitoin sen asetukset .env -tiedostoon.

Supabasessa on myös kätevä integraatio GitHub-repositorioon, jolla tietokannan migraatiot saa ajettua automaattisesti: kun repon main-haaraan pusketaan uusia migraatiotiedostoja, Supabase ajaa ne automaattisesti tietokantaan! Voiko enää helpommaksi mennä!

Kuva: Supabasen integraatio Github-repoon

Juuri muuta ei tarvinnutkaan etukäteen tehdä ennen toteutuksen käynnistämistä. Eli ei muuta kuin DeepSeek töihin!

Toteutus valmis!

Toteutustyö eteni itsenäisesti sillä välin kun tein töitä toisella koneella.

Reilun tunnin kuluttua ensimmäinen versio olikin jo valmis.

Ensimmäinen versio oli hämmästyttävän toimiva ja sitä pääsi testaamaan oikeilla käyttäjillä saman tien. Kokonaisuuteen oli koodattu myös kattavat testit.

Todellisissa testeissä tuli mutama löydös, mutta ne korjaantuivat nopeasti lisäprompteilla.

Aloitussivulla on kaksi suurta korttia: Olen juontaja ja Liity peliin.

Kuva: etusivu lopullisessa muodossaan

Juontajan näkymä on suunniteltu niin että se heijastetaan projektorilla valkokankaalle. Kun uusi tietovisa perustetaan, tietovisalle muodostuu kuusinumeroinen liittymiskoodi ja QR-koodi jonka avulla pelaajat pääsevät helposti liittymään visaan.

Kuva: tietovisan liittymisnäyttö eli ”lobby”
Kuva: Peli käynnissä. Vasemmalla näkyy juontajan näyttö ja oikealla pelaajan samanaikainen näyttö.

Pelaajan näkymä on optimoitu puhelinkäyttöön: neljä suurta värillistä vastauspainiketta, jotka vievät suurimman osan ruudusta, ei vaakasuuntaista vieritystä ja selkeä vahvistus siitä, että vastaus on tallennettu. Vastausvaihtoehtojen värit ovat punainen, sininen, keltainen ja vihreä.

Pelin päättyessä näytetään voittaja ja konfettiefekti.

Jo ensimmäinen versio oli visualisesti varsin miellyttävä ja värikäs! DeepSeek ymmärsi selvästi, millaista tyyliä tavoiteltiin. Viimeistelyvaiheessa lisäsin vielä taustakuvan sekä muutamia tekoälylllä generoituja robottikuvia, jolloin ulkoasu alkoikin olemaan jo varsin hieno.

Turvallisuusratkaisut

Sovellus on netissä julkisesti ilman kirjautumista, joten tietoturva piti ratkaista istuntotokeneilla.

Keskeiset ratkaisut:

  • Rivitason tietoturva (RLS) on päällä kaikissa tietokannan tauluissa eikä yhdellekään roolille ole tehty RLS-policyä. anon ja authenticated eivät voi lukea eivätkä kirjoittaa mitään suoraan. Tauluilta ja funktioilta on peruttu oikeudet ja EXECUTE on myönnetty vain palvelinpuolen service_role-roolille.
  • Tietokannan palvelinavain on vain palvelimella. Se on ympäristömuuttujassa ilman NEXT_PUBLIC_-etuliitettä joten se ei näy React-frontendeille. server-only-importti estää käännösvaiheessa sen, että jokin selaimessa ajettava moduuli yrittäisi käyttää sitä.
  • Istuntotokenit ovat 256-bittisiä satunnaislukuja, ja tietokantaan tallennetaan vain SHA-256-tiiviste. Vertailu tehdään vakioaikaisesti, jottei tokenia voi arvata ajoituksesta.
  • Tokenit kulkevat headereissa, eivät koskaan URL-osoitteessa. Ne säilytetään selaimen localStoragessa, joten sivun päivittäminen kesken pelin ei hukkaa pelipaikkaa.
  • Oikea vastaus ei koskaan vuoda selaimeen ennen tulosvaihetta. Kysymyksen julkinen muoto rakennetaan palvelimella erikseen ja vastaus välitetään selaimeen vasta kun kysymys on päättynyt.
  • Rajoituksia per IP-osoite: huoneen luonti 20 kpl/min ja 60 kpl/h, liittyminen 250 kpl/min, vastaukset 500 kpl/min ja juontajan komennot 120 kpl/min, tilakysely 20 000 kpl/min. Rajoja asetettaessa varauduttiin kevyesti myös siihen, että useampi mobiililaite voisi periatteessa näkyä samalla IP:llä.
  • Kun juontaja perustaa uutta pelihuonetta, vaaditaan salasana. Salasana on määritetty palvelimen ympäristömuuttujassa. Vertailu tehdään vakioaikaisesti tiivisteitä vertaamalla, eikä salasanaa koskaan palauteta vastauksissa eikä kirjoiteta lokiin.
  • Vanhat pelihuoneet siivotaan automaattisesti 24 tunnin jälkeen uuden huoneen luonnin yhteydessä, joten kantaan ei kerry roskaa eikä erillistä ajastettua tehtävää tarvita.

Reaaliaikaisuus

Pisteet, pelaajalista ja vastausmäärä päivittyvät kaikilla laitteilla samaan aikaan. Tämän olisi voinut toteuttaa Supabasen Realtime-ominaisuuksilla, mutta ratkaisu perustuu kuitenkin pollaukseen: selain hakee roolikohtaisen tilan palvelimelta noin sekunnin välein (juontaja 900 ms, pelaaja 1100 ms).

Deepseek perusteli valintaa tietoturvalla. Realtime-kanava ei ole käyttöoikeuksien hallinnan kannalta hyvä ratkaisu: jotta selain voisi tilata taulukohtaisia muutoksia, anon-roolille pitäisi avata lukuoikeus tauluihin, mutta rooms-taulussa oli jo juontajan tokenin tiiviste ja answers-taulussa kaikki vastaukset. Ratkaisulla varmistetaan että oikea vastaus ei koskaan vuoda selaimeen ja että jokainen näkee vain omat tietonsa.

Sekunnin välein toistuva kysely voi olla melko raskas jos pelaajia on paljon. Kyselyä optimoitiin jälkikäteen kahdella tavalla:

  1. Tilannekyselyn vastaus sisältää aggregaatit, ei vastausrivejä. Ensimmäisessä versiossa jokainen kuluvan kysymyksen vastausrivi siirtyi tietokannasta palvelimelle jokaista kyselyä kohti; 30 pelaajan huoneessa noin 30 × 7 kenttää sekunnissa. Parannetussa versiossa tietokanta palauttaa vain vastausten määrän, jakauman (neljä lukua) ja kysyvän pelaajan oman vastauksen.
  2. Vastaus on ehdollinen (ETag). Palvelin laskee tilan sisällöstä tunnisteen ja vastaa 304 Not Modified ilman runkoa, jos tila on ennallaan verrattuna edelliseen vastaukseen. Selain säilyttää silloin aiemman tilansa eikä renderöi uudelleen.

Testit

Pelilogiikassa on paljon sääntöjä, joiden rikkoutuminen ei näy käyttöliittymässä mitenkään. Väärin laskettu pistemäärä näyttää aivan yhtä hyvältä kuin oikein laskettu. Siksi kattavat testit on hyvä idea.

Yksikkö- ja integraatiotestejä on peräti 139 kappaletta, ja niiden hienoin ominaisuus on, että tietokantatestit ajetaan oikealla PostgreSQL-moottorilla: PGlite on PostgreSQL WebAssemblyssä. Testit ajavat samat migraatiotiedostot kuin tuotanto. Näin tilakoneen atomisuus, rajoitteet ja RLS tulevat oikeasti testatuiksi.

Selaintason testit (6 kpl, Playwright) ajetaan oikeaa Supabase-projektia vasten, koska ne käyttävät oikeita istuntotokeneita ja palvelinpuolen pisteytystä. Ne kattavat kriittiset polut: huoneen luonti, kahden pelaajan liittyminen, kysymys–vastaus–tulosvaihe–tulostaulu, pelin päättäminen ja kysymyksen keskeyttäminen.

Peliä myös testattiin oikeilla käyttäjillä ja heti ensimmäiset palautteet olivat positiivisia: tämähän toimii!

Julkaisun automatisointi

Tällä kertaa toteutettu ratkaisu ei perustunut AWS:n Serverless-tekniikoihin, kuten projektini monesti ovat perustuneet. Next.js -sovelluksen julkaisu on kuitenkin erittäin helppoa Vercel -palvelun kautta.

Vercel tarjoaa monenlaisia palveluita, mutta tässä tapauksessa hyödynnettiin Vercelistä vain automaattista julkaisua.

Kuva: Vercelin mainontaa

Kun Verceliin luo projektin, yhdistää projektille Github-repositorion ja määrittää tarvittavat ympäristömuuttujat sovelluksen käyttöön, julkaisu on sen täysin automaattista: aina kun versionhallintaan tulee uutta koodia, sovellukselle tehdään uusi asennus.

Kuva: Vercel julkaisee automaattisesti uuden version kun repoon tulee muutoksia

Sovellus saa myös oman, ihan hienon oloisen osoitteen sovellusnimi.vercel.app.

Vercelin ilmaisversiossa on toki rajoituksia, mutta juuri tähän käyttötapaukseen se oli varsin riittävä.

Ilmainen deploy-automatiikka ja sovelluksen hostaus, kyllä kiitos!

Yhteenveto

Olen erittäin tyytyväinen lopputulokseen!

Tällä kertaa DeepSeek toteutti tietoturvan jopa paremmin kuin satunnaiseen käyttöön tehdylle pelille olisi ollut tarpeen. Oli kuitenkin varsin opettavaista lukea perusteluja ratkaisuille ja vakuutuin DeepSeekin koodauksen tasosta; tämä tuotos kelpaa kyllä tosikäyttöön!

Integraatiot auttoivat helppoon tuotannon hallintaan: Vercel julkaisee sovelluksen uusimman version heti kun tehdään push versionhallintaan ja Supabase huolehtii tietokannan migraatiot yhtä lailla itsenäisesti kun versionhallintaan tulee migraatiotiedosto.

Ensimmäinen ratkaisu syntyi varsin nopeasti, mutta käytin vielä aikaa ulkoasun paranteluun sekä suorituskyvyn varmistamiseen.

Tämä projekti osoitti taas kerran, kuinka nopeasti nykyään pystyy kehittämään räätälöidyn ohjelmiston ja asentamaan sen ajoon.