NovinkaZverejnili sme 50+ Laravel balíkov ako open source
Custom AI apps, agents and automation — Roundly ConsultingRoundly
Všetky balíky
Tickets for Laravel

Termíny a kontrola termínov

Termín je ručný: zadá sa pri založení, nastaví neskôr alebo ho pri založení doplní Contracts\DueDateResolver (predvolene teraz plus default_due_in najbližšej kategórie) — miesto, na ktoré sa dá napojiť vrstva SLA:

Tickets::for($ticket)->due(now()->addHours(4));   // TicketDueDateChanged; clears both flags
Tickets::for($ticket)->due(null);                 // no due date
Ticket::query()->overdue()->get();                // past due and unresolved (Waiting counts)

$result = Tickets::sweep();   // SweepResult { overdue: 3, dueSoon: 1 }

Kontrola termínov

Tickets::sweep() — a php artisan tickets:sweep každých päť minút — prechádza nevyriešené tikety v dávkach zoradených podľa id:

  • Po termíne → TicketOverdue, záznam aktivity overdue a notifikácia overdue.
  • V okne tickets.due.soon_window (PT4H; off = nikdy) → TicketDueSoon a notifikácia due_soon (bez záznamu aktivity).
  • Každá sa spustí práve raz na termín: compare-and-set na overdue_notified_at / due_soon_notified_at, ktorý porovná aj due_at, ktoré kontrola prečítala — dve súbežné kontroly tak tiket označia raz a kontrola, ktorá prečítala starý termín, nikdy neoznačí posunutý.
  • Posun termínu oba príznaky znova aktivuje. Tiket skontrolovaný neskoro (už po termíne) sa označí len ako po termíne.
  • Kontrola termínov nikdy tikety neuzatvára — automatické uzavretie je lifecycle:sweep.
$result = Tickets::sweep();   // SweepResult
$result->overdue;             // int — tickets this sweep flagged overdue
$result->dueSoon;             // int — tickets this sweep flagged due soon
$result->total();             // int — both added up

SweepResult počíta tikety, ktoré označila táto kontrola. PHP API prijme termín v minulosti (pre importy); HTTP API vyžaduje after:now.

Čakajúce tikety bez upozornení

Predvolene kontrola prejde všetky nevyriešené tikety vrátane čakajúcich. Kategórie nevyriešených stavov, ktoré má vynechať, uveďte v tickets.due.skip_categories — open, active alebo waiting. Pri ['waiting'] nespustia tikety čakajúce na žiadateľa (pending) ani na tretiu stranu (on_hold) TicketOverdue ani TicketDueSoon; keď tiket kategóriu opustí, najbližšia kontrola ho označí ako zvyčajne:

// config/tickets.php — tickets parked on the requester or a third party raise no due-date events
'due' => [
    'skip_categories' => ['waiting'],   // any of open, active, waiting; [] sweeps them all
],

Tickets::for($ticket)->by($agent)->wait();     // pending (Waiting) — the sweep leaves it alone
Tickets::for($ticket)->by($agent)->resume();   // back in Open — the next sweep flags it if it is past due

Nastavenie zužuje len kontrolu termínov — Ticket::query()->overdue() aj isOverdue() čakajúci tiket po termíne naďalej započítajú. Ak vynecháte všetky tri kategórie, kontrola neprejde nič. Iná hodnota (resolved, closed, Waiting s veľkým písmenom) vyhodí InvalidTicketsConfigurationException s názvom tickets.due.skip_categories a tickets:doctor ju nahlási v sekcii due.

Vlastné pravidlo termínov

Naviažte Contracts\DueDateResolver (dueAt(Ticket): ?CarbonImmutable) cez tickets.due.resolver alebo kontajner. Balík sa ho opýta, keď tiket vznikne bez termínu — na uloženom tikete s načítanou kategóriou, ešte pred zápisom vlastných polí, štítkov a sledujúcich.

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

Odoslaní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.