neta/ROADMAP.md

# Freelancer OS Roadmap

Bu dokuman, uygulamanin temel urun yonunu ve MVP kapsamını tanımlar.

Uygulamanin cikis noktasi: Freelancer'larin gundelik hayatlarini, musterilerini, projelerini, side project'lerini, finansal durumlarini ve kisisel performanslarini tek bir self-host edilebilir dashboard uzerinden yonetebilmesi.

MVP, tek kullanici odakli olacak. Ekip, ajans, CRM otomasyonlari, gelismis AI modulleri ve mobil uygulama MVP sonrasi fazlara birakilir.

---

## Urun Vizyonu

Freelancer icin tek merkezli bir operasyon paneli:

- Bugun ne yapacagim?
- Hangi musteride hangi is var?
- Hangi proje gecikiyor?
- Side project'lerimde ilerleme var mi?
- Bu ay ne kadar kazandim, ne kadar harcadim?
- Enerjim ve ruh halim is performansimi nasil etkiliyor?
- Tum bu verilerden hangi raporu okuyabilirim?

Uygulama, klasik gorev takip aracindan daha genis; freelancer'in is, finans ve kisisel performans alanlarini birlestiren bir "Freelancer OS" olarak konumlanir.

---

## MVP Ilkeleri

1. **Tek kullanici**
   - MVP'de ekip, rol, yetki, assignee, ortak calisma yok.
   - Tum veriler tek kullanicinin kendi calisma alani icindir.

2. **Self-host ve open-source uyumlu**
   - Kurulum dokumani net olmali.
   - Veritabani migration'lari repo icinde olmali.
   - Harici servisler opsiyonel olmali.

3. **Gercek veri, sade akis**
   - Mock dashboard yerine kullanicinin girdigi gercek verilerden rapor uretilecek.
   - Her modulde minimum CRUD ve minimum rapor yeterli.

4. **AI destekleyici, cekirdek degil**
   - MVP'de AI sadece genel chatbot olarak konumlanir.
   - Chatbot, kayitli gorev/proje/musteri/finans/gunluk verileri hakkinda soru cevap yapabilir.
   - Modul icindeki otomatik oneriler, scoring, akilli otomasyonlar MVP sonrasi.

5. **Ekranda rapor yeterli**
   - MVP'de PDF/PNG export sart degil.
   - Dashboard ve modul rapor ekranlari yeterli kabul edilir.

---

## MVP Kapsami

### 1. Dashboard

**Amac:** Freelancer'in gunluk ve haftalik durumunu tek bakista gostermek.

MVP icerigi:

- Bugunku gorevler
- Yaklasan takvim etkinlikleri
- Aktif musterilerden acik isler
- Aktif projeler ve side project'ler
- Bu ay gelir/gider ozeti
- Haftalik gorev tamamlama grafigi
- Mood/energy trend grafigi
- Geciken isler ve yaklasan deadline'lar

Raporlar:

- Haftalik is yuklemesi
- Proje ilerleme ozeti
- Aylik finans ozeti
- Kisisel enerji/mood ozeti

---

### 2. Musteriler

**Amac:** Freelancer'in calistigi musterileri ve o musterilerle iliskili isleri takip etmesi.

MVP alanlari:

- Musteri adi
- Firma/marka adi
- E-posta
- Telefon veya iletisim notu
- Durum: active, paused, archived
- Notlar

MVP aksiyonlari:

- Musteri ekleme
- Musteri duzenleme
- Musteri arsivleme
- Musteriye bagli projeleri/gorevleri gorme

Raporlar:

- Aktif musteri sayisi
- Musteri bazli proje sayisi
- Musteri bazli gelir ozeti

MVP disi:

- Gelismis CRM pipeline
- E-posta entegrasyonu
- Otomatik takip hatirlatmalari
- Musteri sentiment analizi

---

### 3. Projeler ve Side Project'ler

**Amaç:** Müşteri projeleri ve kişisel side project'leri aynı temel mantıkla ama ayrı türlerle takip etmek. Proje yönetimi yalnızca görevlerden oluşmaz; proje hedefi, çözdüğü problem, kapsamı, görsel kimliği ve planlama notları da projenin ana parçasıdır.

MVP alanları:

