dla-docs

Raporlar

1. Amaç

Raporlar modülü, ayrıntılı finansal raporlar sağlayarak size yardımcı olur:

• Mevcut ayın finansal genel bakışını görüntüleme
• Gelir ve giderleri analiz etme
• Tasarruf ilerlemesini takip etme
• Ay sonu harcama tahmini
• Türe göre raporları görüntüleme (Gelir, Giderler, Tasarruflar, Krediler)

2. Ne Zaman Kullanılır

Şu durumlarda bu modülü kullanın:

• Finansal genel bakışı görüntülemek istediğinizde
• Harcama trendlerini analiz etmek istediğinizde
• Tasarruf hedefi ilerlemesini kontrol etmek istediğinizde
• Bütçe aşımı riskini tahmin etmek istediğinizde
• Türe göre ayrıntılı raporları görüntülemek istediğinizde

3. İlgili Ekranlar

• Genel bakış raporu
• Gelir raporu
• Gider raporu
• Tasarruf raporu
• Kredi raporu

4. Ana Kullanım

4.1 Genel Bakış Raporunu Görüntüleme

1. Alt navigasyondaki Raporlar sekmesine gidin
2. Finansal Sağlık bölümünü görüntüleyin:
   • Tasarruf hedefi ve gerçek tasarruflar (ilerleme çubuğu ve başarı seviyesi ile)
   • Ayrıntılı formülle Net Nakit Akışı
   • Kalan bütçe (bütçe oluşturulduysa)
   • Önceki aya kıyasla harcama hızı (veri varsa)
   • Bu ayın kredi yükümlülükleri (varsa)
   • Yüzdeye göre en yüksek 5 harcama kategorisi
3. Gelecek Trend Tahmini bölümünü görüntüleyin (bütçe > 0 ise):
   • Ayrıntılı formülle ay sonunda beklenen kalan
   • Tasarruf hedefi başarı olasılığı
   • Yaklaşan kredi ödemesi (varsa)
4. Kartlara dokunarak ilgili ayrıntılı raporlara kaydırın

4.2 Gelir Raporunu Görüntüleme

1. Raporlar ekranından, “Ayrıntılı Raporlar” bölümündeki 💵 Gelir menü öğesine dokunun
2. Bu ayın toplam gerçek gelirini görüntüleyin
3. Tekrarlayan Gelir bölümünü görüntüleyin: Toplam, alınan, henüz alınmayan, her öğe için ayrıntılar
4. Ekstra Gelir bölümünü görüntüleyin (varsa): Toplam, her öğe için ayrıntılar, % artış/azalış
5. 3 Aylık Gelir Trendi‘ni görüntüleyin (yeterli veri varsa)
6. Aylık Gelir Geçmişi‘ni görüntüleyin
7. Gelir Analizi (İçgörüler)‘i görüntüleyin: Yüzde, istikrar seviyesi, trendler

4.3 Gider Raporunu Görüntüleme

1. Raporlar ekranından, “Ayrıntılı Raporlar” bölümündeki 🔥 Giderler menü öğesine dokunun
2. Önceki aya kıyasla % artış/azalış ile bu ayın toplam gerçek giderlerini görüntüleyin
3. Tekrarlayan Giderler bölümünü görüntüleyin: Toplam, ödenen, henüz ödenmeyen, her öğe için ayrıntılar
4. Kategoriye Göre Günlük Giderler bölümünü görüntüleyin: Tutarlar ve yüzdelerle en üst kategoriler
5. Harcama Artışı bölümünü görüntüleyin (önceki ay verisi varsa)
6. 3 Aylık Gider Trendi‘ni görüntüleyin (yeterli veri varsa)
7. Aylık Gider Geçmişi‘ni görüntüleyin

4.4 Bütçe Raporunu Görüntüleme

