Navodila za uporabo REHAi

Splošno

REHAi je spletna aplikacija za podporo rehabilitacijskemu procesu udeležencev. Aplikacija omogoča vodenje evidence udeležencev in zaposlenih, upravljanje vprašalnikov, izpolnjevanje anket s strani strokovnega osebja in samodejno generiranje strokovnih povzetkov s pomočjo umetne inteligence.

Vloge uporabnikov

V aplikaciji obstajajo tri vloge:

Udeleženec — pacient oziroma oseba v rehabilitaciji. Minimalne pravice.
Zaposleni — strokovno osebje: zdravnik, pedagog, svetovalec, delovni terapevt, psiholog, vodja tima ali tehnolog. Vidi in ureja udeležence, izpolnjuje ankete in generira poročila.
Administrator — polni dostop do vseh funkcij, vključno z upravljanjem uporabniških računov in dodeljevanjem vlog.

Vloge novim uporabnikom dodeli administrator preko sekcije Nastavitve → Uporabniki.

Glavni meni

Glavni meni v levem stolpcu vsebuje vse poglavitne razdelke aplikacije.

Udeleženci

Seznam vseh udeležencev v sistemu. Na tej strani lahko:

Dodate novega udeleženca z ikono + v glavi tabele.
Urejate obstoječega udeleženca z ikono za urejanje (svinčnik) v ukazno vrstici.
Brišete udeleženca z ikono za brisanje.
Med urejanjem udeleženca lahko v spustnem meniju Vprašalnik izberete, kateri vprašalnik je dodeljen temu udeležencu.
Odprete anketo za izpolnjevanje z ikono anketa.
Generirate strokovno poročilo z ikono poročilo (uporablja umetno inteligenco).
Dodelite zaposlene udeležencu z ikono osebe. Na voljo so samo zaposleni, ki so dodeljeni isti območni enoti kot udeleženec.

Tabelo lahko sortirate, filtrirate (preko filterske vrstice ali ikone lijaka v glavi), grupirate (povleci stolpec v glavo nad tabelo) in si izberete vidne stolpce (gumb Pokaži stolpce v orodni vrstici).

Zaposleni

Seznam strokovnega osebja. Na tej strani lahko:

Dodate zaposlenega in mu po želji takoj dodelite uporabniški račun, ali pa račun dodelite kasneje. Zaposleni lahko v sistemu obstaja brez računa — kadrovska služba lahko vnese podatke pred kreiranjem računa s strani IT.
Urejate ali brišete obstoječega zaposlenega.
Dodelite zaposlenemu eno ali več območnih enot z ikono lokacija. To določa, katere udeležence zaposleni vidi.

Vprašanja

Banka vseh vprašanj, ki jih lahko uporabite v vprašalnikih. Vsako vprašanje ima:

Vprašanje — besedilo vprašanja.
Vrsta vprašanja — prosto besedilo, večkratna izbira, enkratna izbira, Da/Ne, ocena, število ali datum.
Vloga — vloga zaposlenega, ki je odgovoren za odgovor (zdravnik, pedagog, ...).
Opis — neobvezen razširjen opis.

Pri vprašanjih tipa Večkratna izbira oziroma Enkratna izbira v urejevalni obliki dodajte možne odgovore.

Upravljanje vprašalnikov

Iz vprašanj iz banke sestavite konkretne vprašalnike. Vprašalnik je razdeljen na razdelke po vlogah zaposlenih — vsak razdelek vsebuje samo vprašanja, ki jih izpolnjuje določena vloga.

Tipičen postopek:

Ustvarite nov vprašalnik z gumbom Nov vprašalnik.
Iz desnega seznama izberete vprašanja iz banke in jih dodate v ustrezen razdelek.
Spremenite vrstni red vprašanj v razdelku, če je potrebno.
Vprašalnik postavite kot Aktiven — samo aktivne vprašalnike je mogoče dodeliti udeležencem.

Nastavitve in administracija

V meniju Nastavitve so trije razdelki:

Območne enote — upravljanje seznama območnih enot. Območne enote uporabljamo za omejevanje vidnosti — zaposleni vidi samo udeležence iz svojih območnih enot.
Vloge (samo za administratorje) — seznam vlog strokovnega osebja (npr. Zdravnik, Svetovalec, Delovni terapevt, Psiholog, Vodja tima, Tehnolog). Pri dodajanju nove vloge sistem v vse Aktivne vprašalnike samodejno doda nov razdelek za to vlogo. Vloge ni mogoče izbrisati, dokler jo uporablja vsaj en zaposleni, razdelek vprašalnika, vprašanje v banki ali mnenje — najprej te reference odstranite ali pretvorite v drugo vlogo.
Uporabniki (samo za administratorje) — upravljanje uporabniških računov in dodeljevanje vlog (Udeleženec / Zaposleni / Administrator).

