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í.
7.1 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é metody | Passkey, TOTP nebo obě možnosti |
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.2 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 70. 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.3 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.4 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 71. 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).