🏢 Accura Finance

💼 Profesyonel Muhasebe Yazılımı

Modern, kullanıcı dostu ve tam kapsamlı muhasebe yazılımı
Küçük ve orta ölçekli işletmeler için tasarlanmış profesyonel finansal yönetim çözümü

🌟 Demo İzle | 📚 Dokümantasyon | 🚀 Hızlı Başlangıç | 💬 Destek

---

📸 Ekran Görüntüleri

🔐 Giriş Ekranı

Temiz ve minimal tasarım ile güvenli giriş

📊 Ana Dashboard

Finansal özetler, grafikler ve hızlı erişim butonları

---

✨ Özellikler

🎯 Ana Modüller 🏠 Dashboard - Finansal özet ve grafikler 👥 Cari Hesaplar - Müşteri/tedarikçi yönetimi 💰 Kasa & Banka - Nakit akışı yönetimi 📝 Fatura Yönetimi - Alış/satış faturaları 📦 Stok Yönetimi - Envanter takibi 📈 Raporlama - Mali tablolar ve analizler ⚙️ Muhasebe - Hesap planı ve kayıtlar

🛠️ Teknik Özellikler 🖥️ Modern GUI - CustomTkinter arayüz 🗄️ Güçlü Veritabanı - SQL Server entegrasyonu 📊 Grafik Desteği - Matplotlib charts 🔒 Güvenlik - Authentication sistemi 💾 Yedekleme - Otomatik backup 🌍 Türkçe - Tam Türkçe dil desteği ⚡ Performans - Hızlı ve kararlı

📋 İş Süreçleri 💼 KOBİ Odaklı - Küçük/orta işletmeler 📊 Raporlama - PDF/Excel çıktıları 🔄 Entegrasyon - E-fatura hazırlığı 👤 Kullanıcı Dostu - Kolay öğrenme 🎨 Modern Tasarım - Şık arayüz 📱 Responsive - Esnek pencere boyutu 🔧 Özelleştirilebilir - Modüler yapı

---

🚀 Hızlı Başlangıç

⚡ 3 Adımda Kurulum

� Kurulum

📋 Sistem Gereksinimleri

Gereksinim	Minimum	Önerilen
İşletim Sistemi	Windows 10	Windows 11
Python	3.8+	3.11+
RAM	4 GB	8 GB
Disk Alanı	1 GB	2 GB
Veritabanı	SQL Server Express	SQL Server 2019+

1. 📥 Projeyi İndirin

# Git ile klonlayın
git clone https://github.com/ThecoderPinar/accura-finance.git
cd accura-finance

# Veya ZIP olarak indirin
# https://github.com/ThecoderPinar/accura-finance/archive/main.zip

2. 🔧 Kurulum

🐍 Sanal Ortam Oluşturma (Önerilen)

# Sanal ortam oluşturun
python -m venv venv

# Sanal ortamı aktifleştirin
# Windows:
venv\Scripts\activate
# Linux/Mac:
source venv/bin/activate

# Bağımlılıkları yükleyin
pip install -r requirements.txt

# Veritabanını kurun
python setup_database.py

3. 🚀 Çalıştırma

/.run.bat # veya

python main.py 

🔑 Varsayılan Giriş Bilgileri

Kullanıcı Adı	Şifre
admin	admin123

⚠️ İlk girişten sonra şifrenizi değiştirmeyi unutmayın!

---

📁 Proje Yapısı

🗂️ Detaylı Klasör Yapısı

