unyemek_ex
Modern, hızlı ve hafif bir Windows masaüstü uygulaması olan Ünyemek Ex, yemek ve konaklama hizmeti sağlayan işletmelerin aylık yemek çizelgelerini girmelerini, birim fiyatlarını takip etmelerini, KDV ve devir bakiye hesaplamalarını yapmalarını ve tahsilat durumlarını yönetmelerini kolaylaştırmak için tasarlanmış bir otomasyon sistemidir. Bu uygulama FastAPI (Python) backend ve React (Vite) frontend teknolojilerini harmanlayarak tek bir bağımsız Windows çalıştırılabilir dosyası (.exe) halinde çalışabilmektedir.
System Narrative
Aylık Çizelge Giriş Matrisi: Kullanıcı dostu, Excel benzeri (yön tuşlarıyla hücreler arası gezilebilen) 1-31 gün arası yemek adeti giriş alanı. Gelişmiş Genel Toplam Satırı (UI & Excel): Gün bazlı yemek sayıları, önceki devir bakiyeleri, KDV dahil tutarlar, tahsilatlar ve kalan bakiye toplamları dinamik olarak alt toplam satırında gösterilir. Arama filtresi uygulandığında dahi genel toplam satırı ekrandan elenen ("yazdırılmayan/görünmeyen") firmaları da kapsayacak şekilde tüm verilerin toplamını tutarlı şekilde gösterir. Dışa aktarılan Excel dosyalarında da gün sütunlarının altında otomatik =SUM(...) formülleri yer alır. Akıllı Bakiye Devri (Rollover): Girilen tahsilat miktarına göre kalan borç/alacak bakiyesi otomatik olarak sonraki aya "Önceki Devir" olarak devredilir. Esnek Fiyat ve Zam Yönetimi: Şirket bazlı birim fiyat belirlenebilir ve istenen ay/yıl itibarıyla geçerli olacak şekilde fiyat güncellemeleri/zam geçmişi kaydedilebilir. KDV Muafiyet Desteği: KDV muafiyeti olan firmalar için %0, muaf olmayan firmalar için yasal %10 oranı otomatik olarak fatura kalemlerine yansıtılır. Excel Aktarım ve İçe Aktarım: Tek tuşla tüm çizelgeyi profesyonel formatta Excel tablosu olarak çıktı alma. Seçilen şirketlerin belgelerini tekil fatura dokümanı olarak dışa aktarma. Var olan Excel tablolarını sisteme geri yükleme ve isim uyuşmazlıklarında akıllı eşleştirme arayüzü. Otomatik Şirket Eşitleme: sirket_listesi.txt dosyasındaki yeni şirketleri otomatik algılayıp veritabanına ekleyen senkronizasyon altyapısı. Gömülü Veritabanı Güvenliği: Uygulama veritabanını (unyemek.db) kullanıcının işletim sistemindeki ana dizininde (~/.unyemek/) saklar. Bu sayede program dosyası silinse veya güncellense dahi veriler asla kaybolmaz.