Widget pro hlášení chyb
Hlášení chyby přímo z aplikace se snímkem, zprávami z konzole a volitelným záznamem posledních akcí.
Co to je
<vitrinka-report> je webová komponenta dostupná z vaší instalace vitrinky na /vendor/report-widget-1.mjs. Uživatel jejím prostřednictvím odešle hlášení se snímkem obrazovky, posledními zprávami z konzole a metadaty neúspěšných požadavků. Projekt může zapnout i průběžný záznam posledních akcí. Rozsah maskování určuje profil projektu.
<script type="module" src="https://vitrinka.acme.internal/vendor/report-widget-1.mjs"></script>
<vitrinka-report key="vkb_…"></vitrinka-report>base má výchozí hodnotu origin, ze kterého byl skript servírovaný, takže klíč je jediný atribut, který musíte dodat. open-selector="#help-report-bug" naváže tlačítko, které už máte, místo vlastního plovoucího prvku widgetu. Tento script tag je celá integrace: widget se do vaší aplikace nikdy nebunduje, servíruje ho bez cache ta instalace, která hlášení přijímá (na app.vitrinka.ai je to https://app.vitrinka.ai/vendor/report-widget-1.mjs), takže se kontrakt záznamu nemůže rozejít se serverem. Ve frameworkové aplikaci vložte tentýž <script type="module"> jednou při mountu a vykreslete prvek; typovaný balíček není potřeba.
Publikovatelný klíč
Klíč vkb_ vytvoříte pro projekt v Settings a můžete ho vložit do stránky. Opravňuje widget načíst veřejnou konfiguraci a odesílat hlášení do daného projektu; nedává přístup k uloženým hlášením ani jejich přílohám. Počet požadavků je omezený pro každý klíč. Odesílaná data podléhají maskování citlivých údajů.
Karanténa a review
Nové hlášení je v karanténě. Administrátor si může v panelu review prohlédnout jeho snímek, události a přehrání. Teprve schválením vznikne nahrávka dostupná v běžném pracovním postupu.
| Akce | Kdo | Co se stane |
|---|---|---|
| Prohlédnout | admin workspace | Snímek obrazovky, konzole, požadavky a přehrání, v panelu review. |
| Upravit citlivý obsah | admin workspace | Odstranit vybrané události, snímek nebo přehrání před schválením. |
| Schválit | admin workspace | Vznikne nahrávka, karta na nástěnce chyb projektu a v projektu se založí přijatý úkol typu bug. |
| Zamítnout | admin workspace | Zpráva se uzavře a nic se neuvolní. |
Schválené hlášení se zpracovává stejným souhrnem jako nahraná session a může si ho načíst připojený agent. Se zapnutým přepínačem auto-ticket projektu schválení otevře i tiket přes konektor projektu; jinak hlášení povýšíte z panelu Reports.
Nastavení
GET /api/v1/report-config vrací nastavení widgetu: profil maskování (strict maskuje text a vstupy, vynechává těla síťových požadavků a čistí konzoli; balanced a full tato omezení uvolňují pro interní aplikace — výchozí je strict), zapnutí průběžného záznamu a automatického vytváření tiketů po schválení. Tyto volby nastavíte v hlavičce panelu Reports konkrétního projektu. Endpointy uvádí HTTP API.