🍦 Tuutti docs

Asiakkaan polku

Tämä on asiakkaan näkemä polku — joko puhelimella QR-koodin kautta tai suoraan kioskin verkko-osoitteen kautta.

1. Skannaa QR-koodi

Tiskille on kiinnitetty QR-koodi (luotu Asetukset → QR-koodi -näkymässä, A4-juliste). Asiakas skannaa sen iPhonen tai Androidin kameralla, ja puhelin avaa kioskin osoitteen <sluginimi>.tuutti.io.

Vaihtoehtoisesti asiakas voi kirjoittaa osoitteen suoraan selaimeen.

2. Valitse tuotteet

Valikko on jaettu tuoteryhmiin (Jäätelöt, Pehmis, Juomat, Muut). Jokaisesta tuotteesta näkyy:

  • Pieni tuotekuva (jos asetettu)
  • Tuotteen nimi
  • Hinta (yhdelle pallolle / annokselle)

Klikkaamalla tuotetta avautuu tuoteruutu, jossa asiakas voi:

  • Lukea lyhyen kuvauksen ja markdown-pohjaisen pidemmän kuvauksen
  • Valita modifierit (esim. vohveli, palloja-määrä, lisukkeet)
  • Jos valittu “2 palloa” tai enemmän → valita kaverin palloihin sopivat maut (companion picker)
  • Lisätä tilaukseen

3. Tarkista kori

Asiakas voi avata koriin sivun (näkyy oikealla alhaalla “Kori · N”). Korissa:

  • Lista tilaukseen lisätyistä tuotteista yhden klikkauksen alla
  • Jokainen rivi näyttää määrän, tuotenimen, lisukkeet ja yhteishinnan
  • Asiakas voi muokata kutakin riviä (tap → modifier-ruutu auki)
  • Asiakas voi erotella yhden tuotteen omaksi riviksi, jos haluaa erilaiset modifierit yhdelle annokselle (esim. yksi kahvi sokerilla ja yksi ilman → “Erota yksi”)

4. Maksu

Korissa “Maksuun”-painike → maksuvalintanäkymä. Tarjolla:

  • Apple Pay (iPhone, jos kortti tallennettu)
  • Google Pay (Android, jos kortti tallennettu)
  • Kortti (pankki- tai luottokortti — Stripe Payment Element)
  • Linkki (jos asiakas on käyttänyt Stripe Linkiä aiemmin)
  • Maksa tiskillä (vain manuaalisessa jonotilassa)

Maksu menee suoraan kioskinpitäjän pankkitilille. Tuutin osuus (5 % + 0,25 €) vähennetään automaattisesti.

Asiakas voi syöttää sähköpostin saadakseen kuitin PDF:nä. Mikäli ei syötä, kuittia ei lähetetä — mutta asiakas voi pyytää kuittia jälkikäteen avaamalla tilausnäkymän ja klikkaamalla “Lähetä kuitti”.

5. Tilauksen tila

Maksun jälkeen asiakas siirtyy tilausnäkymään, jossa näkyy:

  • Tilauskoodi — kolminumeroinen luku (esim. 491), jonka kioski käyttää tunnistamaan asiakas valmistuksen jälkeen
  • Tila — Maksamatta / Jonossa / Valmistuksessa / Valmis / Noudettu
  • ETA — arvioitu valmistumisaika sekuntipoolissa (vain kun joku on tilattuna; muuten “Olet seuraavana jonossa”)
  • Tuoteyhteenveto — mitä tilattiin
  • Toimintoja — selainilmoitusten aktivointi, kuitin pyytäminen, nimen muokkaus tilaukseen, tilauksen peruutus

Asiakas voi pitää sivua auki — se päivittyy automaattisesti reaaliajassa (SSE-yhteys palvelimelle). Kun henkilökunta merkitsee tilauksen Valmiiksi, sivu päivittyy vihreäksi ja täri-ilmoitus (Android) + selainilmoitus (jos sallittu) laukaisee asiakkaan ottamaan tilaus tiskiltä.

Palaa tilaamaan myöhemmin

Tuutti muistaa asiakkaan paikallisesti selaimessa (IndexedDB) — hänen ei tarvitse rekisteröityä. Jos hän palaa samalla puhelimella samalle kioskille:

  • Aiemmin annetut yhteystiedot ovat valmiina (sähköposti, nimi, puhelin)
  • Aiemmat tilaukset näkyvät /my-orders -sivulla
  • “Lähetä kuitti uudelleen” toimii myös vanhemmille tilauksille

Saavutettavuus

Koko asiakassovellus on suunniteltu mobiilipohjaiseksi ja noudattaa WCAG 2.1 AA -tasoa. Tuetut näytönlukijat (VoiceOver, TalkBack) saavat tilaisuuden lukea tuotteet, modifierit ja maksuvaihtoehdot luonnollisessa järjestyksessä.