tvz-rezervator-bot v1.0.2

Rezervator bot za moj.tvz.hr

Bot za rezervaciju termina lab. vježbi na moj.tvz.hr

Projekt je neovisan i ne asocira se s TVZ-om

Sve što botu treba su informacije o terminu i on će obaviti prijavu. Bot korisiti Telegram za komunikaciju. Nakon uspješne rezervacije bot će poslati poruku

Instalacija

Potrebo je samostalno hostati bota jer botu trebaju senzitvne informacije poput lozinke i emaila

Potrebni alati:

• Node.js v16+
• npm/yarn/pnpm

pnpm -g i tvz-rezervator-bot # ili
npm -g i tvz-rezervator-bot # ili
yarn global add tvz-rezervator-bot

Kreiranje Telegram bota

Tutorial za kreiranje bota

Env varijable

Lista varijabla koje su potrebne za rad bota:

• TVZ_EMAIL - @tvz.hr email
• TVZ_PASSWORD - lozinka
• TG_SECRET - secret koji se dobije kreacijom bota

Varijable TVZ_EMAIL i TVZ_PASSWORD jedno se koriste za login na moj.tvz.hr, spremljene su na disk, te enkriptirane (u svrhu pomućivanja)

Postavljanje varijabla

rez-bot set TVZ_EMAIL iprezime@tvz.hr
rez-bot set TVZ_PASSWORD moj_pass
rez-bot set TG_SECRET ovo_je_ta_tajna

Pokretanje

rez-bot

Nakon pokretanja bot je spreman za korištenje. U slučaju greške pri radu, bot će se automatski restartati

Korištenje

Najprije treba "zaključati" bota

/lock

Dodavanje rezervacije

Bot će sam pronaći sve termine i skupine na danoj stranici kolegija

/schedule <link> # alias s

Također je moguće ručno dodati rezervaciju

/schedule <link> <text skupine> <text termina> <vrijeme>

Primjer

/schedule https://moj.tvz.hr/studijrac/predmet/123456 "​2​2./​2​3." "SRIJEDA 10:00" 17:35-7.2.2023

Warning Tekst u zagradama mora odgovarati tekstu na stranici!

Kako odabrati dobar <text skupine> i <text termina>

Bilo bi dobro da odabrani tekst ne sadrži promjenjive informacije poput broja grupa ili maks. broja studenata

Za danu skupinu primjer dobrog <text skupine> je Laboratorijske vježbe 22./23.

Za dani termin primjer dobrog <text termina> je ČETVRTAK: 12:30 - 14:00 (MS LAB)

Brisanje rezervacije

/delete <id> # alias /d

Za brisanje svih

/delete *

Lisanje rezervacija

/list # alias /ls

Bilo bi dobro imati

• Rezervacije na LMS-u (lms-2020.tvz.hr)