Jak to funguje

Pro každého, i bez technického zázemí. A pro ty, kteří chtějí vědět přesně co se děje pod kapotou.

Pro každého

Vaše data zůstávají u vás

Stručně: vše zpracovává AI přímo ve vašem okně s Claudem nebo ChatGPT. My jako provozovatelé nemáme přístup k vašim fakturám, příjmům ani osobním údajům, protože je vůbec nevidíme.

🔒

Žádná data na našem serveru

Neukládáme nic z toho, co agentu říkáte. Žádná databáze s vašimi fakturami, příjmy ani rodným číslem. Konverzace probíhá přímo mezi vámi a AI.

Pod kapotou

Technická architektura

Jak to vidí vývojář.

Claude / ChatGPT
drží veškerý stav
v kontextu konverzace
⟷
Action API
stateless helper
api.ucetni-agent.cz
→
ARES / MF ČR
veřejné registry
a schémata
AI drží stav. Server je čistá funkce: přijme vstup → vrátí výstup → zapomene. Žádná DB, žádné sessions, žádné logy s uživatelskými daty.

  • Stateless Action API (Node.js + Express)

    Tři skupiny endpointů: /v1/ares/lookup (dotaz na veřejný ARES, výsledek se cachuje na serveru bez vazby na uživatele), /v1/iban/from-account (čistý výpočet, žádná data), /v1/generate-dph (přijme JSON vstupy → spustí CLI → vrátí XML → temp složka se smaže). Žádné user sessions, žádná autentizace uživatele, pouze API klíč pro ochranu před zneužitím.

  • czechia-paperwork CLI jako jádro

    XML generování obstarává open-source CLI balíček czechia-paperwork, implementuje česká daňová schémata (DPHDP3, KH1, SHV, DPFDP7). Server ho zavolá, přečte výstup a výsledek vrátí přes API. Cli samotné neví nic o uživateli.

  • Plně auditovatelné na GitHubu

    Zdrojový kód API serveru bude zveřejněn na GitHubu pod MIT licencí. Kdokoli si může ověřit chování, nahlásit chybu, nebo server deployovat na vlastní infrastruktuře, pak přes naše systémy neprochází vůbec nic.

// Ukázka: generate-dph endpoint, přijme vstupy, vrátí XML, smaže temp soubory app.post('/v1/generate-dph', (req, res) => { const tmpDir = createTempProject(businessUnit, ledger, period); try { runCli(tmpDir, ['generate-dph', '--period', period]); const xml = fs.readFileSync(path.join(tmpDir, 'filings/...'), 'utf8'); res.json({ xml }); // ← vrátíme XML zpět AI agentovi } finally { fs.rmSync(tmpDir, { recursive: true }); // ← temp složka okamžitě smazána } });
Časté dotazy

Otázky a odpovědi

Vidíte moje faktury nebo příjmy?
Ne. Veškerá data, která agentu zadáváte, zůstávají v okně chatu s Claudem nebo ChatGPT. Na naše servery se dostane jen to, co si AI agent sám vyžádá pro výpočet, typicky IČO dodavatele nebo strukturovaná data pro XML. Nikdy ne celá konverzace.
Co se stane, když okno chatu zavřu?
Data z konverzace zmizí, stejně jako u jakéhokoli jiného chatu s AI. Pokud chcete data zachovat, stáhněte si vygenerované XML soubory před zavřením, nebo použijte funkci exportu z Clauda/ChatGPT.
Mohu si server spustit sám?
Ano, přesně na to je navržen. Stáhněte ZIP nebo naklonujte GitHub repo, spusťte node api-server.js lokálně a v nastavení agenta nasměrujte Action API na localhost. Pak přes naše servery neprochází vůbec nic.
Ukládáte IP adresy nebo logy?
Server neloguje tělo requestů ani identifikátory uživatelů. Standardní systémové logy (chybové hlášky, uptime) mohou obsahovat IP adresu jako každý webový server, to není specifické pro tento projekt a neobsahuje žádná účetní data.
Proč vůbec potřebujete pomocný server?
ChatGPT (a Claude) mají limity: nemůžou samy volat libovolné externí API ani generovat binární soubory. Pomocný server řeší tři věci, které AI sama nedokáže,ověření IČO v ARESu (výpočet IBAN z čísla účtu), výpočet CRC kontrolních součtů pro IBAN, a generování validního XML podle státních XSD schémat. Nic víc.

Zdrojový kód na GitHubu

API server i CLI jádro jsou open source. Prohlédněte si kód, otevřete issue nebo si server spusťte sami.

Zobrazit na GitHubu