Co vitrínka nabízí
Knihovna artefaktů a platforma anotačních nástěnek v jediném Go binárníku. Rekordéry a agenti publikují, co vytvořili; lidé i agenti se pak potkají na živé nástěnce a píšou do ní; oprava se vrátí i s důkazem.
Smyčka
Jedna věta od testera se stane pracovní položkou, ke které už je připojená obrazovka, oblast i větev. Naslouchající agent si ji vezme z fronty, opraví ji a vedle originálu pověsí snímek po opravě.
- Záznam — rekordér nebo CI job publikuje sadu — snímky, session, HTML report, jakékoli soubory.
- Označení — kdokoli s odkazem označí oblast přímo ve věci samotné a řekne, co je špatně.
- Oprava — připojený agent položku přečte, změní kód a publikuje důkaz zpět na tutéž nástěnku.
Části
Šest věcí, které nástěnka unese; každá má v této dokumentaci vlastní stránku.
| Část | Co to je |
|---|---|
| Nástěnky | Nekonečné plátno, kde tiketem je sama obrazovka — označte oblast, napište jednu větu. |
| Záznamy | Přehratelná nahrávka: DOM, síťový waterfall a konzole na jedné časové ose. |
| Uživatelské cesty | Obrazovky propojené v pořadí, jak jimi někdo prošel; větvení jako rozcestníky. |
| Artefakty | Samostatné interaktivní stránky, živé na plátně, aktualizované na místě na stejné URL. |
| Diagramy | Architektura vygenerovaná z docker-compose, OpenAPI, SQL schématu nebo živé databáze. |
| Dokumenty | Markdown stránky navázané na soubory v repozitáři, prolinkované s uzly diagramu. |
Tři díly
Je tu server, věci, které si nainstalujete na stroje, a engine, který kreslí plátno.
| Díl | Co to je |
|---|---|
| Server | Jeden statický Go binárník: HTTP API, webové UI a SQLite, s blob soubory na disku nebo v S3. |
| Klienti | CLI vitrinka, plugin pro Claude Code / Codex se skilly a rekordéry. |
| Boards engine | Vendorovaný JS ostrov bez buildu, který v prohlížeči vykresluje plátno. |
Npm balíčky
Všechno, co se instaluje z npm, žije pod scopem @vitrinka — dva balíčky, každý s vlastní stránkou v této dokumentaci.
| Balíček | Co to je |
|---|---|
@vitrinka/cli | Binárka vitrinka: CLI a MCP server v jedné globální instalaci. |
@vitrinka/expo | Toolkit pro Expo / React Native — dnes nese rekordér cest. |
@vitrinka/cli si správnou platformní binárku (@vitrinka/cli-<os>-<arch>) vyřeší sám jako optional dependency — tyhle balíčky jsou instalatérství, nikdy něco, co instalujete přímo.
Kde končí vaše data
Tam, kam postavíte binárník. Metadata v SQLite, blob soubory na vašem disku nebo v jakémkoli S3 úložišti, a air-gapped režim pro sítě, které na internet nesahají vůbec.
- Žádná cizí telemetrie — rekordéry posílají výhradně na adresu serveru, kterou nastavíte.
- Každý požadavek ověřený — prohlížeče nesou session cookie, strojoví klienti token omezený na workspace.
- Auditované — přihlášení, změny rolí i nouzové přístupy se zaznamenávají.