Open source
Tickets for Laravel
composer require roundly-consulting/tickets-for-laravelPrehľad
Headless jadro helpdesku pre Laravel. Zákazníci a kolegovia zakladajú tikety s číslami bez medzier, váš tím ich posúva vymeniteľnými stavmi a všetci komunikujú v jednej konverzácii na tiket — verejnými odpoveďami aj internými poznámkami, ktoré žiadateľ nikdy neuvidí. Priradenie, priority, termíny, vlastné polia, žiadatelia bez účtu, zlučovanie, e-mailové notifikácie v angličtine a slovenčine aj voliteľné JSON API sú za jednou fasádou. Licencia MIT, postavené len na oficiálnych komponentoch Laravelu a vlastných balíkoch Roundly pre stavy, komentáre, vlastné polia, preklady, súbory a filtrovanie — bez externého poskytovateľa helpdesku.
Čo získate
Čísla tiketov bez medzier
Čitateľné čísla ako TCK-42, v projekte SUP-42 — prideľované po poradí bez medzier a bez duplicít, aj keď tikety vznikajú súčasne.
Vymeniteľné stavy
Sedem stavov v piatich kategóriách nad lifecycle-for-laravel, jednoslovné prechody, automatizácie a automatické uzavretie — alebo vlastný životný cyklus.
Odpovede a interné poznámky
Jedna konverzácia na tiket: verejné odpovede, ktoré môžu tiket posunúť, a poznámky len pre agentov, ktoré sa nedostanú k žiadateľovi, do e-mailu ani do počtov.
Priradenie a termíny
Priraďujte ľudí aj celé tímy, nechajte agentov preberať prácu, nastavte predvolené hodnoty kategórií a označte tikety po termíne či tesne pred ním práve raz.
Vlastné polia
Typované polia globálne, pre projekt alebo kategóriu, s povolenými pravidlami, šifrovaním a viditeľnosťou pre žiadateľa — filtrovateľné z PHP aj cez API.
Hostia, zlučovanie a prepojenia
Žiadatelia bez účtu cez odvolateľné podpísané odkazy, zlučovanie duplicít, typované prepojenia tiketov, sledujúci a farebné štítky.
Voliteľné JSON API a e-maily
Resources podľa roly, filtre, hromadné akcie, limity požiadaviek a policy — plus e-maily vo fronte s kontrolou viditeľnosti, v angličtine a slovenčine.
Fasáda, DI alebo akcie
Jedna fasáda Tickets, injektovateľný manažér alebo jednoúčelové akcie — a nahrávací fake, ktorý každé volanie aj tak vykoná.
Dokumentácia
Príklady použitia
Kde sa balík hodí — podpora v SaaS, IT helpdesk, projekty agentúr, e-shopy a verejné služby — a ktorá dodaná funkcia za každým stojí.
Inštalácia
Inštalácia cez Composer, tickets:install a migrácia, zladenie typov kľúčov, používateľ ako riešiteľ, definícia oprávnení a naplánovanie kontrol.
Konfigurácia
Každý kľúč konfigurácie s env premennou a predvolenou hodnotou — kľúče, životný cyklus, priority, hostia, autorizácia, prílohy, routy a notifikácie.
Modely, kľúče a čísla tiketov
Typy kľúčov, čísla tiketov bez medzier a postupnosti, deväť modelov, stĺpce modelu Ticket, pomocníci stavov a meta hostiteľa, výmena modelov a enumy.
Fasáda Tickets
Prehľad fasády Tickets — make() a create(), handle for($ticket), kategórie, polia, štítky, hostia, projekty, visibleTo() a sweep().
DI a akcie
Bez fasády: injektujte TicketsManager alebo zavolajte jednoúčelovú akciu — každá akcia so signatúrou execute() a cestou cez fasádu.
Zakladanie a úprava tiketov
Zakladajte tikety builderom alebo cez CreateTicketData, doplňte predvolené hodnoty z kategórií, potom ich upravujte, presúvajte, odovzdávajte a mažte.
Stavy a prechody
Sedem stavov, päť kategórií a deväť prechodov — plus pomenované skratky, automatizácie, automatické uzavretie, zámok konverzácie a vlastné cykly.
Odpovede a interné poznámky
Verejné odpovede a poznámky len pre agentov vo vlákne comments-for-laravel — roly autorov, automatizácie, prvá odpoveď, moderácia, zmienky a úpravy.
Kategórie a priority
Vnorené preložiteľné kategórie s predvolenou prioritou, riešiteľom a lehotou — plus vážený enum priorít a jeho výmena.
Termíny a kontrola termínov
Nastavte, posuňte či zrušte termín, doplňte ho z kategórie a označte tikety po termíne alebo tesne pred ním práve raz cez Tickets::sweep().
Priradenie a sledujúci
Jeden riešiteľ na tiket — používateľ alebo tím — s claim(), vhodnosťou a predvolenými riešiteľmi, plus sledujúci, automatické sledovanie a odovzdanie.
Štítky a prepojenia
Farebné štítky len pre agentov, globálne alebo projektové, s trvalými názvami — a typované prepojenia tiketov s kontrolou cyklov.
Zlučovanie tiketov
Zlúčte duplicitu do správneho tiketu — konverzácia, sledujúci, štítky aj súbory sa presunú v jednej transakcii a zdroj sa uzavrie s odkazom na cieľ.
Prílohy
Súbory priamo na tikete v súkromnej skupine media-library, servírované cez krátkodobé podpísané URL — plus prílohy odpovedí a poznámok.
Vlastné polia
Typované polia globálne, pre projekt či kategóriu, s povolenými pravidlami, šifrovaním a viditeľnosťou — nastavenie, čítanie, filtrovanie a čistenie.
Hostia a odkazy pre hostí
Tikety od ľudí bez účtu — konfigurovateľné polia hosťa, bezpečné rozpoznanie vracajúcich sa hostí, konverzia pri registrácii a podpísané odkazy.
Projekty
Číslujte tikety po projektoch (SUP-1, WEB-1) s vlastnými kategóriami, poliami a štítkami cez kontrakt TicketProject a trait HasTickets.
Vyhľadávanie a história aktivít
Eloquent scopes spoločné pre PHP aj API — stav, priorita, kategória, riešiteľ, polia, dátumy a hľadanie — plus nemenná história aktivít.
JSON API
Voliteľné JSON API — routy, telá požiadaviek, hromadné akcie, resources podľa roly, filtre a radenie zoznamu, limity požiadaviek a chybové kódy.
Policy a rozsah agentov
TicketPolicy za API, Gate oprávnenia, ktoré definujete, manažéri s rozsahom a AgentScope, ktorý agentov obmedzí na tikety, na ktorých smú pracovať.
Notifikácie
Desať notifikácií vo fronte po potvrdení, v angličtine a slovenčine — príjemcovia, kontrola viditeľnosti, payloady, výmena tried a ďalšie kanály.
Rozšírenie
Každé miesto na výmenu — kontrakty a ich dodané implementácie, životný cyklus, enum priorít, modely, policy a notifikácie — bez forku.
Udalosti
34 udalostí po potvrdení, z toho 33 ako TicketEvent — jeden typovaný listener zachytí každú zmenu tiketu pre webhooky, audit a dashboardy.
Výnimky
Každá podtrieda TicketsException, kedy sa vyhodí a akým stavom HTTP odpovie API — plus ako sú kľúčované chyby validácie polí a hostí.
Artisan príkazy
tickets:install, tickets:doctor s kontrolami a návratovými kódmi, tickets:sweep pre termíny a tickets:prune-fields pre osirotené hodnoty.
Testovanie
Tickets::fake() zaznamená každú operáciu a aj tak ju vykoná — každá asercia a jej negatívna dvojička, zaznamenané operácie, factory a nastavenie aplikácie.
Požiadavky
PHP 8.4+, Laravel 12 alebo 13, MySQL alebo PostgreSQL (SQLite pre testy) a balíky Roundly, na ktorých stojí, nainštalované cez Composer.
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 kryptomienOdoslaním daru súhlasíte s našimi podmienkami prijímania darov.
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.