kakeibo/docs/PHASES.md

🗺️ 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) — kullanıcının geniş kapsamlı testinden sonra, kullanıcı istediğinde	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

Faz 9 Adımları

• ✅ 1. Backend: rapor verileri — dönem istatistiklerine gelir/sabit gider/devir/gerçekleşen birikim (birikim oranı için) + GET /reports/breakdown (grup / tüm kategoriler / ödeme türü / ay; filtre: dönem ya da tarih aralığı, grup, kategori, ödeme türü). Bütçe sapması mevcut budget verisinden
• ✅ 2. Frontend: Raporlar sayfası — filtreler (adreste), gelir–gider çubuk grafiği, kategori kırılımı (tablo + grafik), bütçe sapması, ödeme türü dağılımı, birikim oranı trendi, varlık performansı; her rapor CSV (UTF-8 BOM, ;) + yazdır
• ✅ 3. CSV dışa/içe aktarma (uygulamanın kendi biçimi): harcamalar, plan kalemleri, varlık işlemleri; içe aktarmada önizleme + satır satır hata raporu
• ✅ 4. Banka / kredi kartı ekstresi içe aktarma — 4a backend (arşiv dönemleri, iade, gelir, yoksay, tekrar, öğrenen kurallar) + 4b arayüz (/ayarlar/ekstre: Excel/CSV, sütun eşleştirme + profil, gözden geçirme)
• ✅ 5. JSON tam hane yedeği — 5a backend (sürümlü dosya + SHA-256, önizleme, tam değiştirme tek transaction, geri dönüş noktaları + "geri al", başka haneye kimlik çevirerek taşıma) · 5b arayüz (Ayarlar → Veri: indir + "son yedek" hatırlatması, sahip için önizleme → onay → geri yükle → "Geri al", geri dönüş noktaları)
• ✅ 6. Aylık değerlendirme çıktısı — 6a backend (templates/monthly_report.md + minijinja, GET /periods/{id}/report.md, kural tabanlı yorum ve öneriler) · 6b arayüz (/degerlendirme/rapor: uygulama içi görünüm, Yazdır/PDF A4, Markdown indir; Değerlendirme, kapatma sonucu ve dönem geçmişinden bağlantı)

Faz 10 Adımları (web uygulamasının eksikleri + cila)

• ✅ 1. Ayarlar yeniden düzeni (/ayarlar menü + tema) · Kategori yönetimi (grup grup ekle, ad/emoji düzenle, sırala, pasifleştir) · Ödeme türü yönetimi · Veri sayfası /ayarlar/veri
• ✅ 2. Hane ve hesap: hane adı, üyeler, davet bağlantısı (oluştur/kopyala/iptal), üye çıkarma; profil adı, şifre değiştirme; varsayılan bütçe yüzdeleri + öneri yöntemi
• ✅ 3. Arayüz cilası ve erişilebilirlik: tüm sayfaların telefon/masaüstü/koyu tema taraması, boş durumlar, skeleton, %80 bütçe uyarısı, odak/klavye, kontrast, onay diyalogları
• ✅ 4. Performans: sayfa bazlı kod bölme (lazy route), statik dosyalarda uzun önbellek, paket boyutu
• ✅ 5. PWA: manifest + service worker (uygulama kabuğu; /api asla önbelleğe alınmaz), kurulum, güncelleme bildirimi

Borç Takibi Adımları (docs/BORC_TAKIBI.md, kullanıcı isteği 2026-11-14)

• ✅ B1. Backend: ölçümler, taksit planları (ilk ay + adet → aylık yük/kalan kendiliğinden), yol haritası, özet, dönem borcu (ay başı, devreden, hedef), elle ay başı, kaynak belge JSON'unu içe aktarma (ön izleme/onay), JSON yedeğine dahil
• ✅ B2. Arayüz: Panel borç kartı, /borc (gerçek + hedef grafik, tablo, yeni ölçüm, hedefler, içe aktar), /taksitler
• ✅ B3. Aylık plan entegrasyonu ("Borç ödemesi", ay başı/devreden/hedef, taksit önerisi) + içe aktarma dosyası (repo dışı)