🎉 Fatrocu v2.2.0 - Akıllı Kontrol ve Onay Sistemi 🎉

Fatrocu v2.2.0 ile tanışın! Bu sürüm, fatura işleme sürecinize tam kontrol ve kusursuz bir iş akışı getirmek için baştan tasarlandı. Yapay zeka ile kullanıcı uzmanlığını birleştiren bu güncelleme, Fatrocu'yu her zamankinden daha güçlü, daha akıllı ve daha vazgeçilmez kılıyor.

🚀 Canlı Deneyimleyin!

Uygulamanın en son ve en gelişmiş halini hemen denemek için aşağıdaki bağlantıyı ziyaret edebilirsiniz:

https://nec0ti.github.io/Fatrocu/

✨ Ana Yenilikler (v2.2.0)

1. Devrim Niteliğinde: Etkileşimli Kontrol ve Düzeltme Arayüzü

Artık yapay zekanın çıkardığı verileri pasif bir şekilde izlemek zorunda değilsiniz. Yeni Kontrol Sayfası ile gücü elinize alın:

• Yan Yana Görüntüleme: Faturanızın orijinal belgesi sol tarafta, yapay zeka tarafından doldurulmuş düzenlenebilir form sağ tarafta. Verileri anında karşılaştırın ve doğrulayın.
• Tam Veri Kontrolü: Fatura numarasından KDV detaylarına kadar her alanı kolayca düzenleyin. Hatalı bir veri mi var? Sadece tıklayın ve düzeltin.
• Dinamik KDV Yönetimi: Faturanızda birden fazla KDV oranı mı var? Sorun değil! Tek tıkla yeni KDV satırları ekleyin veya mevcutları kaldırın.

2. Akıllı İş Akışı: "Yükle" ve "Kontrol Et" Sayfaları

Uygulama artık iki ana bölüme ayrıldı. Bu sayede görevleriniz her zamankinden daha net:

• Fatura Yükle Sayfası: Tüm işlem geçmişinizi (onaylanmış, hatalı, işlemdeki) tek bir yerde görün ve yeni faturalarınızı buradan yükleyin.
• Kontrol Et Sayfası: Sadece sizin müdahalenizi bekleyen, "Kontrol Bekliyor" durumundaki faturaların listelendiği görev odaklı bir sayfa. Yapılacaklar listeniz artık çok daha düzenli!

3. Gelişmiş Onay Süreci ve Durum Yönetimi

Her faturanın artık bir onay durumu var (Kontrol Bekliyor -> Onaylandı).

• Onaylama: Kontrol ettiğiniz ve doğruluğundan emin olduğunuz faturaları "Kaydet ve Onayla" butonu ile işaretleyin.
• Güvenli Dışa Aktarım: Yalnızca sizin tarafınızdan "Onaylandı" olarak işaretlenen faturalar toplu Excel aktarımına dahil edilir. Bu, veri tutarlılığını garanti altına alır.
• Kusursuz Oturum Kalıcılığı: Tarayıcınızı kapatsanız bile tüm faturalarınız, verileriniz ve onay durumlarınız localStorage sayesinde güvende kalır. Geri döndüğünüzde kaldığınız yerden devam edersiniz.

4. Daha Güçlü Altyapı

• Daha Akıllı Yapay Zeka: Veri çıkarma motoru artık Google'ın en güncel gemini-2.5-flash modelini kullanıyor. Fatura türünü (Alış/Satış) otomatik anlama ve daha isabetli veri çıkarma yetenekleriyle donatıldı.
• Güçlendirilmiş Excel Aktarımı: Veriler artık daha modern ve uyumlu olan .xlsx formatında dışa aktarılıyor. Çoklu KDV satırları gibi karmaşık veriler bile Excel'de mükemmel bir şekilde organize ediliyor.

🎯 Güncellenmiş Ana Özellikler

