# Nástěnky, tagy a diagramy (https://docs.vitrinka.ai/cs/dev/cli/boards)



## Ze sady nástěnku [#create]

Push snímků už přistane na své nástěnce cesty, `<project>-<branch>-<key>`, a vypíše její adresu; push dokumentu přistane jako karta dokumentu na `/a/<id>`. Po `board create` sáhněte, jen když chcete jiný slug nebo název, případně větvící se strom `--journey` ze stejné sady:

```bash
vitrinka board create --title "Košík — třetí kolo"
```

| Přepínač               | Co dělá                                                            |
| ---------------------- | ------------------------------------------------------------------ |
| `--title` / `--btitle` | Název nástěnky.                                                    |
| `--slug`               | Slug nástěnky. Výchozí je `<project>-<branch>-<key>`, adresa sady. |
| `--journey`            | Postaví větvící se strom cesty místo plochého flow.                |
| `--actor`              | Připsání přes `X-Board-Actor`. Výchozí je uložený operátor.        |
| `--root`               | Kořen záznamu. Výchozí `.vitrinka/screenshots`.                    |

## Najít nástěnku [#find]

`list` filtruje podle tří os, pod kterými je nástěnka zařazená — projekt, podskupina a tag — plus podle typu.

```bash
vitrinka board list --project myapp --type journeys
vitrinka board view kosik-treti-kolo
```

| Přepínač     | Co dělá                                                      |
| ------------ | ------------------------------------------------------------ |
| `--project`  | Jen nástěnky patřící tomuto projektu.                        |
| `--subgroup` | Jen nástěnky v této podskupině.                              |
| `--type`     | Jen nástěnky daného typu — `brainstorm`, `docs`, `journeys`… |
| `--tags`     | Oddělené čárkami. Předřaďte `-` a tag vyloučíte.             |
| `--match`    | Jak tagy kombinovat: `all` (výchozí) nebo `any`.             |
| `--archived` | Zahrne i archivované nástěnky.                               |

## Otevřít nástěnku [#open]

`board open` otevře živou nástěnku kořene záznamu, pokud sada existuje, jinak vitrinka home. Režim QR je na to, jak dostat nástěnku na tablet bez psaní adresy.

```bash
vitrinka board open
vitrinka board open --qr      # naskenujte iPadem, anotujte Pencilem
vitrinka board open --print   # jen vypíše adresu
```

| Přepínač    | Co dělá                                                   |
| ----------- | --------------------------------------------------------- |
| `--qr`      | Vykreslí adresu jako QR kód v terminálu místo otevření.   |
| `--print`   | Jen vypíše adresu.                                        |
| `--browser` | Vynutí https adresu i když je nainstalovaná Vitrinka.app. |

## Otevřít v desktopové aplikaci [#edit]

`board edit` zaostří běžící Vitrinka.app na soubor nebo projekt a zapíše repozitář do registru projektů, aby seznam v aplikaci zůstal aktuální. Funguje jen na macOS a vyžaduje desktopovou aplikaci Vitrinka, která se dodává odděleně od CLI; jinde, nebo bez ní, dostanete vypsaný deep link.

```bash
vitrinka board edit .
vitrinka board edit --print   # jen vypíše deep link
```

## Dostat něco na nástěnku [#put]

`upload` na ni položí libovolné soubory jako karty. `dump` vysype celý adresář záběrů najednou — nástěnku založí, když chybí, nahraje každý obrázek v pořadí podle názvu a z render-audit `audit.json` (pokud v adresáři je) složí jednu kartu s ledgerem. `import-chat` publikuje přepis chatu — eve run nebo NDJSON — jako kartu s konverzací.

```bash
vitrinka board upload ./report.html ./notes.md --board checkout-pass-3
vitrinka board dump ./zabery/kolo-3 --board checkout-kolo-3
vitrinka board import-chat run.ndjson --board checkout-pass-3 --redact
```

| Přepínač `dump`      |                                                                    |
| -------------------- | ------------------------------------------------------------------ |
| `--board`            | Cílový slug. Bez něj: `render-audit-<date>-<label>-<sha7>`.        |
| `--project`          | Vlastnický projekt při založení nástěnky (výchozí `benchmarking`). |
| `--workspace`        | Zapsat do tohoto workspace místo navázaného.                       |
| `--label`, `--title` | Označení kola (výchozí: název adresáře) a titulek nástěnky.        |

| Přepínač `upload`     |                                                                                     |
| --------------------- | ----------------------------------------------------------------------------------- |
| `--board`             | Cílový slug. Povinný.                                                               |
| `--section`           | Přistane uvnitř pojmenovaného rámu sekce.                                           |
| `--anchor` · `--side` | Přiloží se k id karty, vedle ní vpravo (`right`) nebo pod ni (`below`).             |
| `--create-section`    | Založí `--section` jako nový rám, i když se jeho název skoro shoduje s existujícím. |

`board cards rm` karty zase sundá — měkce: skončí v koši nástěnky (záložka Trash), odkud je operátor může obnovit. Id berou seznamy s čárkami i rozsahy. Vaše vlastní karty jdou rovnou do koše, až 25 na jedno volání a 30 % nástěnky; karty někoho jiného nebo větší dávka potřebují `--why` s důvodem o nejméně 20 znacích.

```bash
vitrinka board cards rm checkout-pass-3 362-370
vitrinka board cards rm checkout-pass-3 412,415 --why "duplikáty z druhého kola, nahradily je snímky třetího"
```

## Sdílení s lidmi zvenku [#share]

`share` vyrazí sdílecí odkaz na veřejné sdílecí doméně. Odkaz je zároveň klíč: kdo ho má, otevře nástěnku bez účtu. Každý odkaz sdílí celou nástěnku. `--card` jen určí, kde se otevře: na daném prvku jako dokument místo na plátně. Takhle se sdílí artefakt z jeho pohledu `/a/<id>`. Příjemce se ale může přepnout na nástěnku a přečíst každou kartu na ní, takže artefakty pro cizí oči drž na nástěnce, kde vedle nich není nic soukromého. Osobní nástěnky odkazy nevydávají.

```bash
vitrinka board share kosik-treti-kolo --mode annotate --expires 7d
vitrinka board share dokumentace --card 336
```

| Přepínač    | Co dělá                                                                           |
| ----------- | --------------------------------------------------------------------------------- |
| `--mode`    | `view` (výchozí) nebo `annotate`, kdy držitelé odkazu můžou nechávat připomínky.  |
| `--expires` | `24h`, `7d`, `30d` (výchozí) nebo `never`.                                        |
| `--card`    | Id prvku, na kterém se odkaz otevře jako dokument. Odkaz dál dává celou nástěnku. |

## Tagy [#tags]

Třetí osa vedle projektu a podskupiny.

```bash
vitrinka tag add kosik-treti-kolo regrese platby
vitrinka tag list
vitrinka tag remove kosik-treti-kolo regrese
```

## Diagramy [#diagrams]

`import` rozparsuje soubor, který stejně udržujete — OpenAPI, SQL DDL nebo docker-compose — do diagramu; `schema push` lokálně prozkoumá živý Postgres a nahraje, co našel. Oba berou `--section` pro přistání uvnitř rámu a `--rev` pro revizi zdroje, kterou ukazuje mikroštítek ↻ na kartě.

```bash
vitrinka board diagram import docker-compose.yml --board checkout-pass-3
vitrinka board diagram schema push --db postgres://localhost/app --board checkout-pass-3   # psql běží lokálně; adresa nikdy neopustí stroj
```