💰 Cüzdan Modülü
Backend ismi: wallet — 22 endpoint, 8 sekme, tam kişisel finans yönetimi
⚠️ Naming Convention
Frontend "Cüzdan" → Backend "wallet". Önceki MD'lerde eksikti.
📑 8 Sekme
| Sekme | Endpoint | İçerik |
|---|---|---|
| 1. İşlemler | /api/wallet/transactions + /upcoming | Tüm gelir-gider |
| 2. Tekrarlayan | /api/wallet/recurring + /confirm | Kira, abonelik vs. |
| 3. Vadeli Mevduat | /api/wallet/mevduat + /ozet | Banka mevduat hesapları |
| 4. Hedefler | /api/wallet/goals + /add + /withdraw | Finansal hedefler |
| 5. Analiz | /api/wallet/analytics/monthly + /categories | Kategori/dönem analiz |
| 6. Bütçe | /api/wallet/budget | Aylık bütçe planı |
| 7. Çevirme | /api/wallet/conversions + POST /convert | Döviz dönüşüm |
| 8. Kategoriler | /api/wallet/categories | Harcama yönetimi |
🔌 22 Endpoint Tamamı
GET/api/wallet/balance
GET/api/wallet/summary
GET/api/wallet/budget
GET/api/wallet/transactions
GET/api/wallet/transactions/{id}
GET/api/wallet/upcoming
GET/api/wallet/recurring
GET/api/wallet/recurring/{id}
POST/api/wallet/recurring/{id}/confirm
GET/api/wallet/categories
GET/api/wallet/categories/{id}
GET/api/wallet/analytics/categories
GET/api/wallet/analytics/monthly
GET/api/wallet/goals
GET/api/wallet/goals/{id}
POST/api/wallet/goals/{id}/add
POST/api/wallet/goals/{id}/withdraw
GET/api/wallet/mevduat
GET/api/wallet/mevduat/{id}
GET/api/wallet/mevduat/ozet
GET/api/wallet/conversions
POST/api/wallet/convert
🔄 Portföy ↔ Cüzdan Otomatik Sync (KRİTİK!)
POST /api/portfolio/trade sonrası backend otomatik:
[Trade insert] → [trade:changed event]
│
▼
[Wallet service event'i alır]
│
▼
[INSERT wallet_transactions]
- tip: cikis
- tutar: -₺21,300,000
- kategori: "Portföy"
- aciklama: "Portföy alım: SVGYO"
│
▼
[UPDATE wallet_balance]
│
▼
[Event: wallet:transaction + balance:changed]
│
▼
[WS broadcast → 3 sayfa eş zamanlı refresh]
💱 Döviz Çevirici
- 6 parite: USD↔TRY, EUR↔TRY, USD↔EUR
- Anlık kur:
1 USD = 45.7132 TRY(real-time) - POST
/api/wallet/convertile bakiyeler arası transfer
📤 Export
GET /api/export/wallet/excelGET /api/export/wallet/pdf
📊 Bekir Gerçek Veri
| Toplam Bakiye | ₺978,678,700 |
| Gelir (Maaş test) | +₺1,000,000,000 |
| Gider (SVGYO alım) | -₺21,321,300 |