1. Raporlar ekranından, “Ayrıntılı Raporlar” bölümündeki 📉 Bütçe menü öğesine dokunun (yalnızca bütçe oluşturulduğunda gösterilir)
2. Bu Ayın Bütçe Genel Bakışı‘nı görüntüleyin: Aylık bütçe, harcanan (dökümle), kalan, ilerleme çubuğu
3. Hesaplama yöntemiyle Bütçe Detay İletişim Kutusu‘nu görüntülemek için “Aylık Bütçe”ye dokunun
4. Plana Göre Varyans bölümünü görüntüleyin: Varyanslı gelir ve gider öğeleri, toplam varyans
5. Kategoriye Göre Giderler bölümünü görüntüleyin: Toplam, tutar, yüzde, ilerleme çubuğu ile her kategori
6. Kategoriye dokunarak o kategorideki giderlerin listesini görüntüleyin

4.5 Tasarruf Raporunu Görüntüleme

1. Raporlar ekranından, “Ayrıntılı Raporlar” bölümündeki 💾 Tasarruflar menü öğesine dokunun (yalnızca tasarruf hesapları varsa gösterilir)
2. Net Nakit Akışı formülüyle Bu Ayın Gerçek Tasarrufları‘nı görüntüleyin
3. Tasarruf Analizi bölümünü görüntüleyin: Gelirin %’si, önceki aya kıyasla, ay sonu tahmini
4. Tasarruf Hesabı Listesi bölümünü görüntüleyin: En yakın vade tarihine göre sıralanmış tüm aktif hesaplar
5. 6 Aylık Tasarruf Büyüme Grafiği‘ni görüntüleyin (1 aydan fazla veri varsa)

4.6 Kredi Raporunu Görüntüleme

1. Raporlar ekranından, “Ayrıntılı Raporlar” bölümündeki 💸 Krediler menü öğesine dokunun (yalnızca krediler varsa gösterilir)
2. Kredi Genel Bakışı‘nı görüntüleyin: Mevcut borç bakiyesi, bu ayın kredi maliyeti (anapara + faiz dökümü ile)
3. En Yakın Ödeme bölümünü görüntüleyin: Vade tarihi, durum, sonraki ödemeye kalan günler
4. Aylık Ödeme Takvimi bölümünü görüntüleyin: Tutarlar ve durumla son 3 ay
5. Kredi Analizi (İçgörüler) bölümünü görüntüleyin: Son 3 ayda ödenen, borç bakiyesi trendi, faiz oranı, gecikme riski
6. 6 Aylık Borç Azaltma Grafiği‘ni görüntüleyin (1 aydan fazla veri varsa)

5. Örnekler & Arayüz İllüstrasyonları

5.1 REPORT-01: Finansal Sağlık Genel Bakışını ve Trend Tahminini Görüntüleme

Amaç: Tasarruf ilerlemesi, net nakit akışı, kalan bütçe ve ay sonu tahmini dahil mevcut ayın finansal genel bakışını görüntüleyin.

Adımlar:

1. Alt navigasyondaki Raporlar sekmesine gidin
2. Finansal Sağlık bölümünü görüntüleyin:
   • Tasarruf hedefi: 18.000 TRY (gelirin %20’si)
   • Gerçek tasarruflar: 12.600 TRY
   • İlerleme çubuğu: %70 - BAŞARI SEVİYESİ: ORTA
   • Net Nakit Akışı: +8.400 TRY [POZİTİF] ayrıntılı formülle
   • Kalan bütçe: 18.600 TRY [İSTİKRARLI] (%62 bütçe ≈ %60 zaman)
   • Harcama hızı: Önceki aydan %12 daha yüksek
   • Kredi yükümlülükleri: 12.600 TRY [ÖDENDİ]
   • En üst 5 kategori: Yemek (%32), Alışveriş (%25), Eğlence (%18), Ulaşım (%15), Diğer (%10)
3. Gelecek Trend Tahmini bölümünü görüntüleyin:
   • Ay sonunda beklenen kalan: +6.900 TRY [FAZLA] ayrıntılı formülle
   • Hedef başarı olasılığı: %82 [YAKIN BAŞARI]
   • Yaklaşan kredi ödemesi: 25. Gün: 12.600 TRY [YETERLİ FON]

Wireframe:

┌──────────────────────┐  ┌──────────────────────┐
│ 🎯 Tasarruf Hedefi    │  │ 💾 Gerçek Tasarruflar│
│ 18.000 TRY            │  │ 12.600 TRY            │
│ Gelirin %20'si        │  │                      │
└──────────────────────┘  └──────────────────────┘

[██████████████----------------------] %70
BAŞARI SEVİYESİ: ORTA

┌────────────────────────────────────────────────────────────┐
│ Net Nakit Akışı = Gerçek Tasarruflar                       │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ +8.400 TRY                    [POZİTİF]                │ │
│ └────────────────────────────────────────────────────────┘ │
│ Net Nakit Akışı = Gelir (tekrarlayan + ekstra)            │
│                – Giderler (tekrarlayan + günlük + kredi)   │
└────────────────────────────────────────────────────────────┘

┌────────────────────────────────────────────────────────────┐
│ 📉 Kalan Bütçe                                              │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ 18.600 TRY                    [İSTİKRARLI]            │ │
│ └────────────────────────────────────────────────────────┘ │
│ • %62 bütçe ≈ %60 zaman → Uygun hızda harcama             │
└────────────────────────────────────────────────────────────┘

┌────────────────────────────────────────────────────────────┐
│ 💹 Ay Sonunda Beklenen Kalan                                │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ Beklenen: +6.900 TRY             [FAZLA]             │ │
│ └────────────────────────────────────────────────────────┘ │
│ • Beklenen Harcama = (Ort. Günlük Harcama × Kalan Günler)│
│                + (Bekleyen Sabit Giderler)                  │
└────────────────────────────────────────────────────────────┘

5.2 REPORT-02: Gelir Raporunu Görüntüleme

Amaç: Tekrarlayan gelir, ekstra gelir, trendler ve içgörüler dahil bu ayın gelirinin ayrıntılı analizini görüntüleyin.

Adımlar:

1. Raporlar ekranından, “Ayrıntılı Raporlar” bölümündeki 💵 Gelir menü öğesine dokunun
2. Bu Ayın Toplam Gerçek Geliri‘ni görüntüleyin: 63.000 TRY
3. Tekrarlayan Gelir bölümünü görüntüleyin: Toplam 45.000 TRY (Alınan: 39.000 TRY, Henüz alınmayan: 6.000 TRY), her öğe için ayrıntılar
4. Ekstra Gelir bölümünü görüntüleyin: Toplam 18.000 TRY (Serbest çalışma: 9.000 TRY, Eşya satışı: 3.000 TRY, Küçük ikramiye: 6.000 TRY), önceki aydan %5 artış
5. 3 Aylık Gelir Trendi‘ni görüntüleyin (sparkline grafik)
6. Aylık Gelir Geçmişi‘ni görüntüleyin: Bu ay, önceki ay, 2 ay önce
7. Gelir Analizi (İçgörüler)‘i görüntüleyin: Tekrarlayan gelir yüzdesi, istikrar değerlendirmesi, % artış/azalış

Wireframe: wf-bao-cao-thu-nhap.md dosyasına bakın

5.3 REPORT-03: Gider Raporunu Görüntüleme

Amaç: Tekrarlayan giderler, kategoriye göre günlük giderler, trendler ve harcama artışı kategorileri dahil bu ayın giderlerinin ayrıntılı analizini görüntüleyin.

Adımlar:

1. Raporlar ekranından, “Ayrıntılı Raporlar” bölümündeki 🔥 Giderler menü öğesine dokunun
2. Bu Ayın Toplam Gerçek Giderleri‘ni görüntüleyin: 54.600 TRY (önceki aydan %12 artış)
3. Tekrarlayan Giderler bölümünü görüntüleyin: Toplam 25.500 TRY (Ödenen: 22.500 TRY, Henüz ödenmeyen: 3.000 TRY), her öğe için ayrıntılar
4. Kategoriye Göre Günlük Giderler bölümünü görüntüleyin: Yemek 19.500 TRY (%36), Alışveriş 9.000 TRY (%16), Ulaşım 6.300 TRY (%12), Eğlence 4.200 TRY (%8), Diğer 3.000 TRY (%5)
5. Harcama Artışı bölümünü görüntüleyin: Yemek (+3.600 TRY, +%22), Alışveriş (+2.400 TRY, +%35)
6. 3 Aylık Gider Trendi‘ni görüntüleyin (sparkline grafik)
7. Aylık Gider Geçmişi‘ni görüntüleyin: Bu ay, önceki ay, 2 ay önce

