Finans Dashboard (Demo) — Anonim

Dash/Plotly ile hazırlanmış, son 5 yıl için gelir–gider, bilanço, nakit akış ve rasyoları görselleştiren tamamen anonim/demo finans paneli.
Gerçek sunucu/DB yoktur; veriler çalışma anında deterministik olarak RAM’de üretilir.

• 🔐 Basit login (ENV ile kullanıcı tanımlama)
• 📊 Rapor Görünümü · Tablolar · Grafikler (5Y karşılaştırma)
• 📥 Excel indirme (ham tablolar + tüm rapor sayfaları)
• 📆 Yıl seçimi + tarih aralığı filtreleri
• 💡 Kurulumu kolay, yayınlamaya hazır

---

Özellikler

• Anonim/Demo veri (sunucu/DB yok)
• Yıl seçimi ve tarih aralığı filtrasyonu
• Gelir tablosu ve bilanço özetleri + KPI kartları
• Temel rasyolar (Cari, Asit-Test, Borç/Varlık, Varlık Devir, Marjlar)
• Son 5 yıl karşılaştırma (çizgi/sütun/pasta grafikler)
• Excel’e dışa aktarım (tek sayfa veya “Rapor Excel (Tümü)” çoklu sheet)

---

Ekran Görünümü

(Opsiyonel) Bir ekran görüntüsü eklemek için assets/screenshot-1.png oluşturun ve aşağıdaki satırı README’ye bırakın:

![Dashboard](assets/screenshot-1.png)

---

Kurulum

Gereksinimler: Python 3.9+

Windows (PowerShell):

cd "C:\YOUR\PATH\finans-dashboard-demo"
python -m venv .venv
. .\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
pip install -r requirements.txt

macOS / Linux:

cd ~/finans-dashboard-demo
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
pip install -r requirements.txt

requirements.txt (proje içinde mevcut):

dash==2.*
dash-bootstrap-components==1.*
pandas>=1.5
numpy>=1.23
plotly>=5.15
XlsxWriter>=3.0

---

Çalıştırma

Windows (PowerShell):

. .\.venv\Scripts\Activate.ps1
python app.py

macOS / Linux:

source .venv/bin/activate
python app.py

Tarayıcıdan aç: http://127.0.0.1:8040

---

Giriş (Login)

Varsayılan demo kullanıcıları:

• admin / admin123
• demo / demo123

Kendi kullanıcılarını ortam değişkeni ile tanımlayabilirsin (aşağıya bak).

---

Ortam Değişkenleri

Windows (PowerShell):

$env:USERS = "admin:MyPass;analist:Secret123"
python app.py

macOS / Linux:

USERS="admin:MyPass;analist:Secret123" python app.py

Biçim: USERS="kullanici1:sifre1;kullanici2:sifre2;..."
Bu değişken verilmezse, admin/admin123 ve demo/demo123 kullanılır.

---

Proje Yapısı

.
├─ app.py          # Dash uygulaması (demo verili, DB yok)
├─ auth.py         # Basit kimlik doğrulama (ENV üzerinden)
├─ requirements.txt
└─ README.md

---

Komutlar & İndirilebilirler

• Rapor Excel (Tümü): Rapor görünümündeki tüm bölümleri tek bir .xlsx dosyasında ayrı sayfalara yazar.
• Gelir Excel / Bilanço Excel: Ham tabloları tek sayfalık Excel olarak indirir.

---

Notlar

• Bu repo örnek/demo amaçlıdır; gerçek veri veya sunucu bilgisi içermez.
• Demo veri deterministik üretildiğinden aynı yıl/tarih seçiminde aynı sonuçlar gelir.
• Üretime geçerken:
  • Kimlik doğrulamayı gerçek sisteme entegre edin (OAuth/AD/DB).
  • Veri katmanını (DB/servis) ekleyip ENV ile yapılandırın.
  • Gerekiyorsa gunicorn + reverse proxy ile servis edin.

---

Lisans

Bu proje örnek amaçlıdır. Kurum içi kullanım için serbestçe uyarlayabilirsiniz. İsterseniz MIT lisansı ekleyin.