MyÚčto 5.0.7 — spolehlivější AI import dokladů

MyÚčto 5.0.7

AI import přijatých dokladů nově spolehlivě funguje také přes Gemini,
OpenAI a Azure OpenAI. Anthropic integrace zůstává beze změny.

Gemini

• Úplný strukturovaný výstup. JSON schema nyní vyžaduje všechny vlastnosti;
  nepovinné hodnoty se vracejí jako null. Gemini už proto nemůže odpovědět jen
  několika poli, která následná validace odmítne.
• Jeden společný kontrakt. Gemini převádí stejné centrální schema jako
  OpenAI a Azure OpenAI, místo aby udržovalo neúplnou ruční kopii.
• Aktuální modely. Výchozí model je gemini-3.6-flash; staré nebo
  nepodporované uložené názvy modelů se bezpečně převedou na aktuální výchozí
  model.
• Delší faktury bez useknutého JSON. Limit úplné extrakce je zvýšen na
  16 384 tokenů. Gemini 3.x používá nízkou úroveň interního uvažování, aby
  reasoning nespotřeboval prostor určený pro strukturovanou odpověď.
• Nové API klíče. Validace už nevyžaduje historický prefix AIza a přijímá
  také současné formáty klíčů vydávané Google AI Studio.

OpenAI a Azure OpenAI

• Požadavky používají aktuální parametr max_completion_tokens; modely, které
  odmítají zastaralé max_tokens, už proto neselhávají.
• Strukturovaný výstup používá strict JSON schema shodné s Gemini.
• Limit úplné extrakce je zvýšen na 16 384 tokenů, takže vícepoložkové doklady
  nekončí neúplnou odpovědí.
• Azure OpenAI používá stejnou opravenou větev jako přímé OpenAI, včetně testu
  připojení.

Diagnostika a ověření

• Chyby Gemini zapisují bezpečnou diagnostiku modelu, HTTP stavu, důvodu
  ukončení a počtu tokenů bez ukládání API klíče nebo obsahu PDF.
• Kontraktní testy kontrolují skutečný odchozí payload všech providerů,
  povinná pole schematu i parametry limitu odpovědi.
• Prakticky ověřeno na jedno- i vícepoložkových PDF proti uloženým datům:
  hlavičky, dodavatelé, data, měny, položky, sazby i součty odpovídají.

Instalace a aktualizace

docker pull ghcr.io/radekhulan/myucto:5.0.7

Nativní instalace lze aktualizovat v Systém → Aktualizace, případně ručně
stažením release bundlu myucto-5.0.7.tar.gz níže.

Před použitím AI importu zkontrolujte nastavený model a platný API klíč
vybraného poskytovatele. Vytěžené účetní a daňové údaje vždy před zaúčtováním
porovnejte s originálním dokladem.

Full Changelog: v5.0.6...v5.0.7

v5.0.6

MyÚčto 5.0.6

Nativní instalace se nově aktualizují z UI jedním tlačítkem — stejně jako
Docker. Dosud jim aplikace uměla jen vypsat příkazy k ručnímu spuštění.

Nativní aktualizace z UI

• Aktualizace jedním tlačítkem i bez Dockeru. V Systém → Aktualizace
  klik na „Aktualizovat na vX.Y.Z" stáhne production bundle z release,
  ověří jeho SHA-256, nasadí ho přes instalaci a spustí migrace.
• Composer, Node ani pnpm na hostu nejsou potřeba — bundle má
  api/vendor/, web/dist/, manual/generated/ i manual/manual.pdf
  už představěné. Stačí PHP CLI a práva na zápis.
• Průběh krok za krokem — UI ukazuje, co se zrovna děje (stahování,
  ověření součtu, rozbalení, záloha, nasazení, migrace), takže dlouhý
  běh nevypadá jako zaseknutý.
• Preflight předem řekne, jestli to půjde. Zkontroluje práva, volné
  místo, PHP CLI a zlib; když prostředí automatickou cestu neumožní
  (typicky sdílený hosting), vypíše konkrétní důvody a nabídne ruční
  postup s tímtéž bundlem.

Co aktualizace nikdy nepřepíše

cfg.php, cfg.local.php, cfg.docker.php, .env, storage/,
private/, log/, tmp/ a .git/. Soubory, které v novém bundlu
nejsou, se nemažou. Přepisované soubory se zálohují do
storage/updates/<verze>/backup/.

VERSION se přepisuje až jako poslední krok po migracích — přerušená
aktualizace se tak nikdy netváří jako dokončená.

Zotavení z chyby

• Selhání při stahování, ověření součtu nebo rozbalení instalaci vůbec
  nezmění.
• Selhání při nasazování souborů spustí automatický rollback ze
  zálohy.
• Selhání migrace rollback záměrně nespouští (schéma už může být
  změněné) — výsledek se označí jako neúspěšný a odkáže na log
  storage/upgrade-<timestamp>.log.

Spolehlivost rozbalování

