# Co vitrínka nabízí (https://docs.vitrinka.ai/cs/start) ## Od připomínky k opravě [#loop] Tester označí problém přímo na obrazovce a přidá poznámku. Připojený agent dostane připomínku s dostupnými podklady, opraví kód a přiloží snímek výsledku vedle původního stavu. * **Záznam** — rekordér, agent nebo CI nahraje snímky, nahrávku, dokument, diagram či soubory. * **Označení** — člověk s přístupem k nástěnce označí problém nebo odpoví na otázku agenta. * **Oprava** — připojený agent položku přečte, změní kód a publikuje důkaz zpět na tutéž nástěnku. Záznamem je sama práce: převzetí a předání úkolu, trailer v commitu, publikovaný testovací běh nebo nahraná nástěnka zapíšou evidenci samy a nikdo nepíše hlášení o stavu. Server uspořádá nahraný obsah a zpřístupní prohledávatelná shrnutí. Agent tak může načíst potřebné podklady bez otevírání všech souborů. ## Pro koho to je [#personas] | Vy | K čemu vám nástěnka slouží | | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Vývojář | Váš den zaznamenaný bez vykazování: převzetí, předání, běhy, PR, commity a úkoly, které dozrají na vlastní spouštěč, skládají časovou osu úkolu, a každá obrazovka, kterou agent vytvořil, přistane na nástěnce, kde ji označíte a necháte opravit. | | QA | Nahrávání místo hlášení: zapněte rekordér, během testování anotujte a server sezení zpracuje, založí a sloučí tikety a vývojářům předá úplnou rekonstrukci. Výsledky testovacích nástrojů (Playwright, JUnit, allure…) se publikují do téhož QA záznamu, aniž byste měnili testy. | | Produkt | Vlastní domov pro úkoly, epiky, sprinty, milníky, vydání, vlastní pole a pravidla automatizace. Hlášením o stavu je nástěnka; Jira je volitelné zrcadlo pro jednotlivé projekty. | | Každý | Deník a schůzky: každý den jedna osobní nástěnka pro snímky, hlasové poznámky a nahrané schůzky, srolovaná do týdenních, měsíčních a ročních pohledů. | Každý má svou záložku: [Práce ve vitrince](/cs/use) pro to, co v aplikaci dělá každý, [QA a testování](/cs/qa), [Developer](/cs/dev) a [Product](/cs/pm). Kdo nasazení provozuje nebo posuzuje, čte [Provoz](/cs/operator) a [Bezpečnost](/cs/security). ## Co nástěnka unese [#surfaces] Nástěnka je plátno s kartami: obrázky, poznámkami, stránkami, úkoly a dalším obsahem. Podporované druhy karet můžete prohlížet a upravovat v prohlížeči nebo je nechat sestavit agentem přes MCP. | Karta | Co to je | | ------------------- | ------------------------------------------------------------------------------------------------------ | | Obrazovky a záznamy | Snímky s oblastmi a poznámkami; přehratelné nahrávky s DOM, sítí a konzolí na jedné časové ose. | | Uživatelské cesty | Obrazovky propojené v pořadí, jak jimi někdo prošel; větvení jako rozcestníky. | | Dokumenty a stránky | Text, tabulky, grafy, zjištění a kód; dokumenty propojené přes elementy `ref`. | | Diagramy | Architektura vygenerovaná z docker-compose, OpenAPI, SQL schématu nebo živé databáze, dál upravitelná. | | Úkoly a otázky | Projekce enginu úkolů a strukturované otázky s rozpracovanými odpověďmi. | | Artefakty | Samostatné interaktivní stránky, živé na plátně, aktualizované na místě na stejné URL. | Celý slovník — každý druh elementu, každý druh karty, s kontraktem obsahu — je generovaná [reference elementů](/cs/reference/elements). ## Čtyři díly [#pieces] | Díl | Co to je | | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | Server | Jeden statický Go binárník: HTTP API, webové UI, MCP server na `/mcp` a SQLite, s blob soubory na disku nebo v S3. | | Klienti | CLI `vitrinka` a plugin pro Claude Code / Codex se skilly. `vitrinka setup` zaregistruje každý agentní harness proti vlastnímu `/mcp` instalace přes HTTP. | | Boards engine | Plátno nástěnky, které server dodává jako součást webové aplikace. | | Veřejný web | Marketingový web a tahle dokumentace — samostatné služby, nikdy v binárníku. | ## Aplikace [#apps] Vedle prohlížeče je tu desktopová aplikace, Snap (pomocník v menu baru pro deník a schůzky), rozšíření prohlížeče, které nahrává cesty, rekordéry přímo v aplikaci pro React weby a Expo aplikace a vložitelný widget pro hlášení chyb. Každou popisuje stránka [aplikace](/cs/start/apps). ## Npm balíčky [#packages] CLI a rekordéry se distribuují pod scopem `@vitrinka`. | Balíček | Co to je | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | `@vitrinka/cli` | CLI `vitrinka` v jedné globální instalaci pro macOS, Linux a Windows. | | `@vitrinka/web` | Rekordér cest přímo v React webové aplikaci: testeři nahrávají z vývojového nebo preview buildu bez rozšíření ([webový rekordér](/cs/qa/recorder/web)). | | `@vitrinka/expo` | Toolkit pro Expo / React Native — dnes nese rekordér cest. | Balíček `@vitrinka/cli` automaticky vybere a nainstaluje verzi pro váš operační systém (`@vitrinka/cli--`). Platformní balíčky nemusíte instalovat zvlášť. ## Kde končí vaše data [#where] Nastavený server ukládá metadata v SQLite a soubory na disk nebo do úložiště kompatibilního s S3. Citlivé údaje a soubory šifruje klíči workspace. Pro sítě bez přístupu k internetu slouží nastavení air-gapped instalace. Podrobnosti jednotlivých opatření najdete v části [Bezpečnost](/cs/security). * **Cíl záznamů** — rekordéry odesílají zaznamenaná data aplikace na server, který nastavíte. Instalační a aktualizační nástroje mohou také kontaktovat nastavené služby pro distribuci vydání. * **Řízení přístupu** — k workspace přistupujete pomocí přihlášení v prohlížeči nebo bearer tokenu; sdílecí odkazy mají vlastní pravidla přístupu. * **Auditované** — přihlášení, změny rolí, souhlasy konektorů i nouzové přístupy se zaznamenávají do append-only logu.