- Proje adı
- Tür: client_project, side_project
- Bağlı müşteri, sadece client_project için opsiyonel/zorunlu
- Kapak görseli, kullanıcının bilgisayarından yüklenir
- Kapak görseli alt metni
- Açıklama
- Durum: planning, active, paused, completed, cancelled
- Başlangıç tarihi
- Deadline
- Bütçe veya beklenen gelir
- İlerleme yüzdesi, görevlerden otomatik hesaplanabilir veya manuel güncellenebilir

MVP proje detay alanları:

- Genel bakış: Projenin kısa özeti, mevcut durum ve önemli notlar
- Çözdüğü problem: Hangi kullanıcı/müşteri problemini çözdüğü
- Amaç ve başarı kriterleri: Proje bittiğinde neyin başarılı kabul edileceği
- Hedef kitle: Projenin kimin için yapıldığı
- Kapsam: Dahil olan ve dahil olmayan işler
- Design system: Renk paleti, tipografi, component notları ve görsel dil
- Renk paleti: Hex değerleri, kullanım rolleri ve notlar
- Tipografi: Font ailesi, başlık/gövde kullanımı ve hiyerarşi notları
- Görsel varlıklar: Kapak görseli ve proje içi görsel referanslar
- Serbest notlar: Projeye özel planlama notları

MVP aksiyonları:

- Proje ekleme
- Proje düzenleme
- Projeye bilgisayardan kapak görseli yükleme
- Proje detay sayfasında görev dışı planlama alanlarını yönetme
- Proje detayında design system alanları ekleme/düzenleme
- Projeye görev bağlama
- Proje durumunu güncelleme
- Projeyi tamamlandı olarak işaretleme

Raporlar:

- Aktif proje sayısı
- Geciken proje sayısı
- Proje bazlı görev tamamlama oranı
- Müşteri projeleri / side project dağılımı
- Design system alanı eksik olan aktif projeler
- Amaç veya problem tanımı eksik olan projeler

MVP dışı:

- Ekip üyeleri
- Gelişmiş dosya/drive yönetimi
- Kanban sprint sistemi
- Gelişmiş risk analizi

---

### 4. Gorevler

**Amac:** Freelancer'in gunluk operasyonunu yonetmek.

MVP alanlari:

- Baslik
- Aciklama
- Durum: todo, in_progress, done
- Oncelik: low, medium, high, urgent
- Son tarih
- Bagli proje
- Bagli musteri, proje uzerinden de turetilebilir
- Tahmini sure
- Gerceklesen sure, basit manuel giris olarak

MVP aksiyonlari:

- Gorev ekleme
- Gorev duzenleme
- Gorev tamamlama
- Liste ve basit kanban gorunumu
- Geciken gorevleri filtreleme

Raporlar:

- Haftalik tamamlanan gorev sayisi
- Duruma gore gorev dagilimi
- Oncelige gore gorev dagilimi
- Proje bazli acik gorevler

MVP disi:

- Team assignee
- Otomatik AI onceliklendirme
- Gelismis time tracking timer

---

### 5. Takvim

**Amac:** Deadline, toplanti, odak blogu ve kisisel etkinlikleri planlamak.

MVP alanlari:

- Baslik
- Baslangic tarihi/saati
- Bitis tarihi/saati
- Tur: meeting, focus, deadline, personal, finance
- Bagli musteri/proje/gorev
- Not

MVP aksiyonlari:

- Etkinlik ekleme
- Etkinlik duzenleme
- Aylik gorunum
- Yaklasan etkinlik listesi

Raporlar:

- Haftalik etkinlik dagilimi
- Odak bloklari / toplantilar orani
- Yaklasan deadline listesi

MVP disi:

- Google Calendar entegrasyonu
- Iki yonlu sync
- AI schedule optimization

---

### 6. Finans

**Amac:** Freelancer'in temel gelir, gider ve nakit akis durumunu takip etmesi.

MVP alanlari:

- Islem tipi: income, expense
- Tutar
- Para birimi
- Tarih
- Kategori
- Bagli musteri
- Bagli proje
- Aciklama
- Odeme durumu: planned, pending, paid, cancelled

MVP aksiyonlari:

- Gelir ekleme
- Gider ekleme
- Islem duzenleme
- Islem silme/arsivleme
- Aylik filtreleme

Raporlar:

- Aylik gelir
- Aylik gider
- Net kazanc
- Musteri bazli gelir
- Proje bazli gelir
- Kategori bazli gider

