5. Po instalaci a CLI nástroje

Návod pro správce instalace: co udělat hned po nainstalování MyÚčta, jak naplánovat pravidelné úlohy (cron) a jak ověřit, že zálohy skutečně vznikají a dají se stáhnout. Platí pro Docker i nativní instalaci.

5.1 Kdy to potřebujete

Kapitolu otevřete, když:

• jste právě dokončili instalaci (Docker nebo nativní) a aplikace ještě nemá žádného uživatele,
• potřebujete naplánovat zálohy, párování plateb, upomínky a další úlohy na pozadí,
• chcete ověřit, že plánované úlohy opravdu běží,
• chcete stáhnout zálohu z aplikace, aniž byste se přihlašovali na server,
• hledáte CLI příkaz pro migrace, ukázková data nebo reset.

Převádíte-li existující instalaci MyInvoice, neprocházejte nejdřív setup wizardem. Použijte postup Převod dat z MyInvoice do MyÚčto, který zachová správné pořadí importu a migrací.

5.2 Než začnete

• Instalace dokončená a databáze dostupná (kapitoly 3 nebo 4).
• U Dockeru aplikace odpovídá na http://localhost:8080, u nativní instalace na adrese podle vašeho web serveru.
• Přístup k serveru, kde můžete nastavit Task Scheduler (Windows) nebo crontab (Linux), případně k hostiteli Dockeru.

5.3 Krok za krokem: první spuštění

1. Otevřete aplikaci v prohlížeči. Naskočí setup wizard.
2. Projděte průvodce: založíte první administrátorský účet, volitelně prvního dodavatele a základní konfiguraci. Postup je v kapitole První spuštění (setup wizard).
3. Po dokončení vás aplikace přihlásí a otevře Přehled.

Jak poznáte, že je hotovo: jste přihlášeni a vidíte Přehled. Wizard se už znovu nezobrazí, objeví se až po reset.php.

5.4 Krok za krokem: nastavení hned po prvním přihlášení

1. Dodavatel. Otevřete Firma → Nastavení a na záložkách Údaje firmy a Fakturace doplňte IČO, DIČ, adresu a výchozí údaje faktur. Logo nahrajte v Firma → Branding, bankovní účty založte v Peníze → Bankovní účty na záložce Měny a účty (viz Nastavení).
2. Odchozí pošta (SMTP). V Systém → E-maily a certifikáty na záložce Odesílací profily nastavte SMTP, aby fungovalo odesílání faktur a upomínek.
3. Daňové nastavení. Jste-li plátce DPH, v Firma → Nastavení na záložce Daně a účetnictví zadejte typ poplatníka, periodu DPH a kód finančního úřadu (viz Výkazy DPH).
4. Zabezpečení. Zapněte 2FA, případně IP allowlist, a v Systém → Role a oprávnění nastavte role uživatelů (viz Bezpečnost).
5. Plánované úlohy. Naplánujte cron podle § 5.5.
6. HTTPS a zálohy. Viz § 5.9.1.

Jak poznáte, že je hotovo: můžete vystavit a odeslat zkušební fakturu a stránka Systém → Plánované úlohy nehlásí chybějící úlohy.

5.5 Krok za krokem: naplánování úloh (cron)

V adresáři cmd/ jsou připravené wrappery .cmd (Windows Task Scheduler) i .sh (Linux cron). Zvolte právě jeden způsob plánování:

• Jeden dispatcher. Naplánujte pouze cron-dispatch každou minutu. Sám spouští úlohy v jejich časech a levnou kontrolou přeskočí ty, které nemají práci.
• Jednotlivé úlohy. Naplánujte každý potřebný wrapper samostatně podle tabulky v § 5.9.3.

Oba režimy nekombinujte, jinak by se některé úlohy spouštěly dvakrát.

1. Zvolte režim (doporučen je jeden dispatcher).
2. V Task Scheduleru nebo crontabu založte úlohu, která každou minutu spustí cmd/cron-dispatch.cmd, resp. cmd/cron-dispatch.sh.
3. U jednotlivých úloh zadejte frekvenci z tabulky.
4. Počkejte pár minut a otevřete Systém → Plánované úlohy (viz § 5.6).

