___  ____  ____  ____  ____  ___  _  _
/ __)( ___)( ___)( ___)(  _ \/ _ \/ )( \
\__ \ )__)  )__)  )__)  )   ( (_) ) \/ (
(___/(____)(____)(____)(_)\_)\___/ \____/
    

FATROCUv3.0

Yapay zeka destekli, %100 yerel fatura işleme sistemi.
Bulut yok. API maliyeti yok. Veri gizliliği tam.

Rust + Tauri 2.0 llama.cpp DeepSeek-OCR Gemma 4 GGUF Windows x64 %100 Yerel
↓ İndir — v3.0 ★ GitHub
%100 Yerel Çalışma
0₺ API Maliyeti
2 AI Aşamalı Pipeline
Fatura Şablonu

Genel Bakış

Fatrocu Nedir?

Fatrocu; PDF ve görüntü faturalarınızı iki aşamalı bir AI pipeline ile otomatik olarak okuyan, alanları çıkaran ve Excel/CSV olarak dışa aktaran bir Windows masaüstü uygulamasıdır.

📄
Giriş
PDF, PNG, JPG fatura dosyası yüklenir. PDF ise her sayfa 300 DPI PNG'ye dönüştürülür.
PDF → PNG
👁️
OCR Adımı
DeepSeek-OCR GGUF modeli görüntüyü okur ve tabloları koruyarak ham Markdown çıktısı üretir.
DeepSeek-OCR
🧠
Alan Çıkarma
Gemma 4 GGUF modeli Markdown'ı okuyarak fatura numarası, tarih, VKN, KDV ve tutarları JSON olarak çıkarır.
Gemma 4
📊
Çıktı
Kullanıcı alanları inceleme ekranında doğrular ve onaylar. Excel veya CSV olarak dışa aktarılır.
XLSX / CSV


🔒
Tam Veri Gizliliği

Hiçbir fatura verisi internet bağlantısı gerektirmez. Tüm işleme bilgisayarınızda, çevrimdışı gerçekleşir.

Sıfır API Maliyeti

Google, OpenAI veya başka herhangi bir bulut servisine bağımlılık yoktur. Bir kez kur, sonsuza kadar kullan.

🦀
Rust + Tauri 2.0

Electron değil — Rust çekirdeği sayesinde ultra düşük RAM kullanımı ve anında başlatma süresi.

📋
Sonsuz Şablon

Farklı tedarikçiler için farklı fatura şablonları oluşturun. Her şablon kendi alan setini tanımlar.

🔧
GPU Opsiyonel

NVIDIA gerektirmez. CPU üzerinde çalışır; GPU varsa hız artışı için katman sayısını artırabilirsiniz.

📦
Tek Tıkla Kurulum

llama.cpp motorunu ve GGUF modellerini sürükle-bırak ile yükleyin. Karmaşık yapılandırma yok.


Kurulum

Üç adımda çalışır hale getirin.

Uygulamayı İndir

Releases sayfasından en son sürümü indirin:

  • Fatrocu_3.0.0_x64-setup.exe — NSIS kurulum sihirbazı (önerilen)
  • Fatrocu_3.0.0_x64_en-US.msi — MSI paketi
  • fatrocu.exe — Taşınabilir, kurulum gerektirmez

llama.cpp Motorunu Kur

Uygulamayı açın → Ayarlar sekmesi → "Motoru Tek Tıkla Kur" butonuna basın.
llama-cli.exe otomatik olarak GitHub üzerinden indirilir ve yapılandırılır.

Manuel kurulum için: llama.cpp releasesllama-bXXXX-bin-win-cpu-x64.zip

Modelleri Yükle

Yöntem A (Kolay): GGUF dosyalarını Ayarlar ekranındaki sürükle-bırak alanına bırakın.
Program modeli otomatik tanır ve yapılandırır.

Yöntem B: GGUF dosyalarını uygulamanın gguf/ klasörüne yerleştirin. Uygulama başlangıçta bu klasörü otomatik tarar.



Hangi Modeli İndirmeliyim?

Model Amaç Boyut RAM İndirme
DeepSeek-OCR Q6_K OCR — Görüntü → Metin ~2.4 GB ~4 GB HuggingFace →
Gemma 4 E4B IQ4_XS Alan Çıkarma (Önerilen) ~4.5 GB ~6 GB HuggingFace →
Gemma 4 E2B Q4_K_M Hafif — Düşük RAM ~1.4 GB ~3 GB HuggingFace →
Gemma 4 12B Q4_K_M Yüksek Doğruluk ~7.5 GB ~10 GB HuggingFace →

Kullanım Kılavuzu

Nasıl Kullanılır?

Kurulum tamamlandıktan sonra fatura işleme süreci dört basit adımdan oluşur.

Fatura Yükle

Ana ekranda PDF, PNG veya JPG dosyalarını sürükleyip bırakın ya da "Dosya Seç" butonunu kullanın. Çoklu dosya seçimi desteklenir.

AI İşleme

DeepSeek-OCR metni okur, Gemma 4 alanları çıkarır. İşlem süresi model büyüklüğüne ve CPU/GPU hızına göre değişir (genellikle 15–120 saniye).

İncele & Düzenle

İnceleme ekranında çıkarılan alanları doğrulayın. Hatalı veya eksik alanları manuel olarak düzenleyebilirsiniz.

Onayla & Dışa Aktar

"Onayla" ile faturayı arşive ekleyin. Onaylanan tüm faturaları toplu olarak Excel (.xlsx) veya CSV olarak dışa aktarın.


Fatura Şablonları

Her tedarikçi farklı fatura formatı kullanır. Şablonlar, AI'ın hangi alanları çıkaracağını tanımlar.

Şablon Oluşturma Adımları

1
Ayarlar → Fatura Şablonları

Üst menüden Ayarlar sekmesine gidin, "Fatura Şablonları" alt bölümünü açın.

2
"+ Yeni Şablon" Butonuna Tıklayın

Şablon adını girin (örn: "Tedarikçi A Faturaları").

3
Alan Ekleyin

Her alan için bir anahtar kelime ve etiket tanımlayın. AI bu alanları faturadan çıkarmaya çalışacaktır.

4
Kaydet & Kullan

Fatura yüklerken açılır menüden şablonunuzu seçin.

Örnek Şablon Alanları

Genel Fatura Şablonu
faturaNumarasi Fatura No
tarih Fatura Tarihi
vknTcNo VKN / TC No
kdvOrani KDV Oranı (%)
kdvTutari KDV Tutarı (₺)
toplamTutar Genel Toplam (₺)
saticiUnvani Satıcı Ünvanı

Geliştirici

Kaynak Koddan Derleme

Geliştirmek veya katkıda bulunmak için kaynak kodu derleyebilirsiniz.

Gereksinimler

Rust 1.75+
Node.js 18+
Python 3.10+ (PDF dönüştürme için)
Git

Desteklenen Platform

Windows 10/11 x64 (birincil)
macOS / Linux (deneysel)

# 1. Repoyu klonla
git clone https://github.com/Nec0ti/Fatrocu.git
cd Fatrocu

# 2. Node bağımlılıklarını yükle
npm install

# 3. Geliştirme sunucusu (hot-reload)
npm run tauri dev

# 4. Dağıtım build — exe + MSI + NSIS oluşturur
npm run tauri build

# Çıktılar:
#   src-tauri/target/release/fatrocu.exe
#   src-tauri/target/release/bundle/msi/Fatrocu_3.0.0_x64_en-US.msi
#   src-tauri/target/release/bundle/nsis/Fatrocu_3.0.0_x64-setup.exe


Proje Yapısı

Mimari

Fatrocu v3.0 — Sistem Mimarisi
Frontend — React + TypeScript
UploadPage.tsx
ReviewPage.tsx
SettingsPage.tsx
tauriService.ts
↕ Tauri IPC (invoke)
Rust Backend — src-tauri/src/
commands.rs
llama_engine.rs
storage.rs
pdf_converter.rs
models.rs
↕ Subprocess
AI Engine — llama.cpp
llama-cli.exe
DeepSeek-OCR.gguf
gemma-4-E4B.gguf
↕ JSON
Yerel Depolama — %APPDATA%\Fatrocu\
settings.json
invoices.json
models/
bin/

Sık Karşılaşılan Sorunlar

Çözülemeyen sorunlar için GitHub Issues bölümünü kullanın.

llama-cli bulunamadı hatası
Ayarlar → "Motoru Tek Tıkla Kur" butonuna basın. Ya da llama.cpp'yi PATH ortam değişkeninize ekleyin.
Model dosyası bulunamadı
GGUF dosyasını gguf/ klasörüne kopyalayın veya Ayarlar'daki sürükle-bırak alanını kullanın.
PDF sayfaları işlenmiyor
Python 3 kurulu olduğundan emin olun. Terminal'de python --version komutunu çalıştırın.
İşleme çok yavaş
Ayarlar'dan thread sayısını artırın. NVIDIA GPU varsa GPU Katmanı sayısını artırarak hızlandırabilirsiniz.
OCR sonuçları hatalı
Daha yüksek kalite GGUF quant kullanın (Q6_K önerilir). Fatura görüntüsünün net ve okunabilir olduğundan emin olun.
Yazılan ayarlar kaydolmuyor
Ayarlar ekranında "Değişiklikleri Kaydet" butonuna basın veya başka bir sekmeye geçin; değişiklikler otomatik kaydedilir.
Uygulama başlamıyor / hata veriyor
Microsoft Visual C++ Redistributable yüklü olduğundan emin olun. Yoksa buradan indirin.