• Çoklu Format Desteği: PDF, PNG, JPG ve XML formatındaki faturaları sorunsuz işleyin.
• Yapay Zeka Destekli Veri Çıkarımı: Gemini 2.5 Flash ile faturalarınızdan kritik verileri yüksek doğrulukla otomatik olarak çıkarın.
• Etkileşimli Kontrol ve Düzeltme: Yapay zeka verilerini orijinal belgeyle yan yana kontrol edin, düzenleyin ve onaylayın.
• Akıllı Excel'e Aktarım: Sadece onayladığınız faturaları tek bir tıklama ile .xlsx formatında bilgisayarınıza indirin.
• Kapsamlı İşlem Geçmişi: Yüklediğiniz tüm faturaları ve işlem sonuçlarını (onay durumu dahil) tek bir ekranda görüntüleyin.
• Tarayıcıda Veri Kalıcılığı: Sayfayı yenileseniz bile hiçbir veriniz kaybolmaz.

🔮 Gelecek Güncellemeler (v2.3.0 ve sonrası)

• Arama ve Filtreleme: İşlem geçmişindeki faturaları fatura numarası, tarih veya tutara göre arama.
• İstatistik Paneli (Dashboard): Aylık toplamlar ve satıcılara göre harcama dağılımı gibi temel istatistikler.
• Gelişmiş Dışa Aktarma Seçenekleri: CSV formatı ve özelleştirilebilir sütunlar.

Fatrocu'yu kullandığınız için teşekkürler! Bu büyük adımı sizinle paylaşmaktan heyecan duyuyoruz.

What's Changed

• merge from master by @Nec0ti in #29
• Merge pull request #29 from Nec0ti/master by @Nec0ti in #30

Full Changelog: 2.1.0...2.2.0

🎉 Fatrocu v2.1.0 - Sürüm Notları 🎉

Bu sürüm, Fatrocu'nun temel özelliklerini daha da geliştirerek kullanıcı deneyimini ve işlevselliği bir üst seviyeye taşıyor. Akıllı fatura işleme asistanınız artık daha güçlü, daha şık ve daha kullanışlı!

🚀 Canlı Deneyimleyin!

Uygulamanın son halini hemen denemek için aşağıdaki bağlantıyı ziyaret edebilirsiniz:

https://nec0ti.github.io/Fatrocu/

✨ Neler Yeni? (v2.1.0)

• Yenilenmiş Kullanıcı Arayüzü (UI/UX): Modern, akıcı ve şık bir tasarımla karşınızdayız. Gradyan arka planlar, yumuşak animasyonlar ve Tailwind CSS ile oluşturulmuş estetik bileşenler sayesinde fatura işlemek artık çok daha keyifli.
• Gelişmiş Dosya Yükleme Alanı: Artık dosyaları sürükleyip bırakmak daha interaktif. Yükleme alanı, dosya üzerine gelindiğinde görsel olarak tepki verir ve seçilen dosya hakkında anında önizleme bilgisi sunar.
• Detaylı İşlem Durumu Göstergesi: Yüklenen her fatura için işlem durumunu (Yükleniyor, İşleniyor, Başarılı, Hata) anlık olarak takip edebilirsiniz. Her durum, kendine özgü bir renklendirme ve ikon ile belirtilir.
• Sağlamlaştırılmış Dosya Doğrulama: Yalnızca izin verilen dosya türlerinin (XML, PDF, PNG, JPG/JPEG) ve boyut limitinin (10MB) yüklenmesini sağlayan istemci taraflı doğrulama eklendi. Bu, hatalı yüklemelerin önüne geçer.
• Dinamik Hata ve Başarı Bildirimleri: Uygulama genelinde anlık, bilgilendirici ve kolayca kapatılabilen uyarı mesajları ile kullanıcı deneyimi iyileştirildi.

🎯 Ana Özellikler