Rozbalování bundlu má nově vlastní implementaci místo PHP PharData.
Důvod je věcný: GNU tar dělí cesty delší než 100 znaků do ustar polí
prefix + name (takové cesty jsou v api/vendor/ běžné) a PharData
na nich selže tak, že nerozbalí vůbec nic. Nový extraktor tyto cesty
zvládá, odmítá traversal cesty, odkazy i speciální soubory a kontroluje
hlavičkové součty. Ověřeno proti reálnému bundlu — výsledný strom je
byte-identický s výstupem GNU tar.

Drobné opravy

• Návod pro ruční aktualizaci v UI odkazoval na neexistující soubor
  myinvoice-X.Y.Z.tar.gz; správně je myucto-X.Y.Z.tar.gz.
• Odkaz „Detaily v manuálu" na stránce Aktualizace mířil na špatnou
  kapitolu.

Instalace a aktualizace

docker pull ghcr.io/radekhulan/myucto:5.0.6

Nativní hosting: pokud už běžíš na 5.0.5, aktualizuj ručně podle § 75.6
manuálu — automatické tlačítko je součástí až této verze a funguje od
příštího vydání dál. Jinak stáhni myucto-5.0.6.tar.gz níže, ověř
kontrolní součet, rozbal přes stávající instalaci a spusť
php api/bin/migrate.php.

⚠️ Aktualizace přepisuje soubory běžící aplikace. Na produkci ji
spouštěj v klidném okně a měj aktuální zálohu databáze.

Full Changelog: v5.0.5...v5.0.6

v5.0.5

MyÚčto 5.0.5 — první vydání

První veřejné vydání MyÚčto.cz — českého self-hosted účetního a fakturačního
systému, který vede firmu celým účetním cyklem od prvního dokladu až po daňovou
a účetní uzávěrku. Aplikace, databáze i doklady zůstávají na vaší
infrastruktuře; do cloudu neodchází nic.

MyÚčto.cz je nástupcem open-source systému
MyInvoice. Veškeré funkce MyInvoice
zůstávají v MyÚčto navždy zdarma a plně použitelné i bez aktivní licence.
Číslování verzí pokračuje v řadě MyInvoice, proto vydání nese číslo 5.0.5.

Co je v základu zdarma

• Prodej a pohledávky — faktury, zálohy, opravné doklady, pravidelná
  fakturace, více měn, DPH / reverse charge / OSS, PDF s QR platbou, upomínky,
  saldo a cash-flow.
• Nákup a AI zpracování — přijaté faktury a účtenky, import ISDOC /
  Pohoda XML / PDF, AI extrakce dokladů, kontrola součtů a DPH, návrh
  nákladového účtu s povinným potvrzením.
• Banka a pokladna — více účtů a měn, import výpisů, automatické párování
  podle VS a částky, částečné úhrady, kurzové rozdíly, pokladní doklady.
• Výkazy DPH — přiznání, kontrolní a souhrnné hlášení, archiv XML.
• Reporting a klientský portál — přehled tržeb, nákladů, pohledávek
  a cash-flow, responzivní rozhraní, role admin / účetní / klient /
  pouze pro čtení.
• Více firem a API — neomezený počet firemních agend v jedné instalaci,
  REST API v1 s osobními tokeny a scopes.

Co přidává komerční licence (60 dní zdarma)

Podvojné účetnictví (účtový rozvrh, předkontace, automat účtování, deník,
hlavní kniha, předvaha, rozvaha, výsledovka, saldokonto), účetní nástroje
a uzávěrky včetně závěrkové mapy K1–K10 a přílohy k závěrce, daň z příjmů
(DPFO/DPPO), daňovou evidenci, evidenci majetku a odpisy, sklad a napojení
e-shopu, EPO podání a archív a rozšířené opravy DPH (§ 74b, § 43, § 46, § 79).

Kontrola místo slepé automatizace

Automat je systém pravidel, ne neprůhledné „AI účtování". Položka se zaúčtuje
jen tehdy, když je výsledek jednoznačný, období otevřené, částka pod limitem
a nechybí předkontace. Neznámá měna, nevyrovnaný zápis, uzavřené období nebo
chybějící kurz operaci zablokují a vysvětlí proč. AI návrhy nelze hromadně
schválit a nikdy se nezaúčtují bez potvrzení účetní.

Požadavky

• PHP 8.5+, MariaDB 11.8 LTS+, Docker / IIS / Apache
• Docker image je multi-arch (linux/amd64, linux/arm64)

Instalace

docker pull ghcr.io/radekhulan/myucto:5.0.5

Nativní hosting: stáhni myucto-5.0.5.tar.gz níže, ověř kontrolní součet
a rozbal do cílového adresáře; poté spusť php api/bin/migrate.php.

Postup krok za krokem popisuje online manuál.

Upozornění

MyÚčto.cz připravuje a kontroluje podklady, ale nenahrazuje odborný úsudek
účetní ani daňového poradce. Daňové a účetní výstupy před finálním použitím
odborně zkontrolujte.