Tõrkejuhend runbook
📚 Juhendid

🛟 Tõrkejuhend (runbook)

Kiired lahendused levinud probleemidele. Esimene samm on alati: 🛟 Abi (vasakul all) → KKK ja „Teadaolevad probleemid“ — kui see on juba teada, on seal ka lahendus või ajahinnang.

Sihtrühm: staap / admin / IT · Viimati uuendatud: 2026-10-17

🦺 Reguleerija (regulators.html)

Ei saa end „kohale“ märkida

Veateade too_far, too_early, too_late_window, no_gps, open_elsewhere.
  1. too_far → liiga kaugel positsioonist. Palu liikuda postile (avatum koht = parem GPS), vajuta „Uuenda minu asukohta“.
  2. no_gps → luba brauseris asukoht, ava HTTPS aadress, lülita täpne asukoht sisse.
  3. too_early / too_late_window → väljaspool planeeritud tööaega. Kontrolli määrangut: tööruum → Liikluskorraldus → Reguleerijad.
  4. open_elsewhere → tal on avatud sessioon teisel positsioonil. Staap → Aktiivsed → Sulge.
  5. Kood ei kehti → positsioon pole kaardil või kood on vale (nt R203 vs R-203).

QR ei avane / üritust ei leita

  1. Ava link käsitsi; sisesta positsiooni kood üldlehel (regulators.html?event=…).
  2. Reguleerija äpp näitab ainult avaldatud üritusi. Kontrolli tööruumis, et üritus on avaldatud.
  3. QR on vana ürituse oma → prindi uued: tööruum → Töötajate juhendid (ürituse id lingis).

Vestlus, häälsõnum või SOS ei jõua staapi

  1. Vestlus ja intsident nõuavad avatud sessiooni (seadme token). Kui sessioon on suletud, märgi uuesti kohale.
  2. SOS läheb alati läbi, ka ilma tokenita (märgitakse „tõendamata seade“).
  3. Häälsõnum: brauser peab lubama mikrofoni; tekst korrastatakse AI-ga ainult siis, kui omanik on AI sisse lülitanud. Muidu läheb toortekst.
  4. Sagedus: 20 sõnumit/min, 5 intsidenti/min, 15 häälsõnumit/min positsiooni kohta — rohkem lükatakse tagasi (rate_limited).

Staabi telefoni ei näe äpis

  1. Staap → Ülevaade → „📞 Staabi telefon välitöötajatele“ — sisesta number. Seda näeb ainult tõendatud seade.

🚧 Liikluskorraldaja (traffic.html)

Ei saa lõiku muuta või vestlus ei saada

  1. Ilma pääsukoodita on vaataja režiim. Sisesta kehtiv kood (suurtähed, nt T1). Vestlus nõuab samuti koodi.
  2. invalid_code → kood on tühistatud; uus kood: tööruum → Liikluskorraldus → Liikluskorraldajad (pääsukoodid).
  3. Võrguta: äpp näitab viimast seisu ja saadab muudatuse, kui ühendus taastub.

🎯 Staap (staff.html)

Heli ja märguanded ei tööta

  1. Vajuta üleval „🔔 Luba heli“ (iga kord pärast lehe avamist). Kontrolli, et seade pole hääletul.

Valvur annab valehäireid („vaikne seade“, „ei ole kohal“)

  1. „Vaikne seade“ = heartbeat puudub > 3 min: töötaja telefon on võrguta või äpp taustal. Helista. „Ei ole kohal“ = planeeritud algus möödas ilma sessioonita.

SMS ei saadeta

  1. Kui SMS-teenust ei ole ühendatud, on süsteem demorežiimis: sõnum logitakse olekuga „demo“, päris SMS-i ei saadeta. Ühendamine: Supabase secretid MESSENTE_USER / MESSENTE_PASS (omanik).
  2. „plan_sms_limit“ → organisatsiooni paketi kuulimiit on täis (Owner Console → Arveldus).

Kirjad ei ilmu vahelehele „Kirjad“

  1. Kiri kuulub ürituse juurde ainult siis, kui vorm avati ürituse lehelt (contact.html?event=…). Vanad kirjad ilma ürituseta näeb ainult omanik.

⚙️ Tööruum (admin.html)

