--- title: "Appointments for Laravel — dokumentácia | Roundly" description: "Vývojárska dokumentácia Appointments for Laravel: fluentný builder rezervácií, účastníci z ľubovoľných modelov, stavy, konflikty, opakovania a ICS export." url: https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel language: sk --- [Všetky balíky](https://roundly-consulting.com/sk/open-source.md) Open source # Appointments for Laravel Inštalácia `composer require roundly-consulting/appointments-for-laravel` Vyžaduje: PHP ^8.4 · Laravel ^12.0|^13.0 [GitHub](https://github.com/roundly-consulting/appointments-for-laravel) [Packagist](https://packagist.org/packages/roundly-consulting/appointments-for-laravel) [Prispieť (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Patreon](https://www.patreon.com/cw/roundly) ## Prehľad Nástroj na plánovanie termínov pre Laravel. Vytvárajte termíny s trvaním a časovým pásmom, pripájajte ako účastníka akýkoľvek Eloquent model, blokujte dvojité rezervácie, posúvajte rezervácie cez strážený životný cyklus stavu, generujte opakované série a exportujte štandardné kalendárové súbory .ics. Všetko pokryje jedna fasáda Appointments a rovnaké API môžete injektovať ako AppointmentManager. Stavia na vlastných provider balíkoch Roundly pre polohu miesta konania, kontakty hostí, schvaľovanie rezervácií a hodnotenia po návšteve — licencia MIT, bez závislostí tretích strán okrem Laravelu. ### Čo získate #### Fasáda, DI alebo akcie Rezervujte cez Appointments::schedule()->startingAt()->lasting()->create(), injektujte AppointmentManager alebo spúšťajte akcie s typovanými DTO. #### Účastníkom môže byť akýkoľvek model Používatelia, zákazníci, miestnosti či vozidlá sa pripájajú cez jednu polymorfnú tabuľku — s rolou a vlastnými meta údajmi. #### Strážený životný cyklus stavu Čaká → potvrdený → dokončený, plus zrušený, odmietnutý a neprítomnosť. Nepovolené prechody vyhodia výnimku, každá zmena spustí event. #### Ochrana pred dvojitou rezerváciou Zapnite ju pre jedno volanie alebo globálne: prekryv u ktoréhokoľvek účastníka vyhodí výnimku — vďaka zámkom riadkov aj pri dvoch súbežných rezerváciách. #### Opakované série Denné, týždenné či mesačné pravidlá s intervalom, počtom, koncovým dátumom a dňami v týždni — vytvorené v jednej transakcii, všetko alebo nič. #### Export do kalendára a zaznamenávajúci fake Súbor .ics podľa RFC 5545 pre jeden termín aj celý feed; Appointments::fake() zaznamená každý zápis pre assertScheduled() a ďalšie asercie. #### Schvaľovanie, hodnotenia a miesta Schválenie rezervácie riadi jej stav, hodnotenia po návšteve sa overujú účasťou a miesta konania podporujú vyhľadávanie v okruhu. ### Dokumentácia #### [Inštalácia](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/instalacia.md) Inštalácia cez Composer, publikovanie migrácií balíka aj jeho provider balíkov a voliteľne konfigurácie. #### [Konfigurácia](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/konfiguracia.md) Každý konfiguračný kľúč a jeho predvolená hodnota — modely, typ kľúča, tabuľky, pásmo, trvanie, konflikty, opakovania, hodnotenia a schvaľovanie. #### [Schéma a vlastné modely](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/schema-a-modely.md) Tabuľky termínov a účastníkov, kľúče účastníkov UUID/ULID a náhrada modelov Appointment a Participant vlastnými. #### [Fasáda Appointments](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/fasada.md) Prehľad fasády Appointments — builder schedule(), vytváranie z DTO, handle for() s participants(), dostupnosť, ICS feedy a náhľady opakovaní. #### [DI a akcie](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/bez-fasady.md) Namiesto fasády injektujte AppointmentManager alebo spúšťajte šesť akcií priamo — plus úplná mapa metód fasády na akcie. #### [Typované DTO](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/dto-a-akcie.md) AppointmentData, ParticipantData a RecurrenceData — typované DTO za create(), createRecurring(), fluentným builderom aj akciami. #### [Vytváranie termínov](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/vytvaranie-terminov.md) Vytvárajte termíny fluentným builderom Appointments::schedule() alebo z typovaného DTO — reťaziteľné metódy, predvolené hodnoty a koncové volania. #### [Trvanie a časové pásma](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/trvanie-a-casove-pasma.md) Ako sa začiatok, koniec a trvanie odvodzujú navzájom, prečo sa časy ukladajú v UTC a ako čítať lokálny čas. #### [Účastníci](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/ucastnici.md) Pripojte akýkoľvek Eloquent model ako účastníka s rolou a meta údajmi, vypíšte jeho termíny cez HasAppointments a pridávajte či odoberajte ľudí neskôr. #### [Životný cyklus stavu](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/zivotny-cyklus-stavu.md) Strážený stavový automat — prechody, pomocné metódy, popisy, farby a výnimka InvalidStatusTransitionException. #### [Detekcia konfliktov](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/detekcia-konfliktov.md) Blokujte dvojité rezervácie pre jedno volanie alebo globálne, preskúmajte kolidujúce termíny a overte dostupnosť cez Appointments::isAvailable(). #### [Presúvanie termínov](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/presuvanie-terminov.md) Presuňte termín na nový začiatok, ponechajte alebo zmeňte trvanie, strážte konflikty a reagujte na AppointmentRescheduled. #### [Opakované termíny](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/opakovane-terminy.md) Denné, týždenné či mesačné série s intervalom, počtom, koncovým dátumom a dňami v týždni — vytvorené atomicky a prepojené UUID skupiny. #### [Dotazovanie](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/dotazovanie.md) Query scopes pre nadchádzajúce, minulé a prekrývajúce sa termíny aj termíny účastníka, plus filtre stavu a zoradenie. #### [Export do kalendára (ICS)](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/export-do-kalendara.md) Exportujte jeden termín alebo celý rozvrh ako .ics podľa RFC 5545 — mapovanie stavov, escapovanie, riadky GEO, ORGANIZER a ATTENDEE. #### [Miesto konania](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/miesto-konania.md) Priraďte termínu názov miesta a súradnice, merajte vzdialenosť a hľadajte termíny v okruhu. #### [Kontakty hostí](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/kontakty-hosti.md) Ukladajte e-maily a telefónne čísla rezervácie priamo na termín a premeňte ich na riadky ORGANIZER a ATTENDEE v kalendári. #### [Schvaľovanie rezervácií](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/schvalovanie-rezervacii.md) Vyžadujte schválenie pred potvrdením rezervácie — jednoduché, kvórové, viacstupňové či prednastavené workflow, ktoré riadia stav termínu. #### [Hodnotenia po návšteve](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/hodnotenia.md) Zbierajte hodnotenia po návšteve overené pre skutočných účastníkov, pripojte vlastný resolver účasti a čítajte súhrny hodnotení. #### [Eventy a výnimky](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/eventy.md) Sedem eventov termínov a účastníkov, ich dáta a kedy sa spúšťajú, plus každá výnimka, ktorú balík vyhadzuje. #### [Testovanie](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/testovanie.md) Zaznamenajte každý zápis rezervácií cez Appointments::fake() a jeho asercie, na zvyšok použite factory modelu a ukážkové testy v Peste. #### [Požiadavky](https://roundly-consulting.com/sk/open-source/navody/appointments-for-laravel/poziadavky.md) PHP 8.4+, Laravel 12 alebo 13 a šesť provider balíkov Roundly, ktoré Composer nainštaluje automaticky. ## Prejavte lásku k open source Tento balík je zadarmo pod licenciou MIT. Ak vám šetrí čas, jednorazový príspevok alebo členstvo na Patreone nám pomôže ho ďalej udržiavať, testovať a dokumentovať. [Ďalšie spôsoby podpory vrátane kryptomien](https://roundly-consulting.com/sk/podporte-nas.md) Odoslaním daru súhlasíte s našimi [podmienkami prijímania darov](https://roundly-consulting.com/sk/podmienky-darov.md). [Podporte našu open-source prácu (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Pridajte sa k nám na Patreone (otvorí sa v novej karte)](https://www.patreon.com/cw/roundly) ## Chcete to zabudovať do svojho produktu? Naše balíky integrujeme do zákazkových Laravel a AI riešení. Napíšte nám, na čom pracujete, a ozveme sa do 48 hodín. [Ponuka do 48 hodín](https://roundly-consulting.com/sk/kontakt.md) [Prezrieť všetky balíky](https://roundly-consulting.com/sk/open-source.md)