MVP disi:

- Fatura olusturma
- Vergi hesaplama
- Banka entegrasyonu
- Subscription tracking
- Coklu sirket/hesap

---

### 7. Gunluk Mood / Energy

**Amac:** Freelancer'in kisisel kapasitesini ve is performansiyla iliskisini takip etmek.

MVP alanlari:

- Tarih
- Mood skoru
- Energy skoru
- Kisa not
- Calisma memnuniyeti skoru, opsiyonel

MVP aksiyonlari:

- Gunluk kayit ekleme
- Kayit duzenleme
- Haftalik/aylik trend izleme

Raporlar:

- Mood trend
- Energy trend
- Energy ile tamamlanan gorev iliskisi
- Dusuk enerji gunlerinde geciken gorevler

MVP disi:

- AI duygu analizi
- Otomatik etiketleme
- Klinik/terapötik yorumlar

---

### 8. AI Chatbot

**Amac:** Kullanici, kendi kayitli verileri hakkinda genel sorular sorabilsin.

MVP davranisi:

- Son 7/30 gun gorevleri, projeleri, takvim etkinlikleri, finans kayitlari ve mood/energy verileri context olarak hazırlanır.
- Kullanici basit sorular sorar:
  - "Bu hafta en cok hangi projeye zaman harcamisim?"
  - "Hangi musterilerden odeme bekliyorum?"
  - "Bu ay finansal durumum nasil?"
  - "Geciken islerim neler?"
  - "Enerjim dusukken hangi isler aksamis?"

Teknik yaklasim:

- MVP'de tam vector RAG sart degil.
- Ilk asama: veritabanindan ilgili ozet context olusturup modele gondermek.
- Provider opsiyonlari: Ollama local, OpenAI, Gemini, Groq.

MVP disi:

- Embedding tabanli gelismis RAG
- Modul ici AI butonlari
- Otomatik gorev/proje onerisinde bulunma
- Otomatik finans yorumu
- Otonom aksiyon alma

---

## MVP Disi Birakilacaklar

Asagidaki ozellikler ilk surume alinmayacak:

- Ekip ve rol yonetimi
- Gelismis CRM pipeline
- Teklif ve sozlesme sistemi
- Fatura olusturma
- Banka veya odeme entegrasyonlari
- Dokuman/drive yonetimi
- PDF/PNG export
- Mobil uygulama
- Google Calendar sync
- Modul bazli AI otomasyonlari
- Gelismis RAG/vector search
- Bildirim sistemi

---

## Teknik Mimari Karari

### Onerilen MVP Stack

- **Frontend:** Next.js App Router, React, TypeScript
- **UI:** Poyraz UI, Tailwind CSS v4, Recharts
- **Database:** PostgreSQL
- **Backend/Auth:** Supabase veya self-host edilebilir Supabase alternatifi
- **Local AI opsiyonu:** Ollama
- **Cloud AI opsiyonlari:** OpenAI, Gemini, Groq

### UI Karari

MVP tasarimi Poyraz UI ile light design olarak kurulacak.

Mevcut dark shadcn/Radix agirlikli prototip tasarim sistemi MVP icin referans alinmayacak. Sayfalar Poyraz UI bilesenleri, `poyraz-ui/preset.css` token sistemi ve Poyraz UI semantic renkleri uzerinden yeniden insa edilecek.

Gecis prensipleri:

- Ilk hedef login, register ve sidebar gibi uygulama kabugu ekranlari.
- Daha sonra Faz 2'de her modul kendi CRUD akisi gelistirilirken Poyraz UI'a tasinacak.
- Light design varsayilan olacak.
- Dark mode MVP icin zorunlu degil; Poyraz UI destekledigi icin sonraki fazlarda eklenebilir.
- Eski UI bilesenleri sadece gecici olarak kullanilabilir; yeni sayfa ve moduller Poyraz UI ile yazilacak.

### Neden Server-first?

Mobil uygulama sonraki hedef oldugu icin verinin senkronize olabilecegi merkezi bir backend gerekir. Bu nedenle MVP'de ana kaynak PostgreSQL/Supabase olmali.

Offline/local-first destek daha sonra eklenebilir:

- IndexedDB cache
- Offline draft kayitlari
- Sync queue
- Conflict resolution

