Š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| Typ | Z pohľadu druhého konca |
|---|---|
relates_to | relates_to (symetrické; uložené raz, nižší kľúč prvý) |
duplicates | duplicated_by |
blocks | blocked_by |
parent_of | child_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 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.