• Çoklu Format Desteği: XML, PDF ve resim formatlarındaki (PNG, JPG) faturalarınızı kolayca işleyin.
• Akıllı Veri Çıkarımı: Faturalarınızdan Fatura Numarası, Tarih, Satıcı/Alıcı Bilgileri, VKN/TCKN, KDV ve Toplam Tutar gibi önemli alanları otomatik olarak çıkarın.
• Anında Excel'e Aktarım: İşlenen fatura verilerini tek bir tıklama ile .csv formatında bilgisayarınıza indirin.
• İşlem Geçmişi: Yüklediğiniz tüm faturaları ve işlem sonuçlarını tek bir ekranda görüntüleyin.
• Manuel Kontrol: Veri analizi sırasında yapay zekanın yanlış veri ayıkladığı yerleri inceleyip mauel olarak değiştirin.

💻 Yerel (Lokal) Kurulum ve Çalıştırma

Projeyi kendi bilgisayarınızda çalıştırmak için aşağıdaki adımları izleyebilirsiniz:

1. Proje dosyalarını indirin veya klonlayın:

   git clone https://github.com/nec0ti/Fatrocu.git

2. Proje klasörüne gidin:

   cd Fatrocu

3. Bir yerel sunucu başlatın:

    # Gerekli modülleri yükleyin
   npm install
   
   # Uygulamayı başlatın
   npm run dev
   

4. Tarayıcıda açın:
   Sunucuyu başlattıktan sonra tarayıcınızdan sunucunun size verdiği adresi ziyaret edin.

🔮 Gelecek Güncellemeler (v2.2.0 ve sonrası)

Gelecek sürümler için heyecan verici planlarımız var:

• Kullanıcı Hesapları ve Veri Depolama: Kullanıcıların kendi hesaplarını oluşturup geçmiş faturalarını güvenli bir şekilde saklayabilmesi.
• Analitik Gösterge Paneli (Dashboard): Harcamalar, vergiler ve tedarikçiler hakkında görsel raporlar sunan bir dashboard.

Fatrocu'yu kullandığınız için teşekkürler! Geri bildirimlerinizi ve önerilerinizi duymaktan mutluluk duyarız.

What's Changed

• o by @Nec0ti in #6
• Dev by @Nec0ti in #7
• i by @Nec0ti in #8
• Merge pull request #8 from Nec0ti/master by @Nec0ti in #9
• Merge pull request #9 from Nec0ti/dev by @Nec0ti in #10
• Create b.js by @Nec0ti in #11
• ggggg by @Nec0ti in #12
• l by @Nec0ti in #14
• Dev by @Nec0ti in #15
• Potential fix for code scanning alert no. 5: Information exposure through an exception by @Nec0ti in #16
• Potential fix for code scanning alert no. 4: Information exposure through an exception by @Nec0ti in #17
• fix by @Nec0ti in #18
• Merge pull request #18 from Nec0ti/master by @Nec0ti in #19
• asdsdfasdf by @Nec0ti in #20
• Merge pull request #20 from Nec0ti/master by @Nec0ti in #21
• Merge pull request #21 from Nec0ti/dev by @Nec0ti in #22
• Dev by @Nec0ti in #23
• Dev by @Nec0ti in #24
• Update file_handler.py by @Nec0ti in #25
• tyuie by @Nec0ti in #26
• Merge pull request #26 from Nec0ti/master by @Nec0ti in #27

Full Changelog: 1.3.0...2.1.0

Fatrocu 2.0 - Ön Sürüm

Bu, Fatrocu'nun tamamen yeniden tasarlanmış ve geliştirilmiş 2.0 versiyonunun ilk ön sürümüdür! Bu sürüm, önceki versiyonlardaki doğruluk sorunlarını gidermeyi, modern teknolojileri kullanmayı ve mali müşavirler için fatura işleme sürecini önemli ölçüde iyileştirmeyi hedeflemektedir.

⚠️ Lütfen Dikkat: Bu bir ön sürümdür (pre-release). Temel işlevsellik çalışıyor olsa da, hatalar içerebilir ve henüz tüm özellikler tamamlanmamış veya detaylı test edilmemiş olabilir. Özellikle test ve geri bildirim amaçlıdır.