MVP'de bu alan mimaride dusunulur, fakat ana risk haline getirilmez.

---

## MVP Veri Modeli

Minimum tablolar:

- `profiles`
- `clients`
- `projects`
- `project_planning_sections`
- `tasks`
- `calendar_events`
- `finance_transactions`
- `daily_logs`
- `chat_sessions`
- `chat_messages`
- `app_settings`
- Supabase Storage bucket: `project-assets`

Temel iliskiler:

- `clients` -> `projects`
- `projects` -> `project_planning_sections`
- `projects` -> `tasks`
- `clients` -> `finance_transactions`
- `projects` -> `finance_transactions`
- `calendar_events` -> `clients`, `projects`, `tasks` opsiyonel
- `daily_logs` -> kullanici ve tarih
- `chat_messages` -> `chat_sessions`

---

## Faz Plani

### Faz 0: Stabilizasyon

Amac: Mevcut prototipi build edilebilir ve gelistirilebilir hale getirmek.

Isler:

- Build hatalarini gidermek.
- Urun adini netlestirmek: `Cognis`.
- Encoding bozukluklarini temizlemek.
- Mock veri kullanan ekranlari isaretlemek.
- `user_settings` yerine `app_settings` semasini netlestirmek.
- Supabase SQL dosyalarini sira, dokumantasyon ve calistirma kaydi olan bir sisteme oturtmak.
- Mevcut `supabase/schema.sql` dosyasini ilk database baseline olarak kaydetmek.
- Her yeni SQL ekinde ilgili dokumani ve query log kaydini zorunlu hale getirmek.
- MVP disi ekranlari sidebar'dan gecici olarak kaldirmak veya "coming later" durumuna almak.

Kabul kriteri:

- `npm run build` basarili.
- Ana layout, auth ve dashboard sorunsuz acilir.
- MVP kapsamindaki moduller net gorunur.
- Database query sirasi `docs/database/query-order.md` icinde kayitlidir.
- Calistirilan SQL dosyalari `docs/database/query-log.md` icinde takip edilir.
- Ilk baseline olan `supabase/schema.sql` icin aciklayici dokuman vardir.

---

### Faz 1: Veritabani ve Auth

Amac: Freelancer OS icin gercek veri modelini kurmak.

Isler:

- `clients`, `projects`, `tasks`, `calendar_events`, `finance_transactions`, `daily_logs`, `app_settings` tablolarini olusturmak.
- RLS politikalari eklemek.
- Supabase migration dosyalarini repo icine almak.
- Seed/demo data script'i hazirlamak.
- Tek kullanici akisina uygun auth'u sade tutmak.

Kabul kriteri:

- Yeni tablolar Supabase'de calisir.
- Kullanici sadece kendi verisini gorur.
- Demo data ile dashboard beslenebilir.

Faz 1 repo ciktisi:

- Core schema migration: `supabase/migrations/0002_add_freelancer_os_core_tables.sql`
- Demo seed dosyasi: `supabase/seeds/0001_demo_freelancer_os_data.sql`
- Migration dokumani: `docs/database/0002-freelancer-os-core-tables.md`
- Seed dokumani: `docs/database/seed-0001-demo-freelancer-os-data.md`
- Query sirasi kaydi: `docs/database/query-order.md`

Not: SQL dosyalari repo icinde hazirdir. Supabase ortaminda calistirildiktan sonra `docs/database/query-log.md` guncellenmelidir.

---

### Faz 1.5: Poyraz UI Tasarim Sistemi Gecisi

Amac: Mevcut koyu prototip tasarimindan ayrilip uygulama kabugunu Poyraz UI tabanli light design sistemine tasimak.

Isler:

- `poyraz-ui` paketini projeye eklemek.
- Global CSS icinde Poyraz UI preset importunu yapmak: `@import "poyraz-ui/preset.css";`
- Tailwind CSS v4 gereksinimini ve mevcut Tailwind yapisiyla uyumlulugu netlestirmek.
- Poyraz UI light tokenlarini varsayilan tasarim dili olarak ayarlamak.
- Mevcut shadcn/Radix agirlikli dark auth tasarimini Poyraz UI ile degistirmek.
- Login sayfasini Poyraz UI atoms/molecules ile yeniden kurmak.
- Register sayfasini Poyraz UI atoms/molecules ile yeniden kurmak.
- Dashboard shell ve sidebar'i Poyraz UI navigation/organism yaklasimina gore yeniden kurmak.
- Eski dark background, gradient, glow ve agir motion desenlerini uygulama kabugundan kaldirmak.
- Poyraz UI kullanim notlarini proje dokumantasyonuna baglamak.

