Varausmoduuli

Varausmoduuli on Hobin moduuli seuran tilojen, välineiden ja muiden resurssien varaamiseen ja lainaamiseen. Se sopii ylläpitäjille ja jäsenille — tämä sivu kuvaa käytännön toimintaa, ei teknistä API-dokumentaatiota.

Jäsenille moduuli näkyy nimellä Varaukset. Tekninen tunniste järjestelmässä on edelleen lending (URL-polut, API, oikeudet).

Moduuli käyttää yleensä jäsenrekisteri- ja maksu-moduuleja. Lainaaja on jäsen (tai vieras, jos säännöt sen sallivat); maksulliset aikavaraukset syntyvät jäsenen saldoon.

Johdanto

Moduuli kattaa:

• Lainattavat resurssit — tilat, välineet, kirjat, pelit tai muut seuran omistamat asiat, joita jäsenet voivat varata tai lainata.
• Aikataulut — milloin resurssi on varattavissa (toistuvat ajat, kertaluontoiset ajat tai iCalendar-syöte).
• Varauslogiikka — kenelle varaus on sallittu, vaatiiko se vahvistuksen, millaiset rajoitukset ja hinnat koskevat varaajaa.
• Varaukset (lainaukset) — jäsen varaa ajan tai kappaleen; ylläpito näkee ja hallitsee varauksia.
• Estetyt ajat — ulkoiset kalenterit tai aikataulut, jotka merkitsevät resurssin jo varatuksi.

Tyypillisiä käyttötapauksia: salin tai saunan aikavaraus, pelitilan varaaminen, lainattavan välineen hallinta.

Sanasto

Kenelle sopii?

• Seurat ja kerhot, joilla on yhteisiä tiloja (sali, sauna, pelitila)
• Yhdistykset, joissa jäsenet varaavat välineitä tai muita resursseja
• Tilanteet, joissa eri ryhmille (jäsenet / vieraat) tarvitaan eri säännöt tai hinnat

Jäsenen näkymä

Kirjautuneelle jäsenelle osoitteessa /lnd (Varaukset):

• Lainattavat resurssit — lista aktiivisista resursseista.
• Resurssisivu — kalenteri (tai lista) vapaista ja varatuista ajoista.
• Varauksen tekeminen — valitse päivä ja aikaväli aukiolojen sisältä, vahvista varaus.
• Oma varaus — näet omat varauksesi; voit täydentää lisälomakkeen ja peruuttaa tulevan varauksen.
• Etusivu — tulevat omat varaukset näkyvät etusivun tapahtumissa.

Varaus vaatii yleensä kirjautumisen ja jäsenprofiilin. Jos resurssilla on pakollinen lisälomake, varaus jää odottamaan, kunnes lomake on täytetty.

Aikavarauksen tekeminen

1. Avaa resurssi listasta.
2. Valitse kalenterista päivä, jolla on vapaita aikoja.
3. Valitse alku- ja loppuaika aukioloikkunan sisältä (voit varata myös osan ikkunasta).
4. Vahvista varaus (Varaa).

Kalenteri näyttää vapaat, osittain varatut ja täynnä olevat ajat. Toisten jäsenten varauksista voi näkyä julkinen otsikko ja kuvaus, jos ne on annettu.

Peruutus

• Jäsen voi perua tulevan varauksen, joka ei ole vielä alkanut.
• Mennyttä tai jo alkanutta varausta ei voi perua itse.
• Peruutus vapauttaa ajan muille.

Ylläpidon näkymä

Navigaatio

Hallintapaneelissa Varaukset:

• Lainaukset — kaikkien varausten lista ja muokkaus.
• Lainattavat — resurssien luonti ja muokkaus (varauslogiikka, estetyt ajat).
• Aikataulut — aikataulujen luonti, iCalendar-synkronointi ja .ics-lataus.

Resurssin luonti (aikavarattava)

1. Luo tarvittaessa aikataulu (Aikataulut) — nimi, toistuvat tai kertaluontoiset ajat, tai iCalendar-osoite / .ics-tiedosto.
2. Luo lainattava resurssi tyypillä Aikavarattava, anna nimi ja aktivoi resurssi.
3. Lisää varauslogiikka: säännön nimi, kenelle se koskee, varaustapa, rajoitukset, aikataulut ja mahdollinen hinta.
4. Lisää tarvittaessa estetyt ajat ulkoisista kalentereista.

