6. Převod dat z MyInvoice do MyÚčto

Tento postup přenese existující instalaci MyInvoice do nové instalace MyÚčto. Zachová uživatele, jejich členství ve firmách, firmy, klienty, ceník, faktury, přijaté faktury, bankovní výpisy, párování a ostatní data uložená v databázi. Nové účetní tabulky MyÚčta se doplní následnými migracemi a backfilly.

Celý převod dělá jediný příkaz. migrate.php spouštět ručně netřeba — MyInvoiceMigrate.php si schéma připraví, data přenese a migrace MyÚčta dojede sám, ve správném pořadí.

6.1 Předpoklady

• Databázový účet z cfg.php smí číst zdroj a zapisovat do cíle.
• Zdroj MyInvoice má aplikované všechny své migrace.
• Máš samostatnou zálohu obou databází a souborů ze storage/.

MyInvoiceMigrate.php přenáší databázové řádky, nikoli uložená PDF, přílohy, loga ani jiné soubory. Potřebné soubory přenes samostatně se zachováním jejich relativních cest a přístupových práv.

6.2 Proč to nejde jedním migrate.php

MyÚčto přidává vlastní migrace 1000+. Některé z nich nejen vytvářejí tabulky, ale také doplňují data již existujících uživatelů a firem — například role, oprávnění a historii účetního režimu.

Kdyby se všechny migrace spustily před importem, tyto datové kroky by proběhly nad prázdnou databází. Po importu se už neopakují, protože jsou v tabulce migrations označené jako dokončené.

Správné pořadí proto je:

1. připravit upstream schéma MyInvoice,
2. importovat data,
3. teprve potom aplikovat rozšíření MyÚčta.

Skript to řeší za tebe. Pozor na jednu past, kterou hlídá: MyÚčto některé upstream featury přečíslovalo nad 1000 — user_suppliers má migraci 1000, ceník 1121. Kdyby se před importem postavilo jen schéma pod 1000, tabulky by v cíli nebyly a jejich data by se tiše zahodila. Skript si proto dohledá, které migrace 1000+ jsou čistě DDL (nic nedoplňují nad daty), a spustí je už před importem.

6.3 Příprava cílové databáze

V databázové administraci vytvoř cílovou databázi a nastav ji v cfg.php. Pečlivě ověř, že zdrojová databáze, například myinvoice, není současně nastavena jako cíl.

Cíl může být:

• prázdná databáze — doporučený stav,
• databáze s už proběhlým migrate.php — skript ji rozpozná a schéma postaví znovu ve správném pořadí (tabulky zahodí a vytvoří odznova).

Obojí vede ke stejnému výsledku. Pokud cíl už obsahuje data, která nechceš ztratit, převod nespouštěj — cílové tabulky se přepisují.

6.4 Převod

Nejprve spusť migrátor bez automatického potvrzení. Zobrazí zdroj, cíl, stav cílové databáze a plán jednotlivých kroků:

php api/bin/MyInvoiceMigrate.php myinvoice

Pokud plán souhlasí, převod potvrď slovem ANO. Pro neinteraktivní běh:

php api/bin/MyInvoiceMigrate.php myinvoice --yes

Skript projde tyto fáze:

1. Kontrola cíle — zjistí, co v cílové databázi je.
2. Příprava schématu — migrate.php --below=1000 plus čistě DDL migrace 1000+ pro featury, které zdroj už má.
3. Preflight — ověří, že cíl má kam uložit *všechna* data zdroje.
4. Přenos dat.
5. Dokončení — zbylé migrace 1000+ včetně backfillů nad přenesenými daty.

Výstup musí skončit hlášením HOTOVO — data přenesena a schéma MyÚčta dokončeno. a bez sekce CHYBY.

Preflight zastavil převod

Skript se zastaví, dokud by se měla ztratit byť jediná hodnota. Vypíše konkrétně, o co jde:

✗ PŘEVOD ZASTAVEN: cíl 'myucto' nemá kam uložit tato data zdroje:
     - tabulka webauthn_credentials — 4 řádků by se ztratilo
     - sessions.auth_method — 21 vyplněných hodnot by se ztratilo

Nejčastější příčina je starší verze MyÚčta, než je zdrojová instalace MyInvoice. Aktualizuj MyÚčto a spusť převod znovu. Prázdné tabulky a sloupce plné NULL převod nezastaví — vypíšou se jen informativně.

Vědomé pokračování se ztrátou uvedených dat: --allow-missing.

Užitečné přepínače

6.5 Převod v Dockeru

Když zdroj a cíl nejsou na témže databázovém serveru, zadej zdroj jako URL. Skript se připojí druhým spojením a data přenese proudově po dávkách.

MyInvoice v jiném Docker stacku (Docker → Docker)

