# Widget pro hlášení chyb (https://docs.vitrinka.ai/cs/qa/report-widget)



## Co to je [#what]

`<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.

```html
<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íč [#key]

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ů](/cs/security/redaction).

## Karanténa a review [#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](/cs/operator/connectors#jira); jinak hlášení povýšíte z panelu Reports.

## Nastavení [#config]

`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](/cs/dev/api/http).