chore: remove redundant project documentation and database schema files

2026-06-09 00:27:17 +03:00
parent efb4f1bfae
commit 5ca5d0eac0
10 changed files with 0 additions and 1677 deletions
@@ -1,884 +0,0 @@
-# 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.
@@ -1,60 +0,0 @@
-# 0001 Initial Schema
-
-SQL file: `supabase/schema.sql`
-
-## Purpose
-
-This is the first registered database query file for the project. It represents the schema that existed before the Freelancer OS MVP planning work started.
-
-## What It Creates
-
- `journals`
- `tasks`
- `chat_sessions`
- `chat_messages`
- `profiles`
- Row Level Security policies for the tables above
- `handle_new_user()` trigger function for profile creation
- `on_auth_user_created` trigger
- `avatars` storage bucket and related storage policies
-
-## Current Product Fit
-
-This schema supports the earlier MindSpace/Cognis prototype:
-
- mood/energy journals
- basic tasks
- chat history
- user profile storage
- avatar uploads
-
-It does not yet fully match the Freelancer OS MVP model.
-
-## Known Gaps For MVP
-
-The Freelancer OS MVP still needs new schema additions for:
-
- `clients`
- `projects`
- `calendar_events`
- `finance_transactions`
- `daily_logs`
- `app_settings`
-
-The existing `journals` table can either be migrated into `daily_logs` or kept as a legacy table until the UI is moved to the new model.
-
-## Execution Notes
-
-This file should be treated as the first baseline.
-
-It was updated to be safer for Supabase SQL Editor retries:
-
- tables use `create table if not exists`
- policies are dropped before being recreated
- the profile trigger is dropped before being recreated
- the PL/pgSQL function uses the correct `$$` delimiter
- profile creation uses `on conflict (id) do nothing`
-
-If a previous run failed halfway through, rerunning this baseline should be safe for the current schema shape.
-
-Future changes should be added as ordered migration files rather than editing this baseline after execution.
@@ -1,72 +0,0 @@
-# 0002 Freelancer OS Core Tables
-
-SQL file: `supabase/migrations/0002_add_freelancer_os_core_tables.sql`
-
-## Purpose
-
-Adds the database model required for the Freelancer OS MVP.
-
-This migration keeps the existing baseline from `supabase/schema.sql` and extends it instead of replacing it. The existing `tasks` table is reused and enriched with freelancer-specific fields.
-
-## What It Creates
-
- `clients`
- `projects`
- `calendar_events`
- `finance_transactions`
- `daily_logs`
- `app_settings`
- `set_updated_at()` trigger function
- updated-at triggers for the new tables
- indexes for common dashboard/report queries
- RLS policies for every new table
-
-## What It Changes
-
-The existing `tasks` table gets these additional columns:
-
- `client_id`
- `project_id`
- `priority`
- `due_at`
- `estimated_minutes`
- `actual_minutes`
-
-This lets a task belong to a client and/or project while preserving the earlier journal/task prototype schema.
-
-## MVP Coverage
-
-This migration supports:
-
- client management
- client projects
- side projects
- task planning
- calendar planning
- income and expense tracking
- daily mood/energy logging
- app and AI provider settings
-
-## RLS Model
-
-Every new table has `user_id`.
-
-Policies follow the same pattern:
-
- users can select their own rows
- users can insert rows only for themselves
- users can update their own rows
- users can delete their own rows
-
-## Notes
-
-`app_settings.api_key` exists for compatibility with the current prototype flow. For production-grade use, provider credentials should be encrypted or moved to a safer secret-management strategy.
-
-`daily_logs` is the new MVP-oriented replacement for the earlier `journals` concept. The old `journals` table remains available until the UI migration is complete.
-
-## Execution
-
-Run this after `supabase/schema.sql`.
-
-Do not add this file to `query-log.md` until it has actually been executed against a database.
-
@@ -1,92 +0,0 @@
-# 0003 - Project Planning Assets
-
-SQL file: `supabase/migrations/0003_add_project_planning_assets.sql`
-
-## Purpose
-
-This migration extends project management beyond task tracking.
-
-It adds:
-
- Project cover image fields on `projects`
- A private Supabase Storage bucket for uploaded project images
- A structured `project_planning_sections` table for project planning categories
-
-## Project Image Fields
-
-The `projects` table receives:
-
- `cover_image_path`: path of the uploaded file in the `project-assets` bucket
- `cover_image_alt`: optional alt text for the cover image
-
-Images are uploaded from the user's computer, not saved as external image links.
-
-## Storage Bucket
-
-Bucket:
-
- `project-assets`
-
-Configuration:
-
- Private bucket
- Max file size: 5 MB
- Allowed MIME types:
-  - `image/jpeg`
-  - `image/png`
-  - `image/webp`
-  - `image/gif`
-
-Storage object paths must start with the authenticated user id:
-
-```txt
-<user_id>/projects/<project_id>/<file_name>
-```
-
-This keeps Storage RLS simple and user-scoped.
-
-## Planning Sections
-
-Table:
-
- `project_planning_sections`
-
-Core fields:
-
- `user_id`
- `project_id`
- `category`
- `title`
- `content`
- `metadata`
- `sort_order`
-
-Allowed categories:
-
- `overview`
- `problem`
- `goal`
- `audience`
- `scope`
- `design_system`
- `color_palette`
- `typography`
- `assets`
- `notes`
-
-## RLS
-
-RLS is enabled for `project_planning_sections`.
-
-Users can only select, insert, update, and delete their own planning sections.
-
-Storage policies allow users to select, upload, update, and delete only files under their own user id folder inside `project-assets`.
-
-## Execution
-
-Run after:
-
-1. `supabase/schema.sql`
-2. `supabase/migrations/0002_add_freelancer_os_core_tables.sql`
-
-After running this SQL in Supabase, add an execution record to `docs/database/query-log.md`.
@@ -1,34 +0,0 @@
-# 0009 - Lock Registration After First Admin
-
-SQL file:
-
-`supabase/migrations/0009_lock_registration_after_first_admin.sql`
-
-## Purpose
-
-Adds the first-time setup guard for self-hosted installations.
-
-The `/register` page is only available while the system has no profile record. After the first account creates a profile, public registration is closed.
-
-## Changes
-
- Adds `public.is_first_admin_setup_available()`.
- Grants the function to `anon` and `authenticated` roles so the app can check setup state safely without bypassing RLS manually.
- Replaces `public.handle_new_user()` so direct public Supabase Auth signup attempts are also rejected after the first profile exists.
- Allows service-role/admin-created users when `raw_app_meta_data.internal_created` is `true`, so future invite/client-portal flows can still create accounts intentionally.
-
-## Behavior
-
-1. Fresh install has no `public.profiles` rows.
-2. `/register` stays open.
-3. The first signup creates an auth user and the trigger creates the first profile.
-4. The setup function starts returning `false`.
-5. `/register` redirects to `/login`.
-6. Further public signup attempts fail at the database trigger level.
-7. Admin-created internal users can still be allowed by service-role flows that set `app_metadata.internal_created = true`.
-
-## Notes
-
- This is intended for the MVP single-admin self-host model.
- If multi-user, client portal accounts, invites, or team members are re-enabled later, keep them behind service-role/admin-created flows instead of public signup.
- Do not add this SQL file to `query-log.md` until it has actually been run in the target Supabase environment.
@@ -1,44 +0,0 @@
-# Database Change Process
-
-This directory records every database change that should be run against Supabase/PostgreSQL.
-
-The project currently starts with `supabase/schema.sql` as the first database query file. Future database changes must be added as separate SQL files and registered here before they are run.
-
-## Rules
-
-1. Every SQL change must have a stable order number.
-2. Every SQL file must be listed in `query-order.md`.
-3. Every executed query must be recorded in `query-log.md`.
-4. Every meaningful schema addition must have a short documentation file under this directory.
-5. Do not edit an already executed SQL file silently. Add a new ordered SQL file instead.
-
-## Current Files
-
- `supabase/schema.sql`: Initial legacy schema. It creates the current auth/profile, journal, task, chat, and avatar storage structure.
- `supabase/migrations/0002_add_freelancer_os_core_tables.sql`: Freelancer OS MVP core schema.
- `supabase/seeds/0001_demo_freelancer_os_data.sql`: Optional local/demo data for the MVP schema.
- `docs/database/0001-initial-schema.md`: Explanation for the initial schema.
- `docs/database/0002-freelancer-os-core-tables.md`: Explanation for the MVP schema migration.
- `docs/database/seed-0001-demo-freelancer-os-data.md`: Explanation for the demo seed file.
- `docs/database/query-order.md`: Canonical order of SQL files.
- `docs/database/query-log.md`: Manual execution log for SQL files that were run against an environment.
-
-## Next Migration Naming
-
-Use this pattern for future SQL files:
-
-```text
-supabase/migrations/0002_short_description.sql
-```
-
-Example:
-
-```text
-supabase/migrations/0002_add_freelancer_os_core_tables.sql
-```
-
-Use this pattern for future seed files:
-
-```text
-supabase/seeds/0002_short_description.sql
-```
@@ -1,10 +0,0 @@
-# Database Query Log
-
-This file records SQL files that were executed against a database environment.
-
-Do not mark a query as executed unless it was actually run.
-
-| Date | Environment | Order | SQL file | Runner | Result | Notes |
-| --- | --- | --- | --- | --- | --- | --- |
-| Not recorded | Unknown existing environment | 0001 | `supabase/schema.sql` | Unknown | Assumed existing baseline | File existed before this query log was introduced. Confirm manually before rerunning. |
-
@@ -1,25 +0,0 @@
-# Database Query Order
-
-This file is the canonical order of SQL files for database setup and migration.
-
-| Order | SQL file | Documentation | Status |
-| --- | --- | --- | --- |
-| 0001 | `supabase/schema.sql` | `docs/database/0001-initial-schema.md` | Baseline registered |
-| 0002 | `supabase/migrations/0002_add_freelancer_os_core_tables.sql` | `docs/database/0002-freelancer-os-core-tables.md` | Pending execution |
-| 0003 | `supabase/migrations/0003_add_project_planning_assets.sql` | `docs/database/0003-project-planning-assets.md` | Pending execution |
-| 0009 | `supabase/migrations/0009_lock_registration_after_first_admin.sql` | `docs/database/0009-lock-registration-after-first-admin.md` | Pending execution |
-| seed-0001 | `supabase/seeds/0001_demo_freelancer_os_data.sql` | `docs/database/seed-0001-demo-freelancer-os-data.md` | Optional demo seed, pending execution |
-
-## How To Add The Next Query
-
-1. Create a new SQL file under `supabase/migrations/`.
-2. Use the next order number.
-3. Add a documentation file under `docs/database/`.
-4. Register both files in this table.
-5. After running the SQL, add an entry to `query-log.md`.
-
-## Seed Files
-
-Seed files are optional and should live under `supabase/seeds/`.
-
-They must also be documented and registered in this file, but they should only be run in local/demo environments unless explicitly approved.
@@ -1,43 +0,0 @@
-# Seed 0001 Demo Freelancer OS Data
-
-SQL file: `supabase/seeds/0001_demo_freelancer_os_data.sql`
-
-## Purpose
-
-Adds demo data for local development and dashboard testing after the Freelancer OS core tables are created.
-
-## What It Inserts
-
- demo clients
- demo projects and one side project
- demo tasks
- demo calendar events
- demo finance transactions
- demo daily mood/energy logs
- demo `app_settings`
-
-## Required Manual Step
-
-Before running the file, replace this placeholder with a real `auth.users.id`:
-
-```sql
-'00000000-0000-0000-0000-000000000000'::uuid
-```
-
-Use a user id from your Supabase Auth users table.
-
-## Environment
-
-This seed is intended for local and demo environments only.
-
-Do not run it on production data.
-
-## Execution
-
-Run after:
-
-1. `supabase/schema.sql`
-2. `supabase/migrations/0002_add_freelancer_os_core_tables.sql`
-
-After running it, add an entry to `docs/database/query-log.md`.
-
@@ -1,413 +0,0 @@
-# Poyraz UI - Usage Guide (Detayli)
-
-Bu dokuman, `d:/Poyraz/kodlama/poyraz-ui` reposunun guncel kaynak kodu uzerinden hazirlandi.
-Hedef: UI kitin hem kullanici (consumer) tarafini hem de bu repoyu gelistirme tarafini tek yerde toplamak.
-
-Versiyon referansi: `2.0.1`
-
---
-
-## 1) Proje Ozeti
-
-Poyraz UI, React tabanli, Tailwind CSS v4 ile calisan, atomic design yaklasimi kullanan bir UI kit.
-Repo iki ana amaca hizmet ediyor:
-
-1. npm paketi olarak dagitilan UI kutuphanesi (`src`, `components/ui`, `dist`)
-2. Next.js App Router ile yazilmis canli dokumantasyon sitesi (`app`)
-
-Temel karakter:
-
- clean border odakli, minimum shadow
- `rounded-sm` kullanimina dayali yalin gorunum
- semantic token sistemi (`--poyraz-*`)
- dark mode uyumlu
- atoms -> molecules -> organisms katmanlamasi
-
---
-
-## 2) Dizin Yapisi (Gercek Kod Yapisi)
-
-```txt
-poyraz-ui/
-|- app/                    # Next.js docs sitesi
-|  |- docs/                # component/template dokumantasyon sayfalari
-|  |- globals.css          # docs sitesi global css + dark override
-|  |- layout.tsx           # next-themes + Toaster entegrasyonu
-|  `- page.tsx             # landing/showcase
-|- bin/
-|  `- cli.mjs              # npx poyraz-ui init
-|- components/
-|  |- ui/
-|  |  |- atoms/            # 17 atom dosyasi
-|  |  |- molecules/        # 22 molecule dosyasi
-|  |  `- organisms/        # 5 organism dosyasi
-|  |- theme-provider.tsx   # docs sitesi next-themes wrapper
-|  `- theme-toggle.tsx     # docs sitesi toggle
-|- lib/
-|  `- navigation.ts        # docs nav/registry merkezi config
-|- src/
-|  |- index.ts             # ana export
-|  |- atoms/index.ts       # atom export map
-|  |- molecules/index.ts   # molecule export map
-|  |- organisms/index.ts   # organism export map
-|  |- themes/index.ts      # poyrazLightTheme / poyrazDarkTheme
-|  |- preset.css           # token layer + @theme bridge
-|  `- utils.ts             # cn()
-|- dist/                   # tsup output (publish edilen paket)
-|- tsup.config.ts          # 5 entry point, esm+cjs, dts
-`- package.json
-```
-
---
-
-## 3) Kullanici Tarafi Kurulum (Consumer App)
-
-### 3.1 Paket kurulumu
-
-```bash
-pnpm add poyraz-ui
-# veya
-npm install poyraz-ui
-# veya
-yarn add poyraz-ui
-```
-
-### 3.2 Zorunlu peer dependencies
-
- `react >= 18`
- `react-dom >= 18`
- `tailwindcss >= 4`
-
-Opsiyonel peer dependencies:
-
- `react-hook-form`, `@hookform/resolvers`, `zod` (Form molecule icin)
- `reactive-switcher` (hazir theme objectleriyle dinamik tema gecisi icin)
-
-### 3.3 CSS import (kritik)
-
-Root global stylesheet dosyana ekle:
-
-```css
-@import "tailwindcss";
-@import "poyraz-ui/preset.css";
-```
-
-`preset.css` olmadan renk/font tokenlari dogru resolve edilmez.
-
-### 3.4 Hemen kullanim
-
-```tsx
-import { Button, Card, CardContent } from "poyraz-ui/atoms";
-
-export function Demo() {
-  return (
-    <Card>
-      <CardContent className="p-4">
-        <Button>Merhaba</Button>
-      </CardContent>
-    </Card>
-  );
-}
-```
-
---
-
-## 4) Import Stratejisi ve Entry Pointler
-
-Paket 5 entry point sunuyor:
-
- `poyraz-ui`
- `poyraz-ui/atoms`
- `poyraz-ui/molecules`
- `poyraz-ui/organisms`
- `poyraz-ui/themes`
-
-Onerilen yaklasim:
-
- Uretim projelerinde alt path importlarini kullan (`/atoms`, `/molecules`, `/organisms`)
- Gecis surecinde hiz icin ana barrel (`poyraz-ui`) kullanabilirsin
-
-Ornek:
-
-```tsx
-import { Button, Badge } from "poyraz-ui/atoms";
-import { Dialog } from "poyraz-ui/molecules";
-import { Navbar } from "poyraz-ui/organisms";
-import { poyrazLightTheme, poyrazDarkTheme } from "poyraz-ui/themes";
-```
-
---
-
-## 5) Tema Sistemi (En Onemli Altyapi)
-
-Tema zinciri su sekilde calisiyor:
-
-1. Component classlari `bg-background`, `text-foreground`, `border-border` gibi semantic utility kullaniyor.
-2. `src/preset.css`, `@theme` ile bunlari `--color-*` tokenlarina bagliyor.
-3. `--color-*` tokenlari, `var(--poyraz-*, fallback)` ile semantic CSS variable'a mapleniyor.
-4. Sen `--poyraz-*` degistirdiginde tum kit yeni temaya gecer.
-
-### 5.1 Token katmanlari
-
- Base semantic variables: `--poyraz-background`, `--poyraz-foreground`, `--poyraz-primary`, ...
- Tailwind v4 bridge: `--color-background`, `--color-foreground`, ...
- Utility kullanim: `bg-background`, `text-muted-foreground`, ...
-
-### 5.2 Dark mode (class tabanli)
-
-Docs sitesi `next-themes` kullaniyor ve `html.dark` altinda `--poyraz-*` override ediyor (`app/globals.css`).
-
-### 5.3 reactive-switcher entegrasyonu
-
-`src/themes/index.ts` icinde hazir theme objectleri var:
-
- `poyrazLightTheme`
- `poyrazDarkTheme`
- `poyrazThemes`
-
-Ornek:
-
-```tsx
-import { ThemeProvider } from "reactive-switcher";
-import { poyrazThemes } from "poyraz-ui/themes";
-
-export function AppTheme({ children }: { children: React.ReactNode }) {
-  return <ThemeProvider themes={poyrazThemes}>{children}</ThemeProvider>;
-}
-```
-
---
-
-## 6) Component Katalogu
-
-Bu bolum `src/*/index.ts` export maplerine gore hazirlandi.
-
-### 6.1 Atoms (17 component dosyasi)
-
- Avatar
- Badge
- Button
- Card
- Checkbox
- Input
- Label
- Logo
- Radio Group
- Separator
- Skeleton
- Switch
- Textarea
- Typography
- Form Fields (`NumberInput`, `SearchInput`, `PhoneInput`, `PasswordInput`, `UrlInput`)
- BG Patterns (`PatternDots`, `PatternGrid`, `PatternLines`, `PatternDiagonal`, `PatternCross`, `PatternCheckerboard`, `PatternDiamond`, `PatternZigzag`, `PatternDashedGrid`, `PatternRadial`)
- ScrollArea
-
-### 6.2 Molecules (22 component dosyasi)
-
-Core molecules:
-
- Accordion
- Alert
- Autocomplete
- Breadcrumb
- Calendar
- Command Palette
- Date Picker
- Dialog
- Drawer
- Dropdown Menu
- Form
- Hover Card
- Modal
- Pagination
- Popover
- Select
- Sheet
- Sonner (`Toaster`, `toast`)
- Tabs
- Tooltip
-
-Template molecules (card-templates):
-
- ArticleCard
- ImageCard
- NewsCard
- StatsCard
- TestimonialCard
- PricingCard
- ProductCard
-
-### 6.3 Organisms (5 component dosyasi)
-
- Navbar
- Sidebar
- Footer
- AnnouncementBar
- DataTable
-
---
-
-## 7) Hazir Template Sayfalari (Docs Icinde)
-
-`app/docs/templates` altinda 4 kopyalanabilir sayfa semasi var:
-
- Hero
- Pricing
- Dashboard
- Auth
-
-Onemli not:
-
- Bunlar npm paketi icinde "template component" olarak export edilmiyor.
- Kaynagi kopyalayip projenin ihtiyacina gore duzenleme modeli kullaniliyor.
-
---
-
-## 8) Dokumantasyon Sitesi Mimarisi
-
-`app/docs` altinda:
-
- toplam `53` adet `page.tsx`
- atoms: `18`
- molecules: `22`
- organisms: `6`
- templates: `5`
-
-Merkezi nav/registry:
-
- `lib/navigation.ts`
- sidebardaki kategori sayilari ve slug donusumu burada yonetiliyor (`toSlug`)
-
---
-
-## 9) CLI: `npx poyraz-ui init`
-
-CLI (`bin/cli.mjs`) su adimlari yapar:
-
-1. CSS dosyasini otomatik tespit eder (`app/globals.css`, `src/app/globals.css` vb.)
-2. `@import "poyraz-ui/preset.css";` satirini ekler
-3. Opsiyonel olarak `reactive-switcher` tema dosyasi scaffold eder
-4. Layout icin ThemeProvider snippet'i gosterir
-
-Manual kurulum yerine hizli onboarding icin ideal.
-
---
-
-## 10) Build, Bundle ve Publish Akisi
-
-### 10.1 Scriptler
-
- `pnpm dev`: docs sitesi
- `pnpm build`: library + docs production build
- `pnpm build:lib`: sadece library (`tsup`)
- `pnpm start`: next production serve
- `pnpm prepublishOnly`: publish oncesi otomatik `build:lib`
-
-### 10.2 tsup ozeti
-
-`tsup.config.ts`:
-
- 5 entry point uretir (`index`, `atoms/index`, `molecules/index`, `organisms/index`, `themes/index`)
- format: `esm + cjs`
- `dts: true`
- `splitting + treeshake + clean`
- build sonrasi `dist` dosyalarina `"use client"` directive inject eder
-
-### 10.3 package export haritasi
-
-`package.json` `exports` alani:
-
- alt path importlarini hem ESM hem CJS ile aciklar
- `./preset.css` dogrudan `src/preset.css`'e yonlenir
-
---
-
-## 11) Bu Repoda Yeni Component Ekleme Rehberi
-
-### 11.1 Kod ekleme
-
-1. Component dosyasini `components/ui/<layer>/` altina ekle
-2. Gerekirse type exportlarini component dosyasinda tanimla
-
-### 11.2 Export haritasi
-
-3. `src/<layer>/index.ts` icine export satirlarini ekle
-4. Gerekliyse `src/index.ts` ana barrel kontrol et
-
-### 11.3 Docs entegrasyonu
-
-5. `app/docs/<layer>/<component>/page.tsx` olustur
-6. Kategori index sayfasina link ekle (`app/docs/<layer>/page.tsx`)
-7. `lib/navigation.ts` icindeki `componentRegistry` listesine ekle
-
-### 11.4 Dogrulama
-
-8. `pnpm build:lib`
-9. `pnpm dev` ile docs sayfasini ve importlarini test et
-
---
-
-## 12) Sik Kullanilan Kullanim Patternleri
-
-### 12.1 Form stack
-
- Atoms: `Input`, `Label`, `Checkbox`, `Button`
- Molecules: `Form`, `Select`, `DatePicker`, `Autocomplete`
-
-### 12.2 Overlay stack
-
- `Dialog`, `Modal`, `Drawer`, `Sheet`, `Popover`, `Tooltip`
- Her biri Radix/Vaul primitive uzerinden geldigi icin a11y ve keyboard destegi yuksek
-
-### 12.3 Navigation stack
-
- `Navbar` (desktop + mobile panel)
- `Sidebar` (collapsible/floating/mini varyantlar)
- `Footer` (layout varyantlari)
-
-### 12.4 Data stack
-
- `DataTable` + `Badge` + `Pagination`
- dashboard tarzinda `StatsCard`, `Card`, `Avatar` ile birlikte kullaniliyor
-
---
-
-## 13) Bilinen Durumlar / Dikkat Noktalari
-
-1. `Mermaid` dokumantasyon sayfasi var (`app/docs/molecules/mermaid/page.tsx`) ancak su anda `src/molecules/index.ts` icinden export edilmiyor.
-2. `componentRegistry` molecules listesi ile molecules landing page listesi tam birebir degil (sidebar listesinde Mermaid yok).
-3. Template sayfalari (Hero/Pricing/Dashboard/Auth) paket exportu degil; kopyala-ozellestir modeli.
-4. Rehber ve README metinlerinde bilesen sayilari bazen farkli geciyor; son karar noktasi her zaman `src/*/index.ts` export mapidir.
-
---
-
-## 14) Hizli Referans
-
-### 14.1 Consumer app checklist
-
-1. `poyraz-ui` paketini kur
-2. `@import "poyraz-ui/preset.css";` ekle
-3. `poyraz-ui/atoms` veya `poyraz-ui/molecules` uzerinden import et
-4. Tema gerekiyorsa `--poyraz-*` override et veya `poyraz-ui/themes` kullan
-
-### 14.2 Repo contributor checklist
-
-1. component dosyasi ekle (`components/ui`)
-2. export map guncelle (`src/*/index.ts`)
-3. docs page ekle (`app/docs/...`)
-4. navigation registry guncelle (`lib/navigation.ts`)
-5. `pnpm build:lib` ve `pnpm dev` ile dogrula
-
---
-
-## 15) Ek Kaynaklar
-
- Paket genel tanitim: `README.md`
- Genis API referansi: `COMPONENTS.md`
- Theme switcher notlari: `theme-switcher.md`
- Kurulum sayfasi referansi: `app/docs/installation/page.tsx`
-
---
-
-Bu dokuman "proje ici operasyonel guide" amaciyla yazildi.
-Paketin public-facing README'sini sade tutup, bu dosyayi teknik detay merkezi olarak kullanman tavsiye edilir.