Izpolnjevanje ankete

Ko zaposleni klikne ikono anketa ob izbranem udeležencu, se odpre obrazec za izpolnjevanje vprašalnika, ki je dodeljen temu udeležencu.

Vprašalnik je razdeljen na razdelke po vlogi — vsak razdelek je viden kot zavihek.
Zaposleni lahko izpolnjuje samo razdelek, ki ustreza njegovi vlogi. Drugi razdelki so označeni z ikono ključavnice in so samo za ogled.
Odgovori se shranjujejo samodejno. Status v desnem spodnjem kotu prikazuje Shranjevanje... oziroma Samodejno shranjeno.
Pri vprašanjih tipa Večkratna izbira z možnostjo "drugo" lahko ob izbiri možnosti vpišete tudi prosto besedilo.

Pomembno: če udeleženec še nima dodeljenega vprašalnika, anketa ni dostopna. Vprašalnik dodelite preko urejanja udeleženca v sekciji Udeleženci.

Generiranje poročila

Ko zaposleni klikne ikono poročilo ob udeležencu, sistem preveri, ali poročilo za tega udeleženca že obstaja:

Če poročila še ni, sistem pošlje vprašanja in trenutne odgovore v AI model (privzeto slovenski gams-27b), počaka na odgovor in shrani povzetek kot poročilo. Brskalnik nato prenese PDF datoteko prek HTTP endpointa /reports/patient/<id>.pdf — datoteko boste videli v običajnem prenosnem oknu vašega brskalnika.
Če poročilo že obstaja, sistem prikaže pogovorno okno z dvema možnostma:
- Prenesi obstoječe — uporabi že obstoječe poročilo, brez nove obdelave AI.
- Ustvari novo — pobriše obstoječe poročilo in sproži novo AI obdelavo. Uporabno, kadar so se odgovori po prvi generaciji spremenili.

Generiranje novega poročila lahko traja nekaj minut, odvisno od dolžine vprašalnika in zmogljivosti AI strežnika.

Če AI strežnik ni dosegljiv, model ni naložen ali odgovori ne obstajajo, brskalnik prikaže sporočilo s podrobnostmi napake (npr. "Poročila ni mogoče ustvariti"). Administrator lahko spremeni naslov in ime modela v appsettings.json pod ključem Ollama brez ponovne prevedbe.

Dnevnik dejavnosti

Aplikacija beleži vse pomembne spremembe podatkov in dogodke prijave/odjave. Dnevnik je dostopen samo administratorjem prek menija Nastavitve → Dnevnik ali prek kartice na domači strani.

Vsak vnos v dnevniku vsebuje:

Čas — kdaj se je dogodek zgodil (lokalni čas).
Uporabnik — e-pošta uporabnika, ki je sprožil dogodek.
Akcija — vrsta dogodka (Ustvari, Posodobi, Posodobi (kaskada), Izbriši, Odgovor, Prijava, Neuspela prijava, Zaklenjen račun, Odjava). Vsaka akcija ima svojo barvno oznako.
Tip — tip podatka, na katerega se dogodek nanaša (npr. Udeleženec, Zaposleni, Vloga, Vprašalnik, Odgovor udeleženca).
Opis — človeški opis (npr. ime udeleženca, naslov vprašalnika).
IP — IP naslov, s katerega je bil dogodek sprožen.
Podrobnosti (ikona vprašaja na desni) — odpre okno z JSON detajli sprememb, vključno s starimi in novimi vrednostmi polj.

Z gumbi na vrhu lahko filtrirate vnose po datumskem obdobju in nastavite, koliko najnovejših vrstic naj se prikaže (100 / 500 / 1000 / 5000). Vsi stolpci tabele podpirajo tudi filtersko vrstico in sortiranje.

Pomembno za izpolnjevanje anket: vsaka sprememba odgovora se zapiše kot en vnos akcije Odgovor s polno staro in novo vrednostjo (pri večkratni izbiri so navedeni vsi izbrani odgovori po besedilu). Identične spremembe (npr. ko uporabnik klikne stran brez spremembe) se v dnevnik ne zapisujejo.

Tehnične zahteve

Sodoben spletni brskalnik (Chrome, Firefox ali Edge — najnovejša verzija).
Za funkcionalnost generiranja poročil mora biti v omrežju dostopna storitev Ollama z naloženim jezikovnim modelom (priporočeno slovenski gams-27b ali gams3-12b). Naslov strežnika in ime modela se nastavita v appsettings.json pod ključem Ollama.
Aplikacija je razvita s tehnologijo .NET 9 Blazor Server in komponentami DevExpress Blazor.