Faktee

Chrome extension pro automatické zaúčtování přijatých faktur z Gmailu — AI extrakce přes Gemini 2.5 Flash, export do CSV / Fakturoid (OAuth 2 Client Credentials), QR platba a detekce duplicit.

Status: v0.5.2 — early MVP, soukromá beta pro 5 OSVČ.

Co umí

• Detekuje PDF přílohy v otevřeném Gmail emailu, vloží tlačítko „Zpracovat fakturu".
• Pošle PDF přímo do Gemini 2.5 Flash, který vrátí strukturovaná data (dodavatel, IČO, DIČ, datum, položky, DPH, celkem).
• Otevře modal s editovatelnými poli — uživatel může opravit cokoli před exportem.
• QR platba (SPAYD) — modal zobrazí QR kód, který umí číst všechny české banky. Naskenuj v bank appce a platba je předvyplněná. IBAN se automaticky vypočte z českého formátu účtu (prefix-mainNumber/bankCode) přes mod-97 ISO 13616.
• Detekce duplicit — porovná novou fakturu proti historii (top 100) na základě IČO, čísla faktury, VS, částky a data. Při shodě upozorní banner v modalu.
• 3 cesty exportu:
  • Copy JSON do schránky
  • Stáhnout CSV (Excel/Sheets ready, CZ názvy sloupců)
  • Odeslat do Fakturoidu přes REST API (vyžaduje placený plán Fakturoidu)
• Bulk mode: email s 2+ PDFs → jedním klikem zpracovat všechny.
• Historie posledních 100 zpracovaných faktur v popupu, export všech do jednoho CSV.

Tech stack

• Manifest V3, vanilla JS, žádný build krok ani npm.
• Gemini 2.5 Flash API (BYO key) nebo OpenAI GPT-4o jako fallback.
• Fakturoid v3 API (OAuth 2 Client Credentials, Bearer token).
• qrcode-generator (vendor, 13 KB) pro QR rendering.
• chrome.storage.local pro nastavení a historii (nikdy ne PDF bytes ani klíče v logu).

Instalace (developer mode)

1. Stáhni ZIP a rozbal ho.
2. V Chromu jdi na chrome://extensions → zapni Developer mode (přepínač vpravo nahoře).
3. Klikni Load unpacked → vyber rozbalenou složku Faktee-main.
4. Klikni na ikonu Faktee v toolbaru (puzzle ikona → připínáček u Faktee).
5. Do pole Kód vlož aktivační kód který jsi dostal emailem.
6. Klikni Ověřit kód → zobrazí se zelené potvrzení s tvým tier a usage.

Žádné API klíče, žádné účty u Googlu. Stačí aktivační kód.

Nemáš aktivační kód? Kontaktuj vladimirsebian1@gmail.com nebo navštiv stránku Faktee.

Použití

Otevři Gmail email s PDF fakturou → klik na modré „Zpracovat fakturu" → modal → uprav data podle potřeby:

• Zaplatit telefonem: sken QR kódu v bankovní aplikaci → platba předvyplněná, jen potvrdíš
• Stáhnout CSV pro účetní / Excel
• Kopírovat JSON pro vlastní integrace
• Odeslat do Fakturoidu (jen na placeném plánu)

Privacy

• Všechna nastavení a historie jsou výhradně lokálně v chrome.storage.local.
• PDF se odesílá pouze do tebou nakonfigurovaného AI providera (Gemini / OpenAI).
• Žádný server třetí strany. Žádná telemetrie.
• API klíče se nikdy nelogují.

Architektura (od v0.3.0)

Extension  →  Cloudflare Worker (activation code validace)  →  Gemini API
                       │
                       ├─ KV: activation codes + monthly usage
                       └─ tier-based quota (free 10/měs, starter 2000/měs, pro 5000/měs)

Uživatel nemusí řešit API klíče — stačí mu activation code, který dostane emailem po nákupu (nebo zdarma jako beta tester). Pro vývojáře je Advanced mode v popupu, kde lze stále použít vlastní Gemini klíč.

Backend kód je v workers/ složce. Deploy přes Cloudflare Wrangler, free tier = 100k requests/den.

Changelog

v0.5.2 (květen 2026)

• Fix: Po reloadu extension v chrome://extensions se v Gmail tabu objevila chyba Extension context invalidated při kliku na tlačítko. Content script teď detekuje neplatný runtime, zastaví MutationObserver a všem tlačítkům změní text na "Obnov stránku (F5)".

v0.5.1 (květen 2026)

• Fix: Gmail tlačítko se v některých layoutech ořezávalo. Přidán wrapper div .faktee-btn-wrap a button se nyní injektuje do widget kontejneru jednu úroveň výš (.aQH parent), kde má dostatek místa.
• Brand label "FAKTEE" má větší pravý padding pro čistší vzhled.

v0.5.0 (květen 2026)

• Premium redesign Gmail tlačítka — pill button v Google design language
• Inline SVG ikona dokumentu s gradient brand colors
• "FAKTEE" jako jemný brand label oddělený divider linkou
• Label "Extrahovat data z faktury" (jasnější než dřívější "Zpracovat")
• Pulsing animace ikony během loadingu, stage texty bez emoji
• Dark mode podpora (Gmail tmavé téma)
• Bulk button stejný styl, fialový tint pro odlišení

v0.3.0 (květen 2026)

• Activation code systém — uživatel zadá kód místo Gemini klíče
• Cloudflare Workers proxy — Gemini klíč žije na backendu, ne v extension
• Tier-based quota (free / starter / pro / beta)
• Pokročilý režim s BYO klíčem zachován pro vývojáře

v0.2.0 (květen 2026)

• QR platba SPAYD — scan v bank appce
• Detekce duplicit proti historii
• Premium redesign popup hlavičky + sliding tab indikátor
• Manifest název zobecněn (Faktee — Faktury z Gmailu, ne jen Fakturoid)
• Odstraněna dekorativní emoji z UI

v0.1.0 (květen 2026)

• První release
• Gemini PDF extrakce, modal, CSV / JSON / Fakturoid export
• Historie + bulk CSV export
• Bulk mode pro víc PDF v jednom emailu

License

Proprietární — zatím neuvolněno pod open-source licencí.