> For the complete documentation index, see [llms.txt](https://docs.spiroq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spiroq.com/readme.md).

# spiroq — Dokumentace

Vítejte v dokumentaci systému spiroq pro správu prodejních automatů.

***

## Uživatelské návody

Jednoduché návody krok za krokem — ideální pro začátek:

| Návod                                                                        | Popis                                                  |
| ---------------------------------------------------------------------------- | ------------------------------------------------------ |
| [Co je to Admin Hub?](/navody/co-je-admin-hub.md)                            | Co vám Admin Hub přináší a proč ho potřebujete         |
| [Jak poprvé spustit spiroq](/navody/prvni-spusteni.md)                       | Instalace aplikace, první zapnutí a základní nastavení |
| [Jak propojit automat s Admin Hubem](/navody/propojeni-s-admin-hubem.md)     | Připojení automatu k internetu a registrace            |
| [Hromadný import produktů (CSV / XLSX)](/navody/import-produktu-csv-xlsx.md) | Import katalogu z tabulky v Admin Hubu                 |

***

## Uživatelská dokumentace

| Sekce                                                    | Popis                                                 |
| -------------------------------------------------------- | ----------------------------------------------------- |
| [Úvod a přehled systému](/uvod.md)                       | Architektura, role, slovníček pojmů                   |
| [Zprovoznění automatu](/zprovozneni-automatu.md)         | Hardware, instalace, provisioning, připojení k cloudu |
| [Admin portál](/admin-portal.md)                         | Přihlášení, navigace, dashboard, role a oprávnění     |
| [Správa strojů](/sprava-stroju.md)                       | Detail stroje, mapa, MQTT příkazy, bannery            |
| [Produkty a cenotvorba](/produkty-a-ceny.md)             | Produkty, kategorie, cenová pravidla, pricing sync    |
| [Sloty a zásoby](/sloty-a-zasoby.md)                     | Konfigurace slotů, layout, inventura, sklad           |
| [Doplňování zásob](/doplnovani-zasob.md)                 | Refill workflow, buffer, inventární pohyby            |
| [Monitoring a diagnostika](/monitoring-a-diagnostika.md) | Logy, diagnostika, troubleshooting                    |

## Technická dokumentace (pro vývojáře)

| Sekce                                                   | Popis                                                |
| ------------------------------------------------------- | ---------------------------------------------------- |
| [Přehled technické dokumentace](/tech.md)               | Rozcestník pro vývojáře                              |
| [Architektura a integrační body](/tech/architektura.md) | Systémová architektura, autentizace, datové konvence |
| [GraphQL API](/tech/graphql-api.md)                     | Entity, příklady dotazů, CRUD operace                |
| [Produkty přes API](/tech/produkty-api.md)              | Mutace produktů a kategorií, dávky, EAN/SKU          |
| [MQTT protokol](/tech/mqtt-protokol.md)                 | Real-time příkazy, eventy, pricing sync              |
| [Integrace e-shopu](/tech/integrace-eshop.md)           | Kompletní návod pro napojení e-shopu                 |

## Integrace

| Sekce                                        | Popis                                |
| -------------------------------------------- | ------------------------------------ |
| [Wolt — nastavení](/wolt/setup.md)           | Zprovoznění Wolt integrace           |
| [Wolt — technický popis](/wolt/technical.md) | Architektura, webhooky, datový model |