Säännöt voi myös kopioida toiselta resurssilta (monista säännöt tai käytä jaettuja sääntöjä).

Aikataulut

Aikataulu määrittää varattavat ajat:

Aikataululle voi asettaa suodattimen (esim. otsikon perusteella), jolloin vain sopivat tapahtumat otetaan mukaan synkronoinnissa.

Kapasiteetti aikataulussa kertoo, montako samanaikaista varausta samaan ikkunaan mahtuu (usein 1 tilavarauksessa).

Estetyt ajat

Resurssille voi liittää aikatauluja, joiden tapahtumat merkitään jo varatuiksi. Näin ulkoinen käyttö (esim. toinen varausjärjestelmä tai henkilökunnan kalenteri) estää päällekkäiset varaukset Hobissa.

Varauslogiikka

Yhdellä resurssilla voi olla useita sääntöjä. Järjestelmä käy säännöt järjestyksessä ylhäältä alas ja käyttää ensimmäistä, jonka Koskee-ehto täyttyy varaajalle.

Laita tarkemmat ehdot (esim. varsinaiset jäsenet) ylös ja yleinen oletussääntö viimeiseksi, jotta oikea sääntö osuu oikealle ryhmälle.

Varaustavat

Esimerkki: eri säännöt jäsenille ja vieraille

1. Sääntö jäsenet — koskee kirjautuneita / varsinaisia jäseniä, välitön varaus, edullisempi hinta.
2. Sääntö vieraat — koskee kaikkia (tyhjä ehto), odota vahvistus.

Kirjautunut jäsen osuu ensimmäiseen sääntöön; ilman jäsenprofiilia varaus voi osua vierassääntöön, jos se on määritelty.

Hinnat ja maksut

Aikavarattavalle resurssille hinta määritellään säännön aikataululinkissä:

• Hinta per minuutti, tunti tai päivä.
• Varauksen kesto pyöristetään ylöspäin laskutusyksikköön (esim. 1,5 h → 2 tuntia tuntiveloituksella).
• Jos varaus ylittää useamman eri hintaisen aikataulun jatkuvan jakson, hinta lasketaan osissa (kukin jakso omalla hinnallaan).
• Maksuton aikataulu = ei veloitusta.

Vahvistettu / aktiivinen maksullinen varaus luo veloituksen jäsenen saldoon Hobin maksu-moduulin kautta. Peruutus tai poistaminen poistaa vastaavan veloituksen.

Varauksen tilat

Käyttöoikeudet

Ilman hallintaoikeuksia jäsen näkee vain oman varausnäkymän (/lnd) ja omat varauksensa.

Integraatiot

Jäsenyysmoduuli (membership)

• Lainaaja on tyypillisesti jäsen. Ehdot (Koskee) käyttävät samoja jäsenkenttiä kuin maksujen hinnoittelu (esim. varsinainen jäsen).
• Ilman profiilia varaus voidaan estää tai ohjata vierassääntöön.

Maksutmoduuli (payments)

• Aikavarauksen hinta syntyy saldoveloituksena varaukseen liittyen.
• Jäsen maksaa Hobin yleisen maksuvirran kautta.

Ilmoitukset ja muut moduulit

• Omat tulevat varaukset näkyvät etusivun tapahtumissa.
• Varaukseen voidaan myöhemmin kytkeä ilmoituksia (eräpäivät yms.) ilmoitusmoduulin kautta.

Käytännön vinkkejä

• Aktivoi resurssi vasta, kun varauslogiikka ja aikataulut ovat valmiit — passiivinen resurssi ei näy jäsenille.
• Pidä aikataulut ja estetyt ajat ajan tasalla, jos käytät ulkoista kalenteria.
• Testaa säännöt sekä jäsenenä että ilman jäsenyyttä, jos molemmat ryhmät voivat varata.
• Jos hinta vaihtuu vuorokauden aikana, linkitä eri aikataulut samaan sääntöön eri hinnoilla (jatkuvat ikkunat muodostavat yhtenäisen varausjakson).