Muudatused ei ilmu avalikule lehele

  1. Vajuta ⬆️ Avalda. Avalikule lehele lähevad ainult avalikuks märgitud objektid (nähtavus „avalik“).
  2. Lõikude olek, bussid (transport) ja ÜT muudatused uuenevad ilma kaardi avaldamiseta; ÜT muudatus vajab linnukest „avalik“.

Exceli import ebaõnnestub

  1. Kasuta süsteemi enda eksporditud malli (A4, pealkirjaplokiga). Importija otsib päiserea ise; kui veerunimed on muudetud, näitab eelvaade hoiatust.
  2. Eelvaade näitab erinevust salvestatud versioonist — kontrolli enne „Salvesta süsteemi“.
  3. Reguleerijate import: positsioonikoodid peavad vastama kaardi positsioonidele.

Kaardi joon „teele tõmbamine“ (snap) ei anna tulemust

  1. OSRM/Google teenus vastas veaga või joon on teedest kaugel. Proovi väiksema raadiusega, või joonista käsitsi. Vale tulemuse saab tagasi võtta: Kaart → 🕘 Ajalugu / Võta tagasi.

Dropboxi / My Mapsi import

  1. Import käib ühekordse hooldustokeniga (omanik). Faili URL peab olema Dropboxi oma; muu domeen lükatakse tagasi (SSRF-kaitse).

🔗 Lingiga kasutajad (partner, amet, pass)

Link ütleb „link puudub“ või „tühistatud“

  1. Partner: tööruum → Partnerid → partner → „Loo link“ (vana link lakkab töötamast). Amet: ÜT ja ametid → Ametiasutused → link.
  2. Pass: Mobility and Accesses → Passid & QR → väljasta uuesti. Inimene peab olema aktiivne.
  3. Linki näidatakse ainult korra loomisel; andmebaasis on ainult räsi. Kadunud link = uus link.

🤖 AI, ilm ja välised andmed

AI-abiline, elanike teavitus või tugipöördumise struktureerimine ei tööta

  1. Owner Console → Seaded → AI lüliti peab olema sees. Väljas olles salvestub pöördumine ilma AI kokkuvõtteta.
  2. ai_limit → organisatsiooni paketi kuulimiit; ai_key_invalid → Supabase secret ANTHROPIC_API_KEY (omanik).

Ühistranspordi peatused puuduvad (ÜT ja ametid → Mõjutatud peatused)

  1. Vajuta „Värskenda Tallinn“ (transport.tallinn.ee töötab). Riiklik GTFS vajab aadressi: Owner Console → Seaded → „Riiklik ÜT andmebaas (GTFS)“. Sünkroonitakse kõige rohkem kord 30 min jooksul.

Rajakoormus / suur ekraan ei näita võistlejaid

  1. Reaalajas režiim vajab Tolkneti ajavõtu võistluse id-d (course-load.html seaded). Plaan/simulatsioon kasutab eelmise aasta mustrit ja tegelikku starti.

🧰 Tehnika ja ligipääs

Kaart on hall / ei lae

  1. Internet, värskenda. Kui kõigil sama → Google Mapsi võtme referrer-piirang või kvoot (Google Cloud; vt Avaldamine ja turvalisus).

Edge Function annab vea (502 / server_error)

  1. Supabase → Functions → logid. Kontrolli FN_BASE config.js-is ja secreteid. Ajutine tõrge → telefon/SMS varukanal, korda hiljem.

Kasutaja ei saa sisse / ei näe üritust

  1. Owner Console → Kasutajad: kas konto on blokeeritud? Kas ta on ürituse meeskonnas (tööruum → Meeskond)?
  2. Kutse ei tööta → uus kutse (vt Kutse ja konto).

🚨 Eskalatsioon

Eluohtlik olukord → 112 kohe.

Süsteemi viga → 🛟 Abi → „Saada pöördumine“ (jõuab IT postkasti Owner Console → Tugi; kriitiline 15 min, kõrge 60 min). Võistluspäeval lisaks telefon +372 511 3525.

Kui veeb ei tööta üldse → telefon/SMS, prinditud juhendid ja reguleerijate infolehed (PDF) käes.

Event Mobility Partners · Safe Infra OÜ · +372 511 3525