suphicakir/kakeibo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
3f60efdc3310fbbb8cf4cf4d103281a7c75e4617
kakeibo/docs/PHASES.md
T
suphicakir 3f60efdc33 feat(birikim): otomatik ve manuel kurlar, portföy değerlemesi 
- TCMB (döviz alış kuru) ve xaus.com (altın) saatlik arka planda çekilir, gün başına saklanır
- Kaynak erişilemezse son kur geçerli; altın için son USD kuru kullanılır
- Elle kur girişi/silme; aynı gün elle girilen kur önceliklidir
- GET /portfolio: güncel değer, kâr/zarar, toplamlar, son kur çekimi
- RATES_REFRESH_MINUTES ayarı

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-13 00:59:01 +03:00

7.1 KiB
Raw Blame History

🗺️ Fazlar

✅ tamam · 🔄 devam · ⏳ bekliyor

Faz Kapsam Çıktı Durum
Faz 0 Ortam kurulumu, VS Code yapılandırması, monorepo iskeleti, hafıza dosyaları, yerel MongoDB, veri modeli onayı npm run dev ile boş uygulama tarayıcıda açılıyor ✅
Faz 1 Backend temeli: config, DB bağlantısı, kimlik doğrulama, hane, kategoriler, ödeme türleri, health check API .http dosyasıyla test edilebiliyor ✅
Faz 2 Frontend temeli: tasarım sistemi, tema, logo/ikonlar, layout, navigasyon, giriş/kayıt Giriş yapılabilen, temalı iskelet uygulama ✅
Faz 3 🚀 İlk canlıya alma: Dockerfile, Dokploy, canlı MongoDB, domain + HTTPS, yedekleme Giriş ekranı canlıda çalışıyor ✅
Faz 4 Dönem açma + aylık planlama + notlar Plan ekranı ✅
Faz 5 Günlük defter Harcama girişi 🔄
Faz 6 Ay sonu değerlendirmesi + dönem kapatma/devir sihirbazı Tam dönem döngüsü ✅
Faz 7 Dashboard: özet kartları ve grafikler Ana ekran ✅
Faz 8 Birikimler/varlıklar, kur entegrasyonu, kâr/zarar Birikim modülü 🔄
Faz 9 Raporlama + JSON/CSV içe–dışa aktarma + aylık değerlendirme çıktısı Raporlar ⏳
Faz 10 PWA, performans, erişilebilirlik, UI cilası + Ayarlar: kategori / ödeme türü yönetimi Telefona kurulabilir web uygulaması ⏳
Faz 11+ Tauri 2: Windows, Linux, Android (çevrimdışı + senkronizasyon) Masaüstü ve mobil uygulamalar ⏳

Faz 0 Adımları

  • ✅ 1. Ortam kontrolü ve kurulum yönergeleri
  • ✅ 2. .vscode/ yapılandırması ve monorepo iskeleti
  • ✅ 3. Hafıza dosyaları (CLAUDE.md, MEMORY.md, PHASES.md) + Git remote
  • ✅ 4. Yerel MongoDB (Docker, replica set) + npm run dev
  • ✅ 5. Veri modeli taslağı (docs/DATA_MODEL.md) → onaylandı

Faz 1 Adımları

  • ✅ 1. config.rs + db.rs (MongoDB bağlantısı), Türkçe hata yapısı, health check'e DB durumu
  • ✅ 2. Modeller, migration mekanizması ve indeksler
  • ✅ 3. Kimlik doğrulama: kayıt (+ hane + örnek kategori/ödeme türü), giriş, çıkış, me; argon2 + JWT cookie + rate limit
  • ✅ 4. Hane izolasyonu (middleware), üye davet kodu
  • ✅ 5. Kategori ve ödeme türü uç noktaları + hane izolasyonu testleri, api.http

Faz 2 Adımları

  • ✅ 1. Tailwind v4 + shadcn/ui (radix, nova), tasarım token'ları (4 grup + durum renkleri, AA doğrulandı), Inter, tema (aydınlık/karanlık/sistem), lib/format.ts + Vitest
  • ✅ 2. Logo ve uygulama ikonu (SVG), favicon, PWA/Apple ikonları
  • ✅ 3. lib/api.ts, TanStack Query, ts-rs tip üretimi, oturum durumu
  • ✅ 4. Router (react-router), korumalı sayfalar, layout: mobil alt menü / masaüstü sol menü
  • ✅ 5. Giriş / kayıt ekranları (react-hook-form + zod, beni hatırla, davet kodu), arayüz metinleri tek dosyada

Faz 3 Adımları

  • ✅ 1. Dockerfile (çok aşamalı), Axum arayüzü sunar (SPA yönlendirmesi, önbellek başlıkları, sıkıştırma), graceful shutdown, yerelde imaj testi
  • ✅ 2. Canlı MongoDB kontrolü (§12.3): kurulum şekli, replica set, ayrı kullanıcı, dış erişim
  • ✅ 3. Dokploy: Gitea bağlantısı, ortam değişkenleri, alan adı + HTTPS, ilk yayın
  • ✅ 4. Canlıda ilk hesap + kontrol listesi
  • ⏳ 5. Yedekleme (mongodump, 14 gün) + geri yükleme denemesi — ertelendi, Faz 5 bitmeden yapılacak