Kabul kriteri:

- Login light design ile Poyraz UI bilesenleri kullanarak calisir.
- Register light design ile Poyraz UI bilesenleri kullanarak calisir.
- Sidebar ve temel dashboard shell Poyraz UI tasarim diliyle uyumludur.
- Uygulama varsayilan olarak light gorunur.
- `npm run build` basarili olur.

Notlar:

- Bu fazda modul ic sayfalarinin tamamini yeniden tasarlamak zorunlu degildir.
- Modul sayfalari Faz 2'de CRUD gelistirme sirasinda Poyraz UI'a tasinir.
- Poyraz UI rehberi: `poyraz-ui-usage-guide.md`

Faz 1.5 repo ciktisi:

- Poyraz UI paketi projeye eklendi.
- Tailwind CSS v4 ve `@tailwindcss/postcss` gecisi yapildi.
- Global CSS, `poyraz-ui/preset.css` ve light Poyraz tokenlariyla guncellendi.
- Login ve register sayfalari Poyraz UI atomlariyla yeniden kuruldu.
- Dashboard shell ve sidebar Poyraz UI organism yaklasimina tasindi.

---

### Faz 2: Core CRUD Modulleri

Amac: Freelancer'in temel operasyon verilerini girebilmesi.

Isler:

- Musteriler CRUD
  - Liste, bos durum, ekleme/duzenleme formu ve detay gorunumu Poyraz UI ile kurulur.
  - Eski CRM/prototip gorsel dili kaldirilir.
- Projeler/side project CRUD
  - Proje kartlari, filtreler, detay paneli ve form akislari Poyraz UI ile kurulur.
  - Musteri projesi ve side project ayrimi UI'da net gosterilir.
  - Proje kapak gorseli bilgisayardan yuklenebilir; harici gorsel linki MVP icin ana akis olmaz.
  - Proje detay sayfasi eklenir.
  - Proje detayinda gorevler disinda planlama alanlari yonetilir: genel bakis, cozdugu problem, amac, hedef kitle, kapsam, design system, renk paleti, tipografi, gorsel varliklar ve notlar.
  - Design system alaninda renk paleti, tipografi ve component/gorsel dil notlari eklenebilir ve duzenlenebilir.
  - Proje detay sayfasi proje icin tek kaynak olur; gorevler sadece bu kaynak icindeki operasyon katmanidir.
- Gorevler CRUD
  - Liste ve basit kanban Poyraz UI bilesenleriyle yeniden tasarlanir.
  - Durum, oncelik, deadline ve proje iliskisi icin Poyraz UI Badge/Form/Select kullanilir.
- Takvim etkinlikleri CRUD
  - Aylik gorunum ve yaklasan etkinlik listesi light design ile kurulur.
  - Etkinlik formu Poyraz UI form bilesenleriyle yazilir.
- Finans islemleri CRUD
  - Gelir/gider listesi, finans kartlari ve islem formu Poyraz UI ile kurulur.
  - Rapor kartlari Poyraz UI StatsCard/Card yaklasimina uygun olur.
- Daily mood/energy CRUD
  - Gunluk kayit formu, trend ozeti ve kayit listesi Poyraz UI ile kurulur.
  - Mood/energy secimleri light, sade ve form odakli olur.

Kabul kriteri:

- Mock data yerine gercek veriler kullanilir.
- Her modulde liste, ekleme, duzenleme ve temel silme/arsivleme vardir.
- Bos durumlar kullaniciyi dogru aksiyona yonlendirir.
- Faz 2 kapsamindaki her yeni/yenilenen modul Poyraz UI bilesenleriyle yazilir.

---

## Proje Detay MVP Planı

Bu bölüm, Faz 2 içindeki Projeler/Side Project modülünün görev takibinden daha geniş bir proje yönetim alanına dönüşmesi için detaylı uygulama planıdır.

### 1. Liste ve Oluşturma

Amaç: Kullanıcı projeyi hızlıca oluşturabilsin ve görsel kimliğini ilk anda belirleyebilsin.