Zdrojový kontejner musí být dosažitelný ze sítě, v níž běží app kontejner MyÚčta. To za tebe vyřeší připravený wrapper — zdrojový kontejner do sítě dočasně připojí a po dokončení zase odpojí:

.\cmd\docker-migrate-from-myinvoice.ps1 -SourceContainer myinvoice-db-1 `
    -SourceDb myinvoice -SourceUser root -SourcePassword tajne -Yes

Na Linuxu:

cmd/docker-migrate-from-myinvoice.sh --source-container myinvoice-db-1 \
    --source-db myinvoice --source-user root --source-password tajne --yes

Zdrojový stack zůstává beze změny; zapisuje se pouze do cílové databáze MyÚčta.

MyInvoice na hostiteli, MyÚčto v Dockeru

.\cmd\docker-migrate-from-myinvoice.ps1 -SourceHost host.docker.internal `
    -SourceDb myinvoice -SourceUser root -SourcePassword tajne -Yes

Ručně, bez wrapperu

docker compose exec app php api/bin/MyInvoiceMigrate.php \
    "mysql://root:tajne@myinvoice-db:3306/myinvoice" --yes

Heslo lze místo argumentu předat proměnnou MYINVOICE_SOURCE_URL, ať se neobjeví v historii shellu.

6.6 Základní kontrola importu

Před zapnutím účetnictví ověř:

• přihlášení původním administrátorským účtem,
• seznam firem a přístup uživatelů k jednotlivým firmám,
• orientační počty klientů, vydaných a přijatých faktur,
• bankovní výpisy a existující párování,
• php api/bin/migrate.php --status — všechny migrace musí být [x],
• dostupnost PDF, příloh, log a dalších souborů ze storage/.

Některé počty se po importu záměrně liší od zdroje — dokončovací migrace deduplikují párování plateb a doplňují číselníky i členství uživatelů ve firmách.

U více firem prováděj následující účetní kroky samostatně pro každé ID firmy.

6.7 Zapnutí podvojného účetnictví

V nastavení firmy zapni Podvojné účetnictví a zvol správné datum účinnosti. Změna může být účinná pouze k 1. lednu. Datum musí odpovídat skutečnému začátku vedení účetnictví, nikoli automaticky dni převodu.

Poznamenej si ID firmy, které bude v příkazech nahrazovat <ID>.

6.8 Doúčtování historie

Nejdřív zkontroluj předpisy faktur dry-runem, potom spusť ostrý účetní backfill:

php api/bin/backfill-accounting.php --supplier=<ID> --dry-run
php api/bin/backfill-accounting.php --supplier=<ID>

Bankovní backfill je ve výchozím stavu dry-run. Bez --rules zpracovává existující párování a pouze oboustranně jednoznačné historické platby. Nespáruje doklady jen podle podobné částky:

php api/bin/backfill-bank-posting.php --supplier=<ID>
php api/bin/backfill-bank-posting.php --supplier=<ID> --apply

Pokladní historii nejprve jen zkontroluj. Ostrý příkaz je potřeba pouze tehdy, pokud dry-run najde pokladní doklady k doúčtování:

php api/bin/backfill-cash-accounting.php --supplier=<ID> --dry-run
php api/bin/backfill-cash-accounting.php --supplier=<ID>

Nakonec spusť účetní backfill ještě jednou. Po zaúčtování banky a pokladny tím doplní zúčtování přijatých a poskytnutých záloh 324/311 a 321/314:

php api/bin/backfill-accounting.php --supplier=<ID>

Všechny backfilly jsou idempotentní; opakovaný běh nesmí vytvářet duplicity.

6.9 Závěrečná kontrola

Spusť čtecí kontrolu integrity deníku:

php api/bin/cron-journal-integrity-check.php --supplier=<ID> --dry-run

V aplikaci potom zkontroluj:

• Účetnictví → Účetní deník,
• hlavní knihu a obratovou předvahu,
• Účetnictví → Saldo pro účty 311, 321, 314 a 324,
• že plně zaplacené finální faktury ze záloh nezůstávají otevřené,
• že účetní rozdíly nejsou tvořené nepotvrzenými bankovními avízy nebo ručně označenými platbami bez bankovního či pokladního zápisu.

E-mailové bankovní avízo potvrzuje očekávanou platbu, ale samo se neúčtuje jako bankovní výpis. Dočasný rozdíl v saldu proto může zmizet až po importu skutečného výpisu a jeho spárování.

6.10 Obnova při chybě

Pokud import nebo některá migrace skončí chybou, nepokračuj v cílové databázi. Zapiš si chybový výstup, cílovou databázi znovu vytvoř jako prázdnou a celý postup zopakuj. Zdroj MyInvoice zůstává po celou dobu nedotčený.

Návratové kódy MyInvoiceMigrate.php: