📁 Klasör Yapısı v2: Yıl/Ay/Gün

📅 Tarih: 2025-11-18 | 🎯 Amaç: Karışıklığı önleyen, temiz klasör organizasyonu | 📌 Versiyon: v4 (Final)

🔴 Mevcut Sorunlar

❌ Sorun 1: TODO dosyaları yanlış yerde

TODO dosyaları HTML klasörü içine oluşturuluyordu!

❌ YANLIŞ: public/readme/2025-11-18/html-versiyon-sistemi/todo-payment.md ✅ DOĞRU: readme/claude-docs/todo-2025-11-18-14-30-payment.md

❌ Sorun 2: Tarih klasörleri karışık

Tüm dosyalar tek bir YYYY-MM-DD klasöründe, aylar ve yıllar karışıyor!

❌ YANLIŞ: public/readme/2025-11-17/... public/readme/2025-11-18/... public/readme/2025-11-19/... public/readme/2025-12-01/... ← Kasım ile Aralık aynı seviyede!

✅ Yeni Çözüm: Hiyerarşik Klasör Yapısı

🎯 Yıl → Ay → Gün → Konu → Versiyon

Her seviyede daha organize, daha temiz, daha kolay takip!

public/readme/ ├── 2025/ ← Yıl (seviye 1) │ ├── 11/ ← Ay (seviye 2) │ │ ├── 17/ ← Gün (seviye 3) │ │ │ ├── blog-analiz/ ← Konu (seviye 4) │ │ │ │ ├── v1/ │ │ │ │ │ └── index.html │ │ │ │ ├── v2/ │ │ │ │ │ └── index.html │ │ │ │ └── index.html ← Sembolik link (v2'ye işaret eder) │ │ │ └── seo-plani/ │ │ │ └── v1/ │ │ │ └── index.html │ │ └── 18/ ← Gün (seviye 3) │ │ ├── html-versiyon-sistemi/ │ │ │ ├── v1/ │ │ │ ├── v2/ │ │ │ └── index.html │ │ └── blog-detay-redesign/ │ │ └── v1/ │ │ └── index.html │ └── 12/ ← Aralık ayı │ └── 01/ │ └── payment-integration/ └── 2026/ ← Gelecek yıl └── 01/

📋 Yeni Klasör Kuralları

❌ Eski Sistem

public/readme/2025-11-18/blog-analiz/ public/readme/2025-11-19/seo-plani/ public/readme/2025-12-01/payment/ Sorun: - Tüm günler aynı seviyede - Aylar karışık - Uzun path'ler

✅ Yeni Sistem

public/readme/2025/11/18/blog-analiz/ public/readme/2025/11/19/seo-plani/ public/readme/2025/12/01/payment/ Avantaj: - Yıl → Ay → Gün hiyerarşi - Aylar organize - Kısa path'ler

🎯 HTML ve MD Ayrımı

HTML Raporlar (Analiz, Plan, Sunum)

Konum: public/readme/[YYYY]/[MM]/[DD]/[ana-konu]/[versiyon]/index.html Örnek: public/readme/2025/11/18/blog-analiz/v1/index.html public/readme/2025/11/18/blog-analiz/v2/index.html public/readme/2025/11/18/blog-analiz/index.html → v2 URL: https://ixtif.com/readme/2025/11/18/blog-analiz/

MD Dosyalar (Sadece TODO)

Konum: readme/claude-docs/todo/[YYYY]/[MM]/[DD]/todo-[HH-MM]-[konu].md Örnek: readme/claude-docs/todo/2025/11/18/todo-14-30-payment-fix.md readme/claude-docs/todo/2025/11/18/todo-15-00-blog-ai.md NOT: MD dosyaları ASLA public/ altında değil!

📊 URL Yapısı Karşılaştırma

❌ Eski URL

https://ixtif.com/readme/2025-11-18/blog-analiz/ Sorun: - Uzun tarih formatı - Okunması zor - Aylar dağınık

✅ Yeni URL

https://ixtif.com/readme/2025/11/18/blog-analiz/ Avantaj: - Kısa ve net - Okunması kolay - Hiyerarşik

🔧 Klasör Oluşturma Mantığı

1. HTML Rapor İstendi: ├─ Tarih al: 2025-11-18 ├─ Ayır: YYYY=2025, MM=11, DD=18 ├─ Konu belirle: blog-analiz │ ├─ Klasör kontrolü: │ └─ public/readme/2025/11/18/blog-analiz/ VAR mı? │ │ │ ├─ EVET → Son versiyonu bul (v1, v2...), +1 ekle → v3 oluştur │ │ │ └─ HAYIR → v1 oluştur │ └─ Oluştur: public/readme/2025/11/18/blog-analiz/v3/index.html 2. TODO İstendi: ├─ Tarih al: 2025-11-18 14:30 ├─ Ayır: YYYY=2025, MM=11, DD=18, HH=14, MM=30 ├─ Konu belirle: payment-fix │ └─ Oluştur: readme/claude-docs/todo/2025/11/18/todo-14-30-payment-fix.md

✅ Pratik Örnekler

Senaryo 1: Kullanıcı "Blog modülünü analiz et" dedi

1. Tetikleyici: "analiz" → HTML oluştur 2. Tarih: 2025-11-18 3. Konu: blog-analiz 4. Kontrol: public/readme/2025/11/18/blog-analiz/ yoksa 5. Oluştur: public/readme/2025/11/18/blog-analiz/v1/index.html 6. Sembolik link: public/readme/2025/11/18/blog-analiz/index.html → v1 7. URL: https://ixtif.com/readme/2025/11/18/blog-analiz/

Senaryo 2: Kullanıcı "TODO oluştur" dedi (Payment fix için)

1. Tetikleyici: "todo" → MD oluştur 2. Tarih: 2025-11-18 14:30 3. Konu: payment-fix 4. Oluştur: readme/claude-docs/todo/2025/11/18/todo-14-30-payment-fix.md 5. NOT: MD dosyası public/ altında değil!

Senaryo 3: Aynı konuya güncelleme geldi

Kullanıcı: "Blog analizi güncelle, yeni metrikler ekle" 1. Kontrol: public/readme/2025/11/18/blog-analiz/ VAR! 2. Versiyon bul: v1 var → v2 oluştur 3. Oluştur: public/readme/2025/11/18/blog-analiz/v2/index.html 4. Link güncelle: index.html → v2 5. URL: https://ixtif.com/readme/2025/11/18/blog-analiz/ (Otomatik v2'yi gösterir) Önceki versiyon: https://ixtif.com/readme/2025/11/18/blog-analiz/v1/

🎯 CLAUDE.md'ye Eklenecek Bölüm

#### 📂 Dosya Konumu - YENİ HİYERARŞİK SİSTEM: 🎯 HTML Raporlar (Analiz, Plan, Sunum): ``` public/readme/[YYYY]/[MM]/[DD]/[ana-konu]/[versiyon]/index.html ``` Örnek: ``` public/readme/2025/11/18/blog-analiz/v1/index.html public/readme/2025/11/18/blog-analiz/v2/index.html public/readme/2025/11/18/blog-analiz/index.html → v2 (sembolik link) URL: https://ixtif.com/readme/2025/11/18/blog-analiz/ ``` 🎯 MD Dosyalar (Sadece TODO): ``` readme/claude-docs/todo/[YYYY]/[MM]/[DD]/todo-[HH-MM]-[konu].md ``` Örnek: ``` readme/claude-docs/todo/2025/11/18/todo-14-30-payment-fix.md readme/claude-docs/todo/2025/11/18/todo-15-00-blog-ai.md ``` ❌ KRİTİK: - TODO dosyaları ASLA public/ altında değil! - TODO dosyaları ASLA HTML klasörü içinde değil! - MD ve HTML tamamen ayrı konumlarda!

📊 Avantajlar

Özellik Eski Sistem Yeni Sistem
Klasör yapısı Düz: 2025-11-18/ Hiyerarşik: 2025/11/18/
Ay organizasyonu Karışık Organize (11/, 12/)
TODO konumu HTML ile karışık Ayrı: readme/claude-docs/todo/
URL /readme/2025-11-18/konu/ /readme/2025/11/18/konu/
Okunabilirlik Orta Yüksek