K čemu soubor slouží
Tento soubor popisuje, jak systém rozhoduje, které časy rezervační formulář zákazníkovi ukáže. Nemá vlastní stránku v panelu. Pravidla vycházejí z jedné společné logiky, kterou používá kalendář s dny bez termínů, seznam časů i kontrola při vytvoření rezervace. Nabídka a kontrola při odeslání tak používají stejná pravidla. Přesto mezi zobrazením času a odesláním formuláře může termín obsadit jiný zákazník nebo se může změnit dostupnost (například nová dovolená nebo rezervace zadaná v panelu). Formulář pak rezervaci odmítne hláškou „Vybraný termín je již obsazen. Vyberte prosím jiný čas.“ (server vrací HTTP 409 s textem „Zvolený termín je již obsazen.“) a zákazník si vybere jiný čas. Podle zdrojového kódu a ověřeno testem souběhu dvou zákazníků na poslední volný termín: jeden uspěje, druhý tuto hlášku dostane.
Nastavení jednotlivých polí je v souborech Nastavení rezervací, Služby a Rozvrh a dovolená.
Všechny časy se počítají podle hodin v Praze (Europe/Prague).
Pořadí pravidel
Pravidla se uplatní v tomto pořadí. Termín se nabídne, jen když projde všemi.
- Účet a služba. Účet musí být aktivní a předplatné platné, jinak formulář nedostane žádné termíny (odpověď 402). Služba musí existovat, být Aktivní a mít zapnuto Zobrazit v rezervačním formuláři, aby se vůbec ve formuláři objevila.
- Datum. Dny v minulosti nemají žádný termín.
- Otevírací doba dne. Z Rozvrh se vezmou řádky pro den v týdnu, které platí pro dané datum (sezóna).
- Dny volna. Celodenní volno den zavře. Částečné volno zablokuje jen své okno.
- Přestávky. Přestávky dne a sezóny blokují své okno.
- Krok a kandidáti. Určí se časy začátku, které se zkoušejí.
- Délka, buffer a obsazenost. Pro každý začátek se ověří, že se služba vejde, a že není obsazeno.
- Předstih a horizont. Odstraní se časy příliš blízké a příliš vzdálené.
- Zaměstnanci a pracoviště. Při zapnutém modulu zaměstnanců se bod 3 až 7 počítá zvlášť pro každou osobu nebo pracoviště.
Kontrola při vytvoření rezervace používá stejná pravidla a navíc znovu ověří kolize. Rezervace zadaná v panelu smí obejít otevírací dobu a předstih. Chování panelu při kolizi s jinou rezervací: Neověřeno.
Rychlý přehled: co čas nabídne nebo skryje
| Krok | Zdroj pravidla | Co rozhoduje |
|---|---|---|
| Začátky | Rozvrh, přestávky, dny volna, krok slotů | Z jakých časů se vůbec vybírá (mřížka kroku od začátku pásma a časy po konci stávajících rezervací). |
| Výběr délky | Délka služby nebo varianty, u Časové rezervace Min. délka (min), Max. délka (min) a Krok výběru (min) | Jaké délky se u daného začátku nabídnou. Je to samostatný krok až po výběru začátku. |
| Obsazenost: pool zdrojů | Počet zdrojů v poolu (dráhy, kurty, místa...) | Součet zdrojů překrývajících se rezervací. |
| Obsazenost: souběh služby | Max. souběžných rezervací | Počet překrývajících se rezervací téže služby. |
| Obsazenost: kapacita služby | Kapacita (souběžné rezervace) | Počet překrývajících se rezervací téže služby. |
| Obsazenost: výchozí blokování | Rezervace poskytovatele | Bez poolu a při kapacitě 1 blokuje čas jakákoli překrývající se rezervace, i jiné služby. |
| Zaměstnanci a pracoviště | Modul zaměstnanců (tarif Pro+) | Kroky začátků až obsazenosti se počítají zvlášť pro každou osobu nebo pracoviště a pool ani kapacita služby se pak neuplatní. |
Podrobnosti jsou v oddílech níže. Obsazenost se vyhodnocuje podle prvního pravidla z řady pool, souběh, kapacita, výchozí blokování.
Pravidla podrobně
Otevírací doba a sezóny
Termín musí celý ležet uvnitř jednoho pásma Otevírací doba dne v týdnu. Sezóna se bere podle měsíce a dne, rok se neřeší. Má-li poskytovatel uložený aspoň jeden řádek rozvrhu, pak den bez řádku nebo mimo sezóny je zavřeno. Nemá-li žádný řádek, nejsou žádná omezení a termíny se nabízejí od 00:00 do 23:59. Více karet téhož dne vytvoří více pásem.
Příklad: pondělí 09:00 až 12:00, jediná aktivní služba 60 minut (automatický krok 60). Formulář nabídne 9:00, 10:00 a 11:00. Úterý nemá řádek, takže nenabídne nic.
Příklad s sezónou: karta s platností 1.5. až 30.9., pondělí 10:00 až 20:00. V pondělí 15. 10. formulář nenabídne nic, v pondělí 15. 7. nabídne celou dobu.
Dny volna
Celodenní Dovolená den zavře. Volno s časem Od a Do zablokuje termín, který se s oknem překrývá. Zablokuje se i pauza služby. Vícedenní služba nebo pronájem (1440 minut a víc) nesmí zasáhnout žádný den volna v rozsahu, ani částečný. Pro jedno datum se bere jeden záznam, proto zadávejte jen jeden na den.
Příklad: otevřeno 08:00 až 16:00, služba 60 minut, volno 12:00 až 14:00. Formulář nabídne 8:00, 9:00, 10:00, 11:00, 14:00 a 15:00. Čas 11:00 končí přesně ve 12:00 a projde.
Přestávky
Přestávka blokuje své okno a platí každý den, nebo jen v zadaný den týdne, a jen v sezóně karty. Termín může končit přesně na začátku přestávky a začínat přesně na jejím konci.
Příklad: 08:00 až 16:00, přestávka 12:00 až 13:00, služba 60 minut. Formulář nabídne 8:00, 9:00, 10:00, 11:00, 13:00, 14:00 a 15:00. Chybí jen 12:00.
Délka služby a buffer
Délka je trvání služby, nebo délka vybrané cenové varianty. Pro kalendář se počítá délka plus Buffer čas (minuty). Celý tento čas musí ležet v pásmu otevírací doby a nesmí zasáhnout přestávku ani volno. Zákazník vidí jen délku bez bufferu.
Příklad: služba 45 minut s bufferem 15, pásmo 09:00 až 12:00, bez rezervací a bez jiných aktivních služeb. Krok je 45 (společný dělitel délek aktivních služeb). Formulář nabídne 9:00, 9:45 a 10:30. Čas 11:15 by skončil s bufferem ve 12:15, a tak se nenabídne.
Krok a časy po konci rezervace
Začátky se zkoušejí na mřížce od začátku pásma. Krok je podle pořadí Krok slotů (minuty) u služby, pak Výchozí krok slotů (minuty), pak automatika (největší společný dělitel délek všech aktivních služeb, u služby delší než den 60 minut). Navíc se nabídne čas těsně po konci blokace každé stávající rezervace (včetně bufferu). Je-li krok větší než délka služby s bufferem, nabídne se takový čas jen tehdy, pokud padne na násobek kroku od začátku pásma.
Příklad: krok 60, služba 30 minut, otevřeno od 08:00. Bez rezervací se nabídne 8:00, 9:00 a další celé hodiny. Existuje-li rezervace 8:00 až 8:30, nabídne se od 9:00 dál a čas 8:30 ne, protože neleží na násobku 60 od začátku.
Kapacita, souběh a zdroje
Čas je obsazený podle prvního pravidla, které platí:
- Je nastaven pool zdrojů (Počet zdrojů v poolu (dráhy, kurty, místa...)): součet zdrojů překrývajících se rezervací plus Zdrojů z poolu nové služby nesmí přesáhnout pool. Započítají se rezervace všech služeb.
- Služba má Max. souběžných rezervací: počet překrývajících se rezervací téže služby musí být menší.
- Služba má Kapacita (souběžné rezervace) větší než 1: počet překrývajících se rezervací téže služby musí být menší než kapacita.
- Jinak čas blokuje jakákoli překrývající se rezervace poskytovatele, i jiné služby.
Rezervace ve stavu Zrušená, Odmítnutá a Propadlá čas neblokují. Čekající rezervace ho blokují. Buffer rezervace se k jejímu konci přičítá.
Příklady: Kapacita 2, jedno pásmo 09:00 až 10:00, služba 60 minut. Po jedné rezervaci se 9:00 dál nabízí, po druhé už ne. Pool 4 dráhy, služba Dráha spotřebuje 1, Celé hřiště 4. Jsou-li v 18:00 obsazené 3 dráhy, Dráha se nabídne, Celé hřiště ne. Dvě různé služby s kapacitou 1 a bez poolu se v jednom čase nepřekrývají: je-li rezervovaný Střih 9:00 až 10:00, Barvení v 9:00 se nenabídne.
Zaměstnanci
Pravidlo platí, když je zapnutý modul zaměstnanců (tarif Pro+ a zapnuto v nastavení) a účet má aspoň jednoho aktivního zaměstnance. Formulář pak nabízí časy po osobách.
- Zaměstnanec obsluhuje službu, pokud ji nemá v seznamu vyloučených. Když jsou vyloučeni všichni, formulář pro službu nenabídne nic.
- Má-li zaměstnanec vlastní týdenní rozvrh, je pro něj závazný. Den, který v něm chybí, zaměstnanec nepracuje. Bez vlastního rozvrhu platí rozvrh poskytovatele.
- Osoba s flexibilní dostupností pracuje jen v pásmech zadaných na konkrétní data. Den bez pásma je volno.
- Rozvrh poskytovatele je strop. Pásmo zaměstnance se s ním zúží na průnik.
- Volno zaměstnance den zavře jen pro něj. Dovolená poskytovatele zavře den všem.
- Kapacita se počítá na osobu, vždy 1. Blokují ji jen rezervace dané osoby. Kapacita (souběžné rezervace), Max. souběžných rezervací a pool se v tomto režimu neuplatní.
Příklad: poskytovatel má Po až Pá 08:00 až 16:00, zaměstnanec v úterý 07:00 až 12:00. Zaměstnanec nabídne úterý 08:00 až 12:00. Ve středu, kde v jeho rozvrhu nic není, nepracuje.
Pracoviště
Je-li zapnutý modul zaměstnanců a službu nabízí aspoň jedno aktivní pracoviště, počítá se dostupnost po pracovištích. Pracoviště s vlastním rozvrhem se zúží na průnik s rozvrhem poskytovatele, bez něj platí rozvrh poskytovatele. Kapacita pracoviště je 1. Volno pracoviště den zavře pro ně. Vybraná osoba k tomu musí v tu dobu pracovat a nesmí mít jinou rezervaci ani na jiném pracovišti.
Předstih a horizont
Min. předstih (hod): čas musí začínat později než teď plus předstih, a to u každého dne. Bez předstihu se skrývají jen časy dnešního dne, které už začaly. Max. dní dopředu: poslední nabízený den je dnešek plus tento počet dní.
Příklad: v 10:30 s předstihem 3 hodiny, otevřeno 08:00 až 16:00, služba 60 minut. Formulář nabídne 14:00 a 15:00 (musí být po 13:30). Příklad horizontu: v pondělí 17. 11. s Max. dní dopředu 7 je poslední nabízený den pondělí 24. 11.
Časová rezervace
U Časové rezervace se pro každý začátek ověří všechny nabízené délky od Min. délka (min) po Max. délka (min) s krokem Krok výběru (min) (výchozí 60, 240 a 30). Začátek se nabídne, když vyhoví aspoň jedna délka, a formulář pak ukáže jen vyhovující délky. Konec kratší rezervace musí ležet v pásmu otevírací doby dne začátku. Začátek na konci pásma se nenabídne.
Příklad: služba s trváním 60 minut (začátky po hodině), otevřeno 09:00 až 18:00, Min. délka 60, Max. délka 240, Krok výběru 60. Start 16:00 nabídne délky 1 a 2 hodiny, start 17:00 jen 1 hodinu, start 18:00 se nenabídne.
Je-li vybraná cenová varianta, počítá se jen její pevná délka.
Vícedenní délky a vrácení v otevírací době
Délka 1440 minut a víc se řídí těmito pravidly: začátek leží v pásmu, v rozsahu není den volna, a při zapnutém Vrácení musí být v otevírací době čas vrácení padne do otevírací doby dne vrácení. Bez vlastního kroku je automatický krok 60 minut.
Příklad: půjčovna s rozvrhem Po až So 09:00 až 17:00, délka 1 den, zapnuté vrácení v otevírací době. Start v pátek v 10:00 vrací v sobotu v 10:00, tedy projde. Start v sobotu v 10:00 vrací v neděli, kdy je zavřeno, a tak se nenabídne. Při vypnuté volbě se sobotní start nabídne.
Ubytování
U typu Ubytování se rozvrh, přestávky ani dny volna nepoužívají. Pobyt zabírá noci. Den odjezdu zůstává volný pro příjezd. Noc je obsazená, když ji pokrývá aspoň tolik rezervací, kolik je Kapacita (souběžné rezervace) pokoje.
Formulář nenabízí žádný termín: co zkontrolovat
Projděte body v tomto pořadí. Vždy zkoušejte konkrétní budoucí den, který by měl být otevřený.
- Účet a předplatné. Má účet platné Předplatné? Při neplatném formulář nedostane žádná data.
- Služba. Je služba Aktivní a má zapnuto Zobrazit v rezervačním formuláři? Odpovídá typ rezervací účtu tomu, co čekáte (Termín, Časová rezervace, Ubytování)?
- Datum. Zkoušíte budoucí den? Dnešek po poslední možné hodině už nic nenabídne.
- Horizont a předstih. Není den dál než Max. dní dopředu? Nezakazuje Min. předstih (hod) celý dnešek nebo zítřek?
- Rozvrh. Je v Rozvrh zaškrtnutý ten den v týdnu a platí sezóna pro toto datum?
- Dovolená. Není ten den, ani žádný den vícedenní rezervace, v Dovolená?
- Přestávky. Nepokrývá Přestávky celé pásmo, nebo jeho podstatnou část?
- Délka. Vejde se trvání služby plus Buffer čas (minuty) do pásma? Služba 120 minut do pásma 60 minut nikdy nevyjde.
- Krok. Není Krok slotů (minuty) nebo Výchozí krok slotů (minuty) tak velký, že další začátek už neleží v pásmu?
- Obsazenost. Je čas obsazený rezervací téže služby podle kapacity, Max. souběžných rezervací nebo poolu? Při kapacitě 1 a bez poolu blokuje i rezervace jiné služby. Zkontrolujte také čekající rezervace v Rezervace, ty drží termín.
- Zaměstnanci a pracoviště. Je zapnutý modul zaměstnanců? Není služba vyloučena u všech zaměstnanců? Pracuje zaměstnanec ten den podle svého rozvrhu, nemá volno a nespadá jeho pásmo mimo otevírací dobu poskytovatele? Má pracoviště nabízející službu v ten den otevřeno?
- Časová rezervace a vícedenní délky. Vyhoví aspoň jedna délka od Min. délka (min) po Max. délka (min)? Není při zapnutém Vrácení musí být v otevírací době den vrácení zavřený?
Když žádný bod nepomůže, zkuste jiný den v týdnu a jinou službu. Rozdíl ukáže, zda chyba je u služby, nebo v rozvrhu.
Technická poznámka
Informace jsou převzaté ze zdrojového kódu: AvailabilityService.cs, OpeningHoursClamp.cs, StaffScheduleResolver.cs, ReservationDurationOptions.cs, SlotsController.cs, BookingService.cs, ProcedureRepository.cs, StaffRepository.cs, WorkplaceRepository.cs, SubscriptionService.cs.