3. 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í.
3.1 Krok 1 — Administrátor
Vytvoříš první uživatelský účet s rolí admin (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 |
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!".
3.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 17. Multi-supplier.
| Sekce | Popis |
|---|---|
| Firma / jméno OSVČ | Bude v hlavičce všech vystavených PDF |
| IČ | 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.
3.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:
- 5 klientů (různé země, jazyky, měny — CZ, SK, DE)
- 8 zakázek (1–3 na klienta)
- 20 vystavených faktur za poslední 2 měsíce
- 4 dobropisy
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.
Klikni Dokončit. Wizard tě automaticky přihlásí a přesměruje na Přehled (dashboard).
3.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 18. 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).