Alanlar:

- Proje adı
- Tür: müşteri projesi veya side project
- Bağlı müşteri
- Kapak görseli
- Kapak görseli alt metni
- Kısa açıklama
- Durum
- Başlangıç tarihi
- Deadline
- Bütçe / beklenen gelir
- İlerleme yüzdesi

Davranış:

- Görsel bilgisayardan seçilir ve `project-assets` bucket'ına yüklenir.
- Görsel yolu `projects.cover_image_path` alanında saklanır.
- Görsel link ile ekleme MVP akışı değildir.
- Görsel yüklenmezse proje kartında sade placeholder gösterilir.

### 2. Proje Detay Sayfası

Amaç: Proje ile ilgili görev dışı tüm planlama bilgisini tek merkezde yönetmek.

Route önerisi:

- `/projects/[id]`

Ana bölümler:

- Özet
- Planlama
- Design system
- Görevler
- Finans bağlantıları
- Zaman çizelgesi

İlk MVP için zorunlu bölümler:

- Özet
- Planlama
- Design system
- Görevler

### 3. Özet Bölümü

İçerik:

- Kapak görseli
- Proje adı
- Müşteri veya side project etiketi
- Durum
- İlerleme
- Deadline
- Bütçe
- Kısa açıklama

Amaç:

- Kullanıcı projeye girdiğinde projenin ne olduğunu ve hangi durumda olduğunu ilk bakışta anlar.

### 4. Planlama Bölümü

Bu bölüm `project_planning_sections` tablosundan beslenir.

MVP kategorileri:

- Genel bakış (`overview`)
- Çözdüğü problem (`problem`)
- Amaç (`goal`)
- Hedef kitle (`audience`)
- Kapsam (`scope`)
- Notlar (`notes`)

Her kategori için:

- Başlık
- Açıklama / içerik
- Sıralama
- Opsiyonel metadata

Kullanım:

- Kullanıcı kategori ekleyebilir.
- Kullanıcı kategori düzenleyebilir.
- Kullanıcı kategori silebilir.
- Kategoriler proje detayında ayrı kartlar halinde gösterilir.

### 5. Design System Bölümü

Bu bölüm de `project_planning_sections` tablosunu kullanır.

MVP kategorileri:

- Design system (`design_system`)
- Renk paleti (`color_palette`)
- Tipografi (`typography`)
- Görsel varlıklar (`assets`)

Design system alanları:

- Genel görsel dil
- Kullanılacak UI kit veya referans sistem
- Component notları
- Spacing / radius / shadow notları

Renk paleti alanları:

- Renk adı
- Hex değeri
- Kullanım rolü: primary, secondary, accent, background, text, border
- Not

Tipografi alanları:

- Font ailesi
- Başlık kullanımı
- Gövde metni kullanımı
- Boyut/hiyerarşi notları

MVP yaklaşımı:

- İlk sürümde renk paleti ve tipografi structured JSON metadata içinde tutulabilir.
- UI tarafında bu metadata sade form alanlarıyla düzenlenir.
- Gerekirse MVP sonrası `project_colors` ve `project_typography_tokens` gibi ayrı tablolara bölünebilir.

### 6. Görevler Bölümü

Amaç:

- Projeye bağlı görevleri proje detayından da yönetebilmek.

MVP kapsamı:

- Projeye bağlı görevleri listeleme
- Yeni görev ekleme
- Görev durumunu güncelleme
- Görevi tamamlandı işaretleme

Bu bölüm görev modülüyle aynı veriyi kullanır; ayrı bir görev sistemi kurulmaz.

### 7. Görsel Varlık Yönetimi

MVP kapsamı:

- Proje kapak görseli yükleme
- Kapak görselini değiştirme
- Kapak görseli alt metni düzenleme

MVP dışı:

- Çoklu dosya klasör yapısı
- Versiyonlama
- Dosya yorumları
- Gelişmiş medya kütüphanesi

Storage kuralı:

- Bucket: `project-assets`
- Path: `<user_id>/projects/<project_id>/<file_name>`
- Bucket private olur.
- Uygulama görsel gösterirken signed URL üretir.

### 8. Uygulama Sırası

