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

***

## Uživatelská dokumentace

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

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

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

## Integrace

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