Wireframe: wf-bao-cao-chi-tieu.md dosyasına bakın

5.4 REPORT-04: Bütçe Raporunu Görüntüleme

Amaç: Bütçe harcaması, kalan, plana göre varyans ve kategoriye göre giderler dahil bu ayın bütçe genel bakışını görüntüleyin.

Adımlar:

1. Raporlar ekranından, “Ayrıntılı Raporlar” bölümündeki 📉 Bütçe menü öğesine dokunun
2. Bu Ayın Bütçe Genel Bakışı‘nı görüntüleyin:
   • Aylık bütçe: 30.000 TRY (hesaplama ayrıntılarını görüntülemek için dokunun)
   • Harcanan: 11.400 TRY (Günlük giderler: 7.500 TRY, Gider varyansı: +1.500 TRY, Gelir varyansı: -600 TRY)
   • Kalan: 18.600 TRY
   • İlerleme çubuğu: %38.0 dinamik ipucu metniyle
3. Formülle Bütçe Detay İletişim Kutusu‘nu görüntülemek için “Aylık Bütçe”ye dokunun: Bütçe = Gelir - Giderler
4. Plana Göre Varyans bölümünü görüntüleyin: Varyanslı her gelir/gider öğesi, toplam varyans
5. Kategoriye Göre Giderler bölümünü görüntüleyin: Toplam, tutar, yüzde, ilerleme çubuğu ile her kategori
6. Kategoriye dokunarak o kategorideki giderlerin listesini görüntüleyin

Wireframe: wf-bao-cao-ngan-sach.md dosyasına bakın

5.5 REPORT-05: Tasarruf Raporunu Görüntüleme

Amaç: Gerçek tasarruflar, tasarruf analizi, tasarruf hesabı listesi ve trendler dahil bu ayın tasarruflarının ayrıntılı analizini görüntüleyin.

Adımlar:

1. Raporlar ekranından, “Ayrıntılı Raporlar” bölümündeki 💾 Tasarruflar menü öğesine dokunun
2. Ayrıntılı Net Nakit Akışı formülüyle Bu Ayın Gerçek Tasarrufları‘nı görüntüleyin: 12.600 TRY
3. Tasarruf Analizi bölümünü görüntüleyin: Gelirin %20’si tasarruf hesabı, önceki aydan %12 artış, ay sonu tahmini: 15.300 TRY (≈hedefin %85’i)
4. Tasarruf Hesabı Listesi bölümünü görüntüleyin: 3 hesap (120.000 TRY, 15.000 TRY, 60.000 TRY), en yakın vade tarihine göre sıralanmış
5. 6 Aylık Tasarruf Büyüme Grafiği‘ni görüntüleyin (çizgi grafik)

Wireframe: wf-bao-cao-tiet-kiem.md dosyasına bakın

5.6 REPORT-06: Kredi Raporunu Görüntüleme

Amaç: Mevcut borç bakiyesi, bu ayın kredi maliyeti, ödeme takvimi, içgörüler ve trendler dahil kredilerin ayrıntılı analizini görüntüleyin.

Adımlar:

1. Raporlar ekranından, “Ayrıntılı Raporlar” bölümündeki 💸 Krediler menü öğesine dokunun
2. Kredi Genel Bakışı‘nı görüntüleyin: Mevcut borç bakiyesi 1.950.000 TRY, Bu ayın kredi maliyeti 12.600 TRY (Anapara: 10.500 TRY + Faiz: 2.100 TRY)
3. En Yakın Ödeme bölümünü görüntüleyin: 25. Gün → ÖDENDİ, Sonraki ödeme 14 gün içinde
4. Aylık Ödeme Takvimi bölümünü görüntüleyin: Tutarlar ve durumla son 3 ay
5. Kredi Analizi (İçgörüler) bölümünü görüntüleyin: Son 3 ayda ödenen: 37.800 TRY, Borç bakiyesi trendi istikrarlı şekilde azalıyor, Faiz ödemenin %17’sini oluşturuyor, Gecikme riski: DÜŞÜK
6. 6 Aylık Borç Azaltma Grafiği‘ni görüntüleyin (çizgi grafik)