🏢 accura-finance/
├── 📂 src/                     # 🔧 Kaynak Kodlar
│   ├── 📂 gui/                 # 🖥️ Kullanıcı Arayüzü
│   │   ├── 🔐 login_window.py  # Giriş ekranı
│   │   ├── 📊 dashboard.py     # Ana dashboard
│   │   ├── 👥 customers.py     # Cari hesaplar
│   │   ├── 📝 accounting.py    # Muhasebe işlemleri
│   │   ├── 📦 inventory.py     # Stok yönetimi
│   │   ├── 📈 reports.py       # Raporlar
│   │   ├── ⚙️ settings.py      # Ayarlar
│   │   └── 🖼️ main_window.py   # Ana pencere
│   ├── 📂 database/            # 🗄️ Veritabanı
│   │   ├── 🔗 connection.py    # Bağlantı yönetimi
│   │   ├── 📋 models.py        # Veri modelleri
│   │   ├── 📊 initial_data.sql # Başlangıç verileri
│   │   └── 🔧 setup.py         # Kurulum scripti
│   ├── 📂 utils/               # 🛠️ Yardımcı Araçlar
│   │   ├── ⚙️ config.py        # Konfigürasyon
│   │   ├── 📝 logger.py        # Log yönetimi
│   │   ├── 🔒 security.py      # Güvenlik fonksiyonları
│   │   └── � pdf_generator.py # PDF oluşturucu
│   └── 📂 business/            # 💼 İş Mantığı
│       ├── 💰 accounting.py    # Muhasebe işlemleri
│       ├── 📝 invoice.py       # Fatura işlemleri
│       └── 📊 reporting.py     # Rapor işlemleri
├── 📂 data/                    # 📊 Veri Dosyaları
│   ├── 📂 exports/             # Dışa aktarılan dosyalar
│   ├── 📂 backups/             # Yedek dosyaları
│   ├── 📂 temp/                # Geçici dosyalar
│   └── ⚙️ user_config.json     # Kullanıcı ayarları
├── 📂 docs/                    # 📚 Dokümantasyon
│   ├── 📂 images/              # Ekran görüntüleri
│   ├── 📂 user_guide/          # Kullanıcı kılavuzu
│   └── 📂 api/                 # API dokümantasyonu
├── 📂 tests/                   # 🧪 Test Dosyaları
│   ├── 📂 unit/                # Birim testler
│   ├── 📂 integration/         # Entegrasyon testleri
│   └── 📂 fixtures/            # Test verileri
├── � scripts/                 # 📜 Betik Dosyaları
│   ├── 🔧 setup_database.py    # Veritabanı kurulumu
│   ├── 📦 build.py             # Derleme scripti
│   └── 🚀 deploy.py            # Yayınlama scripti
├── �📄 requirements.txt         # 📋 Python bağımlılıkları
├── 📄 requirements-dev.txt     # �️ Geliştirme bağımlılıkları
├── �🚀 main.py                  # 🏁 Ana uygulama dosyası
├── ⚙️ config.ini               # 🔧 Konfigürasyon dosyası
├── 🏃 run.bat                  # 🪟 Windows başlatıcı
├── 📄 .gitignore               # 🙈 Git ignore kuralları
├── 📄 LICENSE                  # ⚖️ MIT Lisansı
├── 📖 README.md                # 📚 Bu dosya
├── 📋 CHANGELOG.md             # 📝 Versiyon geçmişi
└── 🤝 CONTRIBUTING.md          # 👥 Katkı rehberi

---

🎮 Kullanım Kılavuzu

📊 Dashboard ✅ Finansal özetleri görüntüleyin ✅ Grafiklerde satış/alış trendlerini takip edin ✅ Hızlı erişim butonlarıyla işlem yapın ✅ Güncel bakiyeleri kontrol edin

👥 Cari Hesaplar ✅ Müşteri ve tedarikçi kartları oluşturun ✅ Borç/alacak durumlarını takip edin ✅ Cari hesap ekstrelerini görüntüleyin ✅ Risk limitlerini yönetin

📝 Fatura Yönetimi ✅ Alış ve satış faturaları oluşturun ✅ KDV hesaplamalarını otomatik yapın ✅ Fatura yazdırma ve PDF çıktısı alın ✅ E-fatura entegrasyonu

⚙️ Muhasebe ✅ Hesap planını yönetin ✅ Yevmiye kayıtları yapın ✅ Mizan ve mali tabloları oluşturun ✅ Defteri kebir takibi

🚀 Hızlı İşlemler

💡 İpuçları ve Kısayollar