✨ Önemli Yenilikler ve Değişiklikler (v2.0.0-beta.1)

• 🚀 Yepyeni Mimari: Güvenlik, performans ve geliştirilebilirlik için Python (Flask) Backend + Web (HTML/JS) Frontend hibrit modeline geçildi.
• 🥇 e-Fatura (XML) Desteği: Türkiye'deki standart UBL-TR XML formatındaki e-Faturalar artık doğrudan ayrıştırılarak %100'e yakın doğrulukla işleniyor! Bu, en büyük geliştirmelerden biri.
• 🧠 Gelişmiş AI Analizi (PDF/Resim): Düşük doğruluklu eski sistem yerine, PDF ve resim formatları (PNG, JPG vb.) için **Google Gemini 2.5 Pro experimental modeli entegre edildi. Daha akıllı OCR ve yapılandırılmış JSON çıktısı hedefleyen prompt'lar kullanılıyor.
• ✔️ Arka Plan Veri Doğrulama: AI veya XML'den çıkarılan temel veriler (Tarih formatı, VKN/TCKN uzunluğu, Matrah+KDV ≈ Toplam tutarlılığı) otomatik olarak kontrol edilir.
• 🖥️ Modern Web Arayüzü: Dosyaları kolayca yüklemek, işlem sonuçlarını görmek ve Excel'e aktarmak için sıfırdan tasarlanmış, kullanıcı dostu bir web arayüzü. (CSS iyileştirmeleri dahil!)
• 🔐 Güvenli API Anahtarı Yönetimi: Google Gemini API anahtarı artık güvenli bir şekilde backend'de saklanmaktadır.
• 📊 Temel Excel Aktarımı: Başarıyla işlenen ve doğrulanan fatura verileri (ana alanlar) yapılandırılmış .xlsx formatında dışa aktarılabilir.

🎯 Bu Sürümdeki Odak Noktaları

• e-Fatura (XML) işleme doğruluğu.
• PDF/Resim dosyalarının Gemini ile temel veri çıkarma yeteneği.
• Dosya yükleme ve Excel'e aktarma akışının çalışması.
• Yeni web arayüzünün temel kullanılabilirliği.

❗ Bilinen Sorunlar ve Eksikler (Ön Sürüm)