Wireframe: wf-bao-cao-khoan-vay.md dosyasına bakın

5.7 REPORT-07: Genel Bakış Raporundan Kategoriye Göre Giderleri Analiz Etme

Amaç: Genel bakış raporundan, ayrıntılı gider raporunu ve daha derin analizi görüntülemek için “Kategoriye Göre Giderler” bölümüne dokunun.

Adımlar:

1. Raporlar genel bakış ekranından, Kategoriye Göre Giderler bölümüne kaydırın
2. En yüksek yüzdelerle en üst 5 kategoriyi görüntüleyin
3. “Kategoriye Göre Giderler” kartına (chevron-right simgesiyle) dokunun
4. Uygulama otomatik olarak aynı ekrandaki Gider Raporu bölümüne kaydırır
5. Tam ayrıntıları görüntüleyin: Toplam giderler, tekrarlayan giderler, kategoriye göre günlük giderler (en üst 5’ten fazla), harcama artışı, trendler ve geçmiş

Wireframe: wf-bao-cao.md dosyasına bakın - “Kategoriye Göre Giderler” bölümü

5.8 REPORT-08: Yetersiz Veri Durumunda Raporları Görüntüleme (İlk Ay)

Amaç: Yeni uygulama kullanıcıları karşılaştırma ve trend analizi için yetersiz veri olduğunda ilk ayda raporları görüntüler.

Adımlar:

1. Raporlar sekmesine gidin
2. Finansal Sağlık bölümünü görüntüleyin:
   • Tasarruf hedefi ve gerçek tasarruflar (bütçe varsa)
   • Formülle Net Nakit Akışı
   • Kalan bütçe (varsa)
   • GÖSTERİLMEZ: “Harcama Hızı” (önceki ay verisi yok)
3. Gelecek Trend Tahmini bölümünü görüntüleyin (bütçe > 0 ise)
4. Gelir Raporu‘na dokunun: Bu ayın toplam geliri, tekrarlayan ve ekstra gelir, GÖSTERİLMEZ “3 Aylık Trend”, geçmişte YALNIZCA “Bu Ay” gösterilir
5. Gider Raporu‘na dokunun: Bu ayın toplam giderleri, tekrarlayan ve günlük giderler, GÖSTERİLMEZ “Harcama Artışı”, “3 Aylık Trend”, geçmişte YALNIZCA “Bu Ay” gösterilir

Wireframe: wf-bao-cao.md dosyasına bakın - koşullu görüntüleme ile kartlar

6. Mantık & Kurallar

6.1 Net Nakit Akışı Hesaplama

Formül:

Net Nakit Akışı_ay = 
  (Ayda gerçekten alınan tekrarlayan gelir + Ayda ekstra gelir)
  - (Ayda gerçekten ödenen tekrarlayan giderler + Ayda günlük giderler + Ayda gerçek kredi ödemeleri)

Ayrıntılar:

• Gelir: SUM(recurring_income_occurrence.amount_snapshot) WHERE durum = ‘TAMAMLANDI’ AND vade_tarihi ayda + SUM(extra_income.amount) WHERE occurred_at ayda
• Giderler: SUM(recurring_expense_occurrence.amount_snapshot) WHERE durum = ‘TAMAMLANDI’ AND vade_tarihi ayda + SUM(daily_expense.amount) WHERE occurred_at ayda + SUM(bank_debt_payment.total_amount) WHERE vade_tarihi ayda AND durum != ‘İPTAL EDİLDİ’
• Gerçek Tasarruflar: max(NetNakitAkışı_ay, 0) - Net Nakit Akışı pozitifse: Tasarruf = Net Nakit Akışı, Net Nakit Akışı negatifse: Tasarruf = 0 (aşırı harcama)

6.2 Tasarruf Hedefi Başarı Seviyesi

Formül:

oran = Tasarruf_ay / budget.savings_amount
ilerleme% = round(oran × 100)

Eşikler:

