Skip to content

Začínáme

Tento průvodce vás provede prvním nastavením systému Dveřník.

Nová instalace

Zakládáte-li celou novou instalaci (server, první admin, region, zařízení, ceník, produkty), použijte raději Nová instalace: konfiguraci lze naimportovat jako balíček z jiné instalace nebo složit z předvoleb.

První spuštění

Po spuštění aplikace je k dispozici administrační rozhraní PocketBase na adrese /_/. Při prvním spuštění vytvořte administrátorský účet.

Základní nastavení

1. Vytvořte zónu

Zóna představuje fyzický prostor (např. posilovna, hřiště, lezecká stěna). V administraci PocketBase (/_/) vytvořte záznam v kolekci zones:

Pole Popis Příklad
name Název zóny "Posilovna"
slug URL identifikátor "posilovna"
description Popis "Hlavní posilovna v 1. patře"
session_mode Typ relace entry_based nebo time_based
max_concurrent_sessions Maximální kapacita 10 (0 = bez limitu)
is_active Aktivní true

Entry-based vs Time-based

  • Entry-based — uživatel zaplatí fixní částku při vstupu (např. 100 Kč za vstup)
  • Time-based — cena se počítá podle doby pobytu (např. 1,67 Kč/min)

Více v sekci Zóny.

2. Přidejte zařízení

Zařízení (zámek, světlo, zásuvka) se vytváří v kolekci devices:

Pole Popis Příklad
name Název "Hlavní zámek"
type Typ zařízení lock, light, outlet
communication_adapter Komunikační protokol demo, rest_api
adapter_config JSON konfigurace {} pro demo
lock_mode Režim zámku permanent, short_open_5s
is_active Aktivní true

Pro testování použijte adaptér demo, který simuluje zařízení bez fyzického hardwaru. Pro skutečný hardware (rest_api) začněte z hotové předvolby přímo ve formuláři zařízení — viz Předvolby a kontrola konfigurace.

3. Přiřazení zařízení k zóně

V kolekci zone_devices propojte zařízení se zónou:

Pole Popis Příklad
zone Odkaz na zónu (vyberte zónu)
device Odkaz na zařízení (vyberte zařízení)
role Role zařízení primary nebo secondary

Důležité

Každá zóna musí mít alespoň jedno primární zařízení (typicky zámek). Bez něj nelze zahájit relaci.

4. Nastavte ceník

Vytvořte cenová pravidla v zone_pricing_rules (pro celou zónu) nebo device_pricing_rules (pro konkrétní zařízení):

Příklad pro entry-based zónu (fixní vstupné):

Pole Hodnota
zone (vaše zóna)
rule_type flat_fee
amount 100
is_active true

Příklad pro time-based zónu (minutová sazba):

Pole Hodnota
zone (vaše zóna)
rule_type per_minute
amount 1.67
time_from 08:00
time_to 21:00
priority 1
is_active true

Více v sekci Ceníky.

5. Konfigurace aplikace

Základní nastavení v kolekci app_config:

Klíč Hodnota Popis
COUNTRY_CODE CZ ISO 3166-1 alpha-2 kód země (určuje jazyk notifikací)
BANK_NUM Číslo účtu (IBAN) Pro generování QR kódů
BANK_NUM_SHORT Krátké číslo účtu Zobrazení uživateli
CURRENCY_CODE CZK Měna

Kompletní přehled v sekci Konfigurace.

Testování

Po nastavení zóny, zařízení a ceníku:

  1. Zaregistrujte testovací účet přes frontendovou aplikaci
  2. Přihlaste se a dobijte kredit (pokud je povoleno)
  3. Zkuste zahájit relaci v zóně
  4. Ověřte, že zařízení reaguje (v demo režimu se změní stav v app_config)
  5. Ukončete relaci a zkontrolujte výpočet ceny