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

Štítky a prepojenia

Štítky sú označenia len pre agentov, globálne alebo pre projekt:

Tickets::tags()->create('printer', color: '#f24e29', project: $helpdesk);
Tickets::tags()->findOrCreate('vip');
Tickets::tags()->rename($tag, 'printers');
Tickets::tags()->recolor($tag, null);
Tickets::tags()->delete($tag);                                // returns the trashed tag
Tickets::tags()->find('printer', $helpdesk);                  // by id or slug: the project's, else the global one
Tickets::tags()->all($helpdesk);                              // global + the project's, by name

Tickets::for($ticket)->tags()->attach(['printer', 'vip'])->detach('spam');
Tickets::for($ticket)->tags()->sync(['printer']);
Tickets::for($ticket)->tags()->all();
  • Názov má 1–64 znakov (orezaný) a musí sa dať previesť na slug; farba je #rrggbb (uložená malými písmenami) alebo null — inak InvalidTagException.
  • Štítok sa pripája podľa názvu (pri tickets.tags.free_form sa vytvorí za behu, inak InvalidTagException) alebo ako TicketTag. Projekt štítka musí byť projekt tiketu, alebo globálny. Názov sa najprv priradí živému štítku — projektovému, potom globálnemu.
  • Zmazanie štítka ho odoberie zo všetkých tiketov: každý živý tiket zapíše interný záznam untagged a spustí TicketUntagged.
  • Názvy sú v rámci rozsahu trvalé: vytvorenie názvu zmazaného štítka obnoví jeho riadok (rovnaké id aj slug) — prázdny, takže označenie jedného tiketu nikdy potichu neoznačí iné. Premenovanie na existujúci názov sa odmietne; slug nasleduje premenovanie.
  • Pripojenie, odpojenie aj synchronizácia sú idempotentné a zapíšu jednu internú aktivitu na volanie ({added, removed}); TicketTagged / TicketUntagged sa spustia s názvami. Zápisy štítkov sa radia na lock:tags, takže súbežné findOrCreate('printer') vytvorí jeden štítok.

Prepojenia

use RoundlyConsulting\Tickets\Enums\LinkType;

Tickets::for($ticket)->by($agent)->links()->add('TCK-9', LinkType::Blocks);
Tickets::for($ticket)->links()->remove($other, LinkType::Blocks);
Tickets::for($ticket)->links()->all();   // list<TicketLinkView>: ticket, type, label, direction
TypZ pohľadu druhého konca
relates_torelates_to (symetrické; uložené raz, nižší kľúč prvý)
duplicatesduplicated_by
blocksblocked_by
parent_ofchild_of

S InvalidTicketLinkException sa odmietne: prepojenie na seba; prepojenie blocks / parent_of, ktoré uzavrie cyklus (prehľadávanie do hĺbky obmedzené tickets.links.max_depth); druhý rodič; prepojenie medzi projektmi pri vypnutom tickets.links.cross_project; odobratie prepojenia, ktorého tento tiket nie je súčasťou. Pridanie duplicitného prepojenia nič nespraví. Prepojenia na soft-deleted tiket sú skryté a nedajú sa odobrať.

remove() vezme prepojenie, ktoré tento tiket drží ako odchádzajúce, inak prichádzajúce. duplicates môže viesť oboma smermi (A duplikuje B aj B duplikuje A, dva riadky): remove() volajte z toho konca, ktorého prepojenie má zaniknúť. DELETE …/links/{link} v API odstráni presne riadok, ktorý uvedie.

Blokovaný tiket nemožno začať riešiť

Prepojenie blocks je predvolene len informatívne. Zapnite tickets.links.blockers_prevent_start (TICKETS_LINKS_BLOCKERS_PREVENT_START=on) a tiket nemožno začať riešiť — vstúpiť do stavu kategórie Active, v dodanom životnom cykle in_progress —, kým ho blokuje nevyriešený, nezmazaný tiket:

// .env
TICKETS_LINKS_BLOCKERS_PREVENT_START=on

use RoundlyConsulting\Tickets\Enums\LinkType;
use RoundlyConsulting\Tickets\Exceptions\TicketBlockedException;

Tickets::for($blocker)->by($agent)->links()->add($ticket, LinkType::Blocks);   // $blocker blocks $ticket

Tickets::for($ticket)->by($agent)->can('start');            // false
Tickets::for($ticket)->by($agent)->allowedTransitions();    // […, 'wait', 'resolve', …] — no 'start'

try {
    Tickets::for($ticket)->by($agent)->start();
} catch (TicketBlockedException $e) {
    $e->getMessage();   // Ticket [TCK-2] cannot be started while unresolved tickets block it: TCK-1.
    $e->blockers();     // ['TCK-1'] — every open blocker's reference, in key order
}

Tickets::for($blocker)->by($agent)->resolve();
Tickets::for($ticket)->by($agent)->start();                 // in_progress
  • Počítajú sa len prepojenia blocks smerujúce na tiket, od blokujúceho tiketu v stave Open, Active alebo Waiting. Vyriešený, uzavretý či soft-deleted blokujúci tiket, tiket, ktorý tento tiket blokuje, ani prepojenia relates_to, duplicates či parent_of ho nezdržia.
  • Stráži sa len začatie — prechod zo stavu mimo Active do stavu Active. Presun medzi dvoma stavmi Active a každý iný prechod (wait, hold, resume, resolve, dismiss, …) prejdú.
  • Strážená je každá cesta do Active vrátane začatia priamo cez lifecycle. Kontrola beží vnútri prechodu po zamknutí riadka tiketu, takže začatie a súbežné prepojenie blocks sa zoradia: to, ktoré sa potvrdí druhé, vidí to prvé. Odmietnuté začatie nezapíše nič — žiadnu zmenu stavu ani záznam aktivity.
  • can() a allowedTransitions() odmietnuté začatie vynechajú, rovnako GET …/transitions; POST …/transitions/start odpovie 409 s kódom ticket_blocked a preloženým hlásením (dodáva sa angličtina a slovenčina).
  • Automatizácia, ktorá by blokovaný tiket začala riešiť, sa preskočí a po odblokovaní tiketu beží normálne.

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.