• Etkileşimli Doğrulama Eksik: Sonuç ekranı şu anda verileri sadece gösterir. Kullanıcının AI tarafından çıkarılan verileri doğrudan arayüz üzerinden düzenleyip onaylaması işlevselliği henüz eklenmemiştir. (En önemli sonraki adım!)
• Kapsamlı Test Eksikliği: Farklı düzenlere, dillere ve kalitelere sahip çok çeşitli faturalarla yeterince test edilmemiştir. Bazı faturalarda (özellikle düşük kaliteli resimler veya karmaşık PDF'ler) doğruluk hala düşük olabilir.
• ÖKC Fişleri: Yazar kasa fişleri için özel bir iyileştirme yapılmamıştır, doğruluk beklenenden düşük olabilir.
• Detaylı Hata Yönetimi: Kullanıcı arayüzünde gösterilen hata mesajları daha açıklayıcı ve kullanıcı dostu hale getirilebilir.
• Gelişmiş Veri Çıkarma: Henüz sadece temel fatura alanları (No, Tarih, VKN, Tutar vb.) çıkarılmaktadır. Ürün/hizmet kalemleri gibi detaylar eklenmemiştir.

🚀 Nasıl Kurulur ve Test Edilir?

1. Bu sürümün kodunu indirin/klonlayın.
2. Projenin ana dizinindeki README.md dosyasındaki kurulum adımlarını takip edin (Python sanal ortamı, requirements.txt kurulumu, .env dosyası ile API anahtarı ayarı).
3. backend klasöründeyken flask run komutu ile backend sunucusunu başlatın.
4. Web tarayıcınızdan http://127.0.0.1:5000 adresine gidin.
5. Farklı formatlarda (özellikle XML, PDF, JPG, PNG) faturalarınızı yükleyin. (ornek_faturalar.zip'i de kullanabilirsiniz)
6. Sonuç ekranındaki verilerin doğruluğunu kontrol edin (Faturanın kendisiyle karşılaştırın).
7. Başarılı işlemler için "Excel İndir" bağlantısını test edin.

💬 Geri Bildirimleriniz Çok Değerli!

Lütfen bu ön sürümü test ederken karşılaştığınız hataları, beklenmedik davranışları veya iyileştirme önerilerinizi GitHub Issues üzerinden bildirin. Özellikle:

• Hangi fatura tipiyle (XML, PDF, JPG) sorun yaşadınız?
• Sorun yaşanan faturanın (hassas bilgileri gizleyerek) bir örneğini paylaşabilir misiniz?
• Beklenen sonuç neydi, alınan sonuç ne oldu?
• Tarayıcı konsolu veya backend terminalindeki hata mesajları nelerdi?

Yardımlarınız Fatrocu 2.0'ı daha stabil ve güvenilir hale getirmemizde kritik rol oynayacaktır!

What's Changed

• o by @Nec0ti in #6
• Dev by @Nec0ti in #7
• i by @Nec0ti in #8
• Merge pull request #8 from Nec0ti/master by @Nec0ti in #9
• Merge pull request #9 from Nec0ti/dev by @Nec0ti in #10
• Create b.js by @Nec0ti in #11
• ggggg by @Nec0ti in #12
• l by @Nec0ti in #14
• Dev by @Nec0ti in #15

Full Changelog: 1.3.0...2.0.0-beta.1

📦 Fatrocu v1.3.0 - New Release

Release Date: January 18, 2025

🚀 New Features

• Multi-Language Support: Integrated i18next to provide multi-language options for a better user experience.
• Performance Enhancements: Improved loading times and optimized build process for a smoother experience.

🛠️ Fixes

• Module Not Found Error: Resolved the issue where i18next and i18next-fs-backend modules were not included in the build, eliminating the "module not found" error.
• Build Issues: Fixed problems related to asar packaging, ensuring the application builds successfully and runs without issues.

📁 Technical Details

• Added asarUnpack configuration to exclude required modules from being packed, ensuring functionality.
• Reduced package size by excluding unnecessary files from the build.
• Setup.exe now available

What's Changed

• readme by @Nec0ti in #2
• Merge pull request #2 from Nec0ti/master by @Nec0ti in #3
• Potential fix for code scanning alert no. 1: DOM text reinterpreted as HTML by @Nec0ti in #4
• language change support by @Nec0ti in #5

Full Changelog: 1.2.1...1.3.0

What's Changed

• Developed by @Nec0ti in #1

• The prompt's structure has been improved

• A new income/expense option has been added

• We can now obtain more accurate results, and there's no need to wait too long. Each invoice is analyzed in approximately 4.2 seconds.

New Contributors

• @Nec0ti made their first contribution in #1

Full Changelog: 1.2.0...1.2.1

Full Changelog: 1.1.3...1.2.0

Added a new feature called Tax Identification Number Inducer

With this feature, you can now:

• Automatically identify and extract VKN/TCKN numbers from invoice files.
• Allow users to input either the seller’s (for sales invoices) or the buyer’s (for purchase invoices) name before uploading the invoice.
• Prompt users not to enter the VKN/TCKN number manually, but instead ensure it is correctly extracted from the invoice.
• Ensure the program will only recognize and extract valid VKN/TCKN numbers from the invoice content.
• Provide an improved interface for the user to specify the correct party's name and automatically match it to the associated VKN/TCKN.
• This update improves the overall accuracy of the invoice processing by enforcing strict data validation rules for VKN/TCKN entries, making the analysis process more reliable and efficient.

prompt patched

Full Changelog: release...1.1.3

1.1.2

Full Changelog: https://github.com/Nec0ti/Fatrocu/commits/release