Faz 4 Adımları

  • ✅ 1. Backend: dönem (aç, açık dönem, liste, detay + haftalar, düzenle), takvim hesapları, testler
  • ✅ 2. Backend: plan kalemleri (sabit gelir/gider, önceki dönemden kopyala) + notlar
  • ✅ 3. Backend: bütçe (aylık/haftalık, öneri), özet (harcanabilir tutar)
  • ✅ 4. Frontend: ilk dönem sihirbazı
  • ✅ 5. Frontend: Plan ekranı (görüntüle/düzenle, özet kutucukları, bütçe dağıtımı)
  • ✅ 6. Frontend: notlar (Markdown, düzenle/önizle)

Faz 5 Adımları (taslak)

  • ✅ 1. Backend: harcama kayıtları (ekle/düzenle/sil + geri al, hafta/dönem filtresi, kategori–grup tutarlılığı, yalnızca açık dönem), testler
  • ✅ 2. Backend: haftalık/aylık gerçekleşen (grup bazlı bütçe–harcanan–kalan), özet ve önerilere gerçekleşen verisi
  • ✅ 3. Frontend: Defter — hafta seçici + hızlı giriş formu (tutar, 4 grup düğmesi, kategori, ödeme türü, tarih, açıklama; son seçim hatırlanır)
  • ✅ 4. Frontend: haftanın girişleri (gün gün), düzenle/sil + "Geri al", haftalık özet
  • 🔄 5. Canlı yedekleme (betikler + test ✅, sunucuda kurulum kullanıcıda) (mongodump günlük, 14 gün) + geri yükleme denemesi

Faz 6 Adımları (taslak)

  • ✅ 1. Backend: değerlendirme (GET /periods/{id}/review: 4 soru, grup/kategori/hafta) + reflection_md
  • ✅ 2. Backend: dönem kapatma (transaction: durum, devir, birikime aktarılan tutar) + yeni dönemde devrin bağlanması + yeniden açma (sahip)
  • ✅ 3. Frontend: Değerlendirme sayfası (4 soru, planlanan/gerçekleşen, en çok harcanan kategoriler, haftalık dağılım, "Nasıl daha iyi yapabilirim?", notlar)
  • ✅ 4. Frontend: dönem kapatma sihirbazı (+ yeni dönemi kopyalayarak açma)
  • ✅ 5. Frontend: kapalı dönemler listesi + yeniden açma (sahip) + düzeltmedeki dönemi Defter/Plan/Değerlendirme'de seçme

Faz 7 Adımları

  • ✅ 1. Backend: GET /periods/{id}/daily (gün × grup harcama; günlük/haftalık grafik verisi) + GET /stats/periods (son 12 dönem: harcanabilir, harcanan, birikime aktarılan; aylık grafik ve toplam birikim)
  • ✅ 2. Frontend: özet kartları (gelir, sabit gider, toplam birikim, devreden borç, grup planlanan/gerçekleşen haftalık–aylık, anlık durum en belirgin) + "➕ Harcama Ekle" (mobilde yüzen düğme) + skeleton ve boş durumlar
  • ✅ 3. Frontend: grafikler (Recharts) — kümülatif harcanabilir vs. gerçekleşen; 4 grup + harcanabilir; Günlük / Haftalık / Aylık sekmeleri, koyu tema, erişilebilir özet

Faz 8 Adımları

  • ✅ 1. Backend: varlıklar (hane başına varsayılanlar: TL, gram/çeyrek/yarım/tam altın, ons, USD, EUR; döviz eklenebilir) + alım/satım kayıtları (satış ≤ eldeki miktar) + varlık başına miktar, ağırlıklı ortalama maliyet, gerçekleşen kâr/zarar; testler
  • ✅ 2. Backend: kurlar — TCMB today.xml (döviz) + xaus.com ons fiyatı × TCMB USD (altın; çeyrek/yarım/tam has gram katsayısıyla), saatlik arka plan görevi + önbellek (exchange_rates), kaynak erişilemezse son kur + zamanı; manuel kur (hane); portföy değerleme uç noktası (güncel değer, kâr/zarar tutar ve %, toplamlar, dağılım); kaynak ayrıştırıcıları örnek dosyalarla testli
  • ⏳ 3. Frontend: Birikim sayfası — portföy özeti + halka grafik, varlık listesi (miktar, ortalama maliyet, güncel kur, değer, kâr/zarar), alım/satım formu, işlem geçmişi (düzenle/sil), manuel kur, eski kur uyarısı
  • ⏳ 4. Kapanış entegrasyonu: birikime aktarılan tutar onayla TL varlığına eklenir (source_period_id, tekrar eklenmez); geçmiş kapanışlar için "bekleyen birikimler" listesi; Panel "Toplam birikim" → portföyün güncel değeri
Reference in New Issue View Git Blame Copy Permalink