Jak poznáte, že je hotovo: na stránce Systém → Plánované úlohy mají doporučené úlohy čas posledního úspěšného běhu.

5.6 Krok za krokem: kontrola, že úlohy běží

1. Otevřete Systém → Plánované úlohy.
2. U každé doporučené úlohy zkontrolujte, kdy naposled úspěšně proběhla.
3. Úlohy s varováním Stáří, Selhává nebo Neběželo opravte podle § 5.8.

Každý cron skript si zapisuje vlastní záznam o běhu (start, konec, návratový kód, JSON report). Stránka tak odhalí „cron vůbec není nastavený“ i „cron běží, ale selhává“, bez ohledu na OS (crontab, Task Scheduler, Docker host). Varování se zobrazí, pokud poslední běh chybí nebo je starší než max_age_hours (typicky 36 hodin).

Jak poznáte, že je hotovo: žádná doporučená úloha nemá varování.

5.7 Krok za krokem: stažení záloh z aplikace

Hotové zálohy si správce instalace stáhne bez přístupu k serveru přes SSH nebo FTP.

1. Otevřete Systém → Stažení záloh.
2. Najděte sekci podle druhu zálohy (Databáze, Dokumenty a přílohy, PDF doklady, Mzdy, Personální spisy, Ostatní).
3. U souboru zkontrolujte čas pořízení a velikost a stáhněte ho.
4. Jsou-li zálohy šifrované, klikněte na Zobrazit heslo a znovu se ověřte (passkey, nebo přihlašovací heslo a kód z autentikátoru, máte-li ho zapnutý).

Jak poznáte, že je hotovo: stažený soubor má očekávanou velikost a otevře se (šifrované archivy 7-Zipem, WinRARem nebo unzip -P).

5.8 Když něco nejde

5.9 Podrobnosti a pravidla

5.9.1 Produkční doporučení

• Nasazujte za HTTPS (u Dockeru reverse proxy, viz § 3.8 HTTPS / TLS terminace).
• Zapněte zálohy a ověřte, že běží (Systém → Plánované úlohy).
• Pinujte konkrétní neměnný release tag image a sledujte Aktualizace.

5.9.2 CLI nástroje

php api/bin/migrate.php              # spustí pending migrace
php api/bin/migrate.php --status     # vypíše stav migrací
php api/bin/setup.php                # interaktivní úvodní zřízení
php api/bin/sample.php               # vygeneruje testovací data (po setupu)
php api/bin/sample.php --list        # vypíše firmy a jestli už data mají
php api/bin/sample.php --supplier=7  # testovací data do konkrétní prázdné firmy
php api/bin/reset.php                # smaže všechna user-data (vyžaduje "ANO")
php api/bin/recompute-stats.php      # přepočítá agregované statistiky
php api/bin/delete-company.php --id=7                   # náhled, co se smaže s firmou
php api/bin/delete-company.php --id=7 --confirm=<IČO>   # smaže firmu se všemi daty

delete-company.php smaže jednu firmu včetně dokladů, deníku a převodů, například před zopakováním převodu do čisté firmy. Smazání potvrzuje IČO firmy a běží v jedné transakci. --files smaže i soubory firmy v úložišti. Má-li firma mzdová podání nebo jiné záznamy jen pro přidávání, je potřeba --immutable. Smazání nejde vrátit, proto si předem zálohujte databázi.

5.9.3 Tabulka cron skriptů

5.9.4 Šifrování záloh

Volitelné heslo cron.backup.password v cfg.php zašifruje všechny typy ZIP záloh (DB dump, PDF dokladů, sekce Dokumenty, mzdové podklady) algoritmem AES-256. Pro rozbalení použijte 7-Zip, WinRAR nebo unzip -P, vestavěný Průzkumník Windows šifrované AES-256 archivy neumí otevřít. Šifruje se obsah souborů, názvy souborů uvnitř archivu zůstávají čitelné. Pokud je heslo nastavené a PHP šifrování nepodporuje (libzip < 1.2), záloha se záměrně nevytvoří a úloha skončí chybou. Nešifrovaná záloha by vznikla jen omylem.

5.9.5 Úklid záloh a logů

Zálohovací úlohy samy drží 30 dnů denních záloh a k tomu zálohu z 1. dne každého měsíce po dobu roku. Úloha cron-retention tuhle dobu zkracuje a uklízí i logy a dočasné soubory, které jinak nemaže nic. Na vlastním serveru je vypnutá, protože zálohy aplikace tam často bývají jedinou zálohou, kterou máte. Zapnete ji v cfg.php volbou cron.retention.enabled = true. Výchozí limity (každý lze v cron.retention změnit, hodnota 0 znamená „tuhle kategorii neuklízet“):

Nejnovější záloha každého druhu zůstává vždy, i když je starší než limit. Doklady, dokumenty, mzdové podklady, účetní archivy ani uzávěrkové balíčky úloha nemaže nikdy. Co by smazala, vypíše bez mazání příkaz php api/bin/cron-retention.php --dry-run.

5.9.6 Sekce stránky Stažení záloh

Stránka Systém → Stažení záloh ukazuje obsah adresáře se zálohami rozdělený do sekcí podle toho, která úloha soubor vyrobila:

• Databáze: úplný dump databáze z cron-backup,
• Dokumenty a přílohy: nahrané soubory a bankovní výpisy z cron-backup-documents,
• PDF doklady: vygenerovaná PDF z cron-backup-pdf,
• Mzdy: mzdové podklady z cron-backup-payroll,
• Personální spisy: soubory personálních spisů zaměstnanců z cron-backup-personnel,
• Ostatní: soubory, které pojmenování automatických záloh neodpovídají, typicky ruční kopie bez data v názvu.

Sekce se pozná podle tvaru názvu souboru, ne podle jména databáze, takže zálohy zůstanou ve správné sekci i po přejmenování databáze. V každé sekci je k dispozici pět nejnovějších záloh. V záhlaví sekce je vidět, kolik jich na disku leží celkem a kolik zabírají místa. Starší zálohy zůstávají na serveru, dokud je nesmaže retence.

U každého souboru je čas pořízení a velikost. Pod seznamem je cesta k adresáři na serveru, počet záloh a nastavená retence, tedy kolik souborů (nebo dnů) zpět se drží, než je úloha smaže.

Heslo k šifrovaným zálohám se nezobrazuje samo od sebe ani přihlášenému správci. Nejdřív se musíte znovu ověřit passkeyem, nebo přihlašovacím heslem a kódem z autentikátoru, máte-li ho zapnutý. Každé odhalení se zapisuje do protokolu činnosti (kdo a kdy, samotné heslo nikdy).

Stránka je doplněk Kompletního exportu dat (§ 88.6.2), ne jeho náhrada. Export je jednorázový balíček aktuálního stavu jedné firmy na vyžádání, tady leží historie automatických záloh celé instalace.

5.9.7 Relativní cesty v cfg.php

Cestové klíče (cron.backup.output_dir, storage.*, logging.path, archivy přijatých/importovaných dokladů, DKIM) zadané relativně (např. storage/backup) se ukotvují k rootu aplikace, ne k pracovnímu adresáři procesu. Záloha tak skončí na očekávaném místě, i když cron běží pod Task Schedulerem nebo systémovým cronem s jiným aktuálním adresářem. Absolutní cesty (včetně C:\... a UNC \\server) i MYINVOICE_DATA_DIR zůstávají beze změny.

5.9.8 Stav „Nemá práci“

Platí jen v režimu jednoho dispatcheru. Dispatcher úlohy, které mají levnou kontrolu práce (cron-epo-status, cron-ai-worker), vůbec nespouští, dokud pro ně není co dělat, jejich poslední běh proto legitimně stárne. Že plánování funguje, dokládá záznam o běhu samotného cron-dispatch, a takové úloze se místo varování ukáže neutrální Nemá práci. Jakmile dispatcher sám zestárne nebo začne selhávat, vrátí se u nich normální varování.

5.10 Související kapitoly

• Instalace Docker a Nativní instalace
• První spuštění (setup wizard)
• Převod dat z MyInvoice do MyÚčto
• Nastavení, Bezpečnost, Aktualizace