7. První spuštění (setup wizard)
Po čerstvé instalaci je celá aplikace zamčená na setup wizard. Žádný jiný endpoint kromě setup endpointů a healthchecku neodpovídá. Wizard je jednorázový — jakmile vznikne první admin účet, wizard zmizí a obnoví se až po reset.php.
Wizard má 3 kroky (admin → dodavatel → sample data) a po dokončení tě automaticky přihlásí. Předchází jim ještě kontrola prostředí, která se ale ukáže jen tehdy, když je co řešit.
7.1 Kontrola prostředí
Než tě wizard pustí k zakládání účtu, zkontroluje prostředí instalace: verzi PHP a rozšíření, verzi a znakovou sadu MariaDB, limity nahrávání, práva zápisu, volné místo a nespuštěné migrace. Plánované úlohy se v této fázi nekontrolují — na čerstvé instalaci ještě žádná neproběhla.
- Vyhovující prostředí kontrolu vůbec nezobrazí a wizard začne krokem 1.
- Varování (například chybějící volitelné rozšíření) tě nezastaví: setup jde dokončit a připomínka zůstane v hlavičce wizardu.
- Problém (stará verze PHP, chybějící povinné rozšíření, MySQL místo MariaDB, nedostupná databáze, nespuštěné migrace) je potřeba opravit — instalace by s ním nedoběhla nebo by se rozbila při prvním použití.
U každého nálezu je vidět naměřená hodnota, očekávaná hodnota, dopad a náprava včetně odkazu do příslušné kapitoly manuálu. V Dockeru odkazy míří na 3. Instalace Docker — PHP i MariaDB se tam ladí v image a v docker-compose.yml, ne v php.ini na hostiteli. Po nápravě klikni na Zkontrolovat znovu.
Stejná kontrola je i po instalaci v Systém → Diagnostika, kde navíc hlídá plánované úlohy, velikost logů, strukturu databáze proti migracím a dostupnost novější verze — viz 999. Řešení problémů.
7.2 Krok 1 — Administrátor
Vytvoříš první uživatelský účet se systémovou rolí Superadmin (plná práva).
| Pole | Význam |
|---|---|
| Jméno | Tvoje jméno (zobrazí se v UI a v aktivity logu) |
| Login + adresa pro reset hesla / system notifikace | |
| Heslo | Min. 12 znaků, indikátor síly (slabé / střední / silné). Bez maxima — passphrase je OK. |
| Heslo znovu | Ověřovací duplicita |
| Vyžadovat silné MFA | Po dokončení wizardu musí admin zaregistrovat passkey nebo zapnout TOTP |
Povolené jsou obě metody — uživatel si na stránce /setup-mfa vybere. Zúžit výběr jde až v konfiguraci přes auth.allowed_mfa_methods, viz 102. Bezpečnost.
Klikni Další.
💡 Tip: Použij passphrase 4–5 slov místo krátkého složitého hesla. „korelace medvědí dýně přístav 2026" je odolnější vůči brute-force než „Hu1@n!".
7.3 Krok 2 — Dodavatel
Vyplníš údaje o prvním dodavateli (firmě nebo OSVČ), za kterého budeš fakturovat. Můžeš jich později přidat víc — viz 95. Multi-supplier.
| Sekce | Popis |
|---|---|
| Firma / jméno OSVČ | Bude v hlavičce všech vystavených PDF |
| IČO | Klikni vedle na Načíst z ARES a předvyplní se název, DIČ, adresa, právní forma. ARES je oficiální veřejný registr — fungující v ČR. |
| DIČ | U OSVČ neplátce nech prázdné |
| Adresa | Ulice, město, PSČ, země — pro fakturační hlavičku |
| E-mail / telefon | Kontakt pro klienta |
| Bankovní účet | První účet pro CZK — číslo + bank kód (např. 1000000005 / 0100 pro KB) |
Klikni Další.
⚠️ Bankovní účet musí projít mod-11 kontrolou (povinný formát českých účtů). Pokud zadáš neplatné číslo, QR platba se ve faktuře nezobrazí. Příklad platného testovacího čísla:
1000000005 / 0100.
7.4 Krok 3 — Sample data (volitelné)
Checkboxem si můžeš nechat vygenerovat testovací sadu dat pro vyzkoušení systému před tím, než začneš fakturovat naostro:
- 24 klientů a 12 dodavatelů z více zemí s různými jazyky a měnami
- 36 zakázek, 120 vystavených faktur, 12 dobropisů a 120 přijatých faktur
- pravidelnou fakturaci, jednu pokladnu se sedmi pohyby a knihu jízd s autem, jízdami a tankováními
Pro s.r.o. nebo plátce DPH generátor navíc automaticky zapne podvojné účetnictví a skladovou evidenci. Založí účtový rozvrh a účetní období, sklad s položkami a 120 příjemkami/výdejkami, dva majetky v odpisových skupinách 1 a 2, trojici e-shopových kategorií a výrobců přiřazených skladovým kartám, šest bankovních výpisů se 120 pohyby a všechny doklady zaúčtuje do účetního deníku. Část faktur spáruje s bankovními úhradami, takže lze vyzkoušet také saldokonto a párování plateb.
Sample data nejdou doinstalovat zpětně — pokud teď přeskočíš a později zjistíš, že je chceš, dostaneš 409 setup_done (ochrana proti přepsání reálných faktur). Reset přes php api/bin/reset.php smaže všechno a wizard se objeví znovu.
Odebrání ukázkových dat. Jakmile sis sadu vygeneroval a chceš začít načisto jen s vlastními daty, najdeš v Systém → Nastavení sekci Ukázková data s tlačítkem *Odebrat ukázková data* — smaže přesně vygenerovanou sadu a tvoje vlastní záznamy nechá být. Sekce se zobrazí jen tehdy, když nějaká ukázková data existují. Alternativně z příkazové řádky php api/bin/reset.php --keep-users-supplier smaže všechna byznys data, ale ponechá přihlášení a nastaveného dodavatele.
Klikni Dokončit. Pokud není silné MFA povinné, wizard tě automaticky přihlásí a přesměruje na Přehled (dashboard). Při povinném MFA dostaneš nejprve omezenou stránku /setup-mfa; plný přístup vznikne až po registraci jedné z povolených metod. Passkey vyžaduje stabilní HTTPS hostname v app.url (lokálně je podporované http://localhost).
7.5 Co dál po setupu
- Otevři Systém → Nastavení a doplň, co wizard nepokryl: e-mail kontakt, doplnění více bankovních účtů — viz 96. Nastavení.
- Systém → Číselníky → Měny — pokud fakturuješ i v EUR, doplň druhý účet (IBAN + BIC).
- Systém → Uživatelé — pokud má systém používat někdo další (účetní), přidej ho.
- Systém → E-mail šablony — uprav uvítací text e-mailů (faktury, upomínky).