Kısayol	Açıklama
Ctrl + N	Yeni kayıt oluştur
Ctrl + S	Kaydet
Ctrl + P	Yazdır / PDF
Ctrl + F	Arama
F5	Yenile
Ctrl + Q	Çıkış

---

🔧 Geliştirme

🤝 Katkıda Bulunun!

🏗️ Geliştirme Ortamı Kurulumu

# Proje deposunu klonlayın
git clone https://github.com/ThecoderPinar/accura-finance.git
cd accura-finance

# Development branch'e geçin
git checkout develop

# Geliştirme bağımlılıklarını yükleyin
pip install -r requirements-dev.txt

# Pre-commit hook'larını kurun
pre-commit install

📝 Kod Standartları

# Kod formatı kontrolü
black src/
flake8 src/
isort src/

# Type checking
mypy src/

# Testleri çalıştırın
pytest tests/ -v --coverage

🔄 Pull Request Süreci

1. Fork edin ve feature branch oluşturun

   git checkout -b feature/amazing-feature

2. Test yazın ve mevcut testleri çalıştırın

   pytest tests/

3. Commit edin ve push yapın

   git commit -m "Add amazing feature"
   git push origin feature/amazing-feature

4. Pull Request açın

---

🗺️ Yol Haritası

📅 Geliştirme Planı

🚀 Version 1.0.1 (Geliştirmede)

Özellik	Durum	Tamamlanma
👥 Tam işlevsel Cari Hesaplar modülü	🟡 Devam ediyor	60%
📝 Fatura yönetimi sistemi	🟡 Devam ediyor	40%
💰 Kasa & Banka işlemleri	🔴 Beklemede	20%
📊 Gelişmiş raporlama	🔴 Beklemede	10%
🔒 Kullanıcı yetkilendirme	🟡 Devam ediyor	70%

Tahmini Yayın Tarihi: Ağustos 2025

⭐ Version 1.1.0 (Planlanan)

• 📧 E-fatura entegrasyonu
• 💼 Maaş bordrosu modülü
• 📈 İleri düzey analitik ve grafik
• 📱 Mobile-responsive web arayüzü
• 🌐 Multi-tenant (çoklu firma) desteği
• 🔄 API entegrasyonları
• 🤖 AI destekli özellikler

Tahmini Yayın Tarihi: Ekim 2025

🌟 Version 2.0.0 (Gelecek)

• ☁️ Cloud desteği
• 🔐 Blockchain entegrasyonu
• 🤝 CRM entegrasyonu
• 📊 Business Intelligence dashboard
• 🌍 Çoklu dil desteği
• 📱 Mobile uygulama

Tahmini Yayın Tarihi: 2026

---

📊 İstatistikler ve Topluluk

📈 Proje İstatistikleri

🌟 Topluluk

📊 Kod Kalitesi

---

🏆 Teşekkürler

💝 Destekçilerimiz

🙏 Kullanılan Teknolojiler

Özel Teşekkürler:

• 🎨 CustomTkinter - Modern GUI framework için
• 🗄️ SQLAlchemy - Güçlü ORM desteği için
• 📊 Matplotlib - Grafik ve görselleştirme için
• 🚀 Python Community - Sürekli gelişim için

---

📞 İletişim ve Destek

👨‍💻 Geliştirici İletişim

Pınar Topuz Lead Developer

💬 Topluluk ve Destek

🆘 Yardım ve Dokümantasyon

---

📄 Lisans

Bu proje MIT Lisansı altında lisanslanmıştır.
Detaylar için LICENSE dosyasına bakınız.

Özgürce kullanabilir, değiştirebilir ve dağıtabilirsiniz!

---

🌟 Bu Projeyi Beğendiyseniz

⭐ Yıldız vermeyi unutmayın!

🔔 Güncellemelerden haberdar olmak için "Watch" edin

🤝 Fork edip katkıda bulunun

---

💖 Made with ❤️ in Turkey

© 2025 Pınar Topuz. Tüm hakları saklıdır.