1. Database migration: `0003_add_project_planning_assets.sql`
2. Proje formuna kapak görseli yükleme alanı ekle
3. Proje kartlarında kapak görseli göster
4. `/projects/[id]` detay sayfasını oluştur
5. Proje detay özet bölümünü gerçek veriyle kur
6. `project_planning_sections` CRUD action'larını ekle
7. Planlama bölümü kartlarını ekle
8. Design system bölümünü ekle
9. Projeye bağlı görevler bölümünü detay sayfasına bağla
10. Dashboard raporlarında design system/problem/amaç eksikliği gibi proje sağlık sinyallerini kullan

### 9. Kabul Kriterleri

- Kullanıcı proje oluştururken bilgisayarından kapak görseli yükleyebilir.
- Proje kartında ve detay sayfasında kapak görseli görünür.
- Kullanıcı proje detayında görevler dışında proje planlama alanlarını yönetebilir.
- Kullanıcı design system, renk paleti ve tipografi notlarını ekleyebilir.
- Tüm veriler kullanıcı bazlı RLS ile korunur.
- `npm run build` başarılı olur.

---

### Faz 3: Dashboard ve Raporlama

Amac: Girilen verileri anlamli grafiklere ve rapor kartlarina donusturmek.

Isler:

- Dashboard KPI kartlari
- Gorev tamamlama grafikleri
- Proje ilerleme grafikleri
- Musteri/proje bazli gelir ozeti
- Gelir/gider/net kazanc grafigi
- Mood/energy trendleri
- Yaklasan deadline ve odeme listeleri

Kabul kriteri:

- Dashboard tamamen gercek veriden beslenir.
- Her MVP modulu en az bir anlamli rapor/grafik sunar.
- Tarih filtresi: bugun, bu hafta, bu ay.

---

### Faz 4: Basit AI Chatbot

Amac: Kullanici kendi freelancer verileri hakkinda soru sorabilsin.

Isler:

- Chat UI'i stabil hale getirmek.
- Provider secimi: Ollama, OpenAI, Gemini, Groq.
- Son 7/30 gun verilerinden context builder yazmak.
- Chat mesajlarini kaydetmek.
- AI cevaplarini "danisma/asistan" sinirinda tutmak.

Kabul kriteri:

- Kullanici kayitli verileri hakkinda soru sorabilir.
- Chatbot en az gorev, proje, musteri, finans ve daily log ozetlerini context olarak kullanir.
- AI calismasa bile uygulamanin temel modulleri calismaya devam eder.

---

### Faz 5: Self-host Hazirligi

Amac: Projeyi acik kaynak ve self-host edilebilir hale getirmek.

Isler:

- `.env.example` hazirlamak.
- Kurulum dokumani yazmak.
- Migration calistirma adimlarini belgelemek.
- Docker Compose opsiyonunu degerlendirmek.
- Demo kullanici/demo data akisi eklemek.

Kabul kriteri:

- Yeni bir gelistirici dokumana bakarak projeyi ayaga kaldirabilir.
- Harici AI servisleri opsiyonel kalir.
- Local Ollama ile temel AI deneyimi mumkundur.

---

## MVP Sonrasi Fazlar

### Faz 6: Freelancer Business OS

- Teklifler
- Sozlesmeler
- Fatura olusturma
- Odeme takip otomasyonlari
- Vergi/kar tahmini
- Abonelik ve masraf yonetimi

### Faz 7: Gelismis CRM

- Lead pipeline
- Musteri aktiviteleri
- Follow-up hatirlatmalari
- Musteri degeri ve risk raporlari

### Faz 8: Gelismis AI

- Embedding tabanli RAG
- Modul ici AI onerileri
- Akilli onceliklendirme
- Finansal yorumlama
- Takvim optimizasyonu
- Proje risk tahmini

### Faz 9: Mobil ve Sync

- Mobil uygulama
- Offline cache
- Push notification
- Takvim ve gorev sync
- Local-first deneyim iyilestirmeleri

---

## MVP Basari Kriterleri

MVP basarili sayilirsa:

- Freelancer gunluk islerini, musterilerini, projelerini, side project'lerini ve temel finansini tek yerde takip edebilir.
- Dashboard gercek verilerle anlamli haftalik/aylik raporlar sunar.
- Kullanici uygulamayi self-host edebilir.
- AI chatbot opsiyonel ama kullanisli bir danisma katmani olarak calisir.
- Uygulama tek kullanici icin guvenilir ve build edilebilir durumdadir.