• İYİ: ilerleme% ≥ 90
• ORTA: 70 ≤ ilerleme% < 90
• KÖTÜ: ilerleme% < 70

6.3 Kalan Bütçe

Formül:

• % Kalan Bütçe = (Kalan Bütçe / Toplam Bütçe) × 100
• % Kalan Zaman = (Kalan Günler / Aydaki Toplam Günler) × 100

Sonuç:

• % bütçe ≈ % zaman ise: Harcama hızı MAKUL
• % bütçe < % zaman ise: Hızdan DAHA HIZLI harcama
• % bütçe > % zaman ise: Hızdan DAHA YAVAŞ harcama

Not: Bu kart yalnızca bu ay için bütçe oluşturulduğunda görüntülenir.

6.4 Ay Sonu Tahmini

Beklenen Harcama:

Beklenen_Harcama = 
  (Ort_Günlük_Harcama × Ayda_Kalan_Günler)
  + Toplam_Tekrarlayan_Gider_Bekleyen_Kalan_Ay
  + Ayda_Bekleyen_Toplam_Banka_Borcu_Ödemesi

Ayrıntılar:

• Ort_Günlük_Harcama = (Ay başından bugüne kadar toplam daily_expense.amount) / Ayda_Geçen_Günler
• Toplam_Tekrarlayan_Gider_Bekleyen = SUM(recurring_expense_occurrence.amount_snapshot) WHERE durum = ‘BEKLİYOR’ AND vade_tarihi yarından ay sonuna kadar
• Toplam_Banka_Borcu_Ödemesi_Bekleyen = SUM(bank_debt_payment.total_amount) WHERE vade_tarihi yarından ay sonuna kadar AND durum = ‘BEKLİYOR’

Ay Sonunda Beklenen Kalan:

Beklenen_Kalan_Ay_Sonu = NetNakitAkışı_ay - Beklenen_Harcama

Tasarruf Hedefi Başarı Olasılığı:

oran = Beklenen_Kalan_Ay_Sonu / budget.savings_amount
ilerleme% = round(oran × 100)

Etiketler:

• ≥ %90 → BAŞARACAK
• %70–89 → YAKIN BAŞARI
• < %70 → BAŞARMASI ZOR

Not: Tahmin yalnızca bütçe > 0 olduğunda görüntülenir.

6.5 Gerçek Veri vs Plan

• Tüm rapor verileri GERÇEK veriyi kullanır:
  • Gelir: TAMAMLANDI oluşumları + extra_income
  • Giderler: TAMAMLANDI oluşumları + daily_expense
  • Kredi ödemeleri: Ayda vade_tarihi olan bank_debt_payment (ödenip ödenmediğine bakılmaksızın)
• Plan verisini kullanmaz (henüz vadesi gelmemiş BEKLİYOR oluşumları)

7. Önemli Notlar

• Yalnızca Mevcut Ay Verisi: Raporlar yalnızca mevcut ayın verilerini görüntüler
• Görüntüleme Koşulları:
  • “Kalan Bütçe” kartı yalnızca bu ay için bütçe oluşturulduğunda görüntülenir
  • “Harcama Hızı” kartı yalnızca karşılaştırma için önceki ay verisi mevcut olduğunda görüntülenir
  • “Kredi Yükümlülükleri” kartı yalnızca krediler varsa görüntülenir
  • “Bütçe” menü öğesi yalnızca bütçe oluşturulduğunda görüntülenir
  • “Tasarruflar” menü öğesi yalnızca tasarruf hesapları varsa görüntülenir
  • “Krediler” menü öğesi yalnızca krediler varsa görüntülenir
  • “Gelecek Trend Tahmini” bölümü yalnızca bütçe > 0 olduğunda görüntülenir
• Tahmin Yalnızca Referans İçindir: Mevcut trendlere ve BEKLİYOR öğelere dayanır
• İlk Ay: Bazı kartlar/bölümler karşılaştırma verisi eksikliği nedeniyle görüntülenmez (örn: “Harcama Hızı”, “3 Aylık Trend”, “Harcama Artışı”)
• Kartlar Dokunulabilir: Bir karta dokunmak aynı ekrandaki ilgili ayrıntılı rapora kaydırır