KATEGORİ A: CLAUDE ÇALIŞMA KURALLARI
Claude'un nasıl çalışacağına dair temel kurallar - EN ÖNCELİKLİ
A1. Dosya İzinleri (Permission)
📝 Basit Anlatım:
Claude her dosya oluşturduğunda veya düzenlediğinde, dosya sahipliği "root" olarak ayarlanır. Bu durumda web sunucusu (Nginx) dosyayı okuyamaz ve 403 hatası verir. Her dosya işleminden sonra sahipliği "tuufi.com_:psaserv" olarak değiştirmek ZORUNLU.
🔧 Teknik Detaylar:
- •
sudo chown tuufi.com_:psaserv /path/to/file - •
sudo chmod 644 dosya/chmod 755 klasör - • Link vermeden önce
curl -Iile 200 OK testi zorunlu - • Symlink:
sudo -u tuufi.com_ ln -sf
A2. Git Checkpoint Kuralları
📝 Basit Anlatım:
Büyük değişiklikler yapmadan önce "kayıt noktası" oluşturulmalı. Bir şey bozulursa geri dönülebilir. Küçük değişikliklerde (typo, CSS) checkpoint gerekmez.
🔧 Teknik Detaylar:
- • Büyük refactor, çok dosya değişikliği → Checkpoint YAP
- •
git commit -m "🔧 CHECKPOINT: Before [özet]" - •
git reset --hardiçin KULLANICI İZNİ gerekli
A3. Ana Dizin Temizliği
📝 Basit Anlatım:
Proje ana dizini temiz kalmalı. Test dosyaları, debug scriptleri, geçici görseller ana dizinde bırakılmamalı. İş bitince otomatik temizlik yapılmalı.
🔧 Teknik Detaylar:
- • ❌ test-*.php, debug-*.txt, fix-*.php → Ana dizine ASLA
- • ✅ readme/, /tmp/, tests/ → Doğru konumlar
- • Kullanıcı görsel attıysa → İş bitince sil
- • İstisnalar: CLAUDE.md, README.md, .env, composer.json
A4. Buffer Dosyaları (a-console.txt, a-html.txt)
📝 Basit Anlatım:
Debug için kullanılan özel dosyalar. Kullanıcı "console" veya "debug" derse aktif ol, yoksa dokunma. Bu dosyaları ASLA silme.
🔧 Teknik Detaylar:
- • Pasif mod: Kullanıcı bahsetmezse hiç dokunma
- • Aktif mod: "a-console.txt", "console", "debug" tetikler
A5. Çalışma Yöntemi & Cache Temizleme
📝 Basit Anlatım:
Tailwind/View değişikliğinden sonra cache temizleme ve build otomatik yapılmalı. "Değişiklik yansımadı" denirse Nuclear Cache Clear uygulanmalı.
🔧 Teknik Detaylar:
- • Otomatik:
php artisan view:clear && npm run prod - • Nuclear: config:clear, route:clear, responsecache:clear + opcache reset
- • ❌
redis-cli FLUSHALL→ Kullanıcıları logout yapar!
KATEGORİ B: HTML RAPOR SİSTEMİ
README oluşturma kuralları - KORUNACAK, ÖNEMLİ!
B1. Tetikleyici Kelimeler - Ne Zaman HTML Oluştur
📝 Basit Anlatım:
Kullanıcı bazı kelimeler kullandığında otomatik HTML rapor oluşturulmalı. "Analiz", "rapor", "incele", "plan" gibi kelimeler HTML tetikler. "Düzelt", "ekle", "sil" gibi kelimeler direkt kod yazmayı tetikler.
🔧 Teknik Detaylar:
✅ HTML Oluştur:
- • analiz, incele, araştır
- • rapor, dokümante et
- • plan, tasarım, strateji
- • sunum, göster, özetle
- • detaylı, kapsamlı, gözat
- • karşılaştır, listele
❌ Direkt Kod Yaz:
- • düzelt, fix et
- • ekle, sil
- • değiştir, güncelle
- • migration yap
- • oluştur (kod için)
B2. Dosya Konumu & Versiyon Sistemi
📝 Basit Anlatım:
HTML raporlar tarih bazlı klasörlerde saklanır. Her güncelleme yeni versiyon olarak eklenir (v1, v2, v3...). Ana klasörde sembolik link en güncel versiyona işaret eder.
🔧 Teknik Detaylar:
- • Konum:
public/readme/YYYY/MM/DD/konu/v1/index.html - • İlk rapor: v1 → Güncelleme: v2, v3...
- • Sembolik link:
ln -sf v3/index.html index.html - • URL:
https://domain.com/readme/2026/01/14/konu/
Örnek Yapı:
public/readme/2026/01/14/blog-analiz/ ├── v1/index.html ← İlk analiz ├── v2/index.html ← Güncelleme └── index.html ← Symlink → v2
B3. İki Seviyeli İçerik (Basit + Teknik)
📝 Basit Anlatım:
Her HTML raporda iki farklı anlatım olmalı: 1) Herkesin anlayacağı basit Türkçe 2) Geliştiriciler için teknik detaylar. Böylece hem proje sahibi hem de developer raporu anlayabilir.
🔧 Teknik Detaylar:
📝 Basit Anlatım Bölümü:
- • Günlük dil, sade Türkçe
- • Teknik terim varsa parantez içinde açıkla
- • "Neden önemli?" sorusunun cevabı
- • Benzetmeler, örnekler
🔧 Teknik Detaylar Bölümü:
- • Dosya path'leri
- • Fonksiyon/class isimleri
- • Veritabanı tablo/field
- • Kullanılan teknolojiler
B4. Birikimli Versiyon İçeriği
📝 Basit Anlatım:
Her yeni versiyon, önceki versiyonların TÜM bilgilerini içermeli + yeni eklenenler. v3'ü okuyan biri v1 ve v2'yi okumak zorunda kalmamalı. Bilgi kaybı YASAK!
🔧 Teknik Detaylar:
❌ YANLIŞ:
v1: A, B, C anlatıldı v2: Sadece D yazıldı (A,B,C kayboldu!) v3: Sadece E yazıldı (hepsi kayboldu!)
✅ DOĞRU:
v1: A, B, C v2: A, B, C + D v3: A, B, C, D + E (hepsi var!)
B5. Görev Tamamlandı Raporu
📝 Basit Anlatım:
Görev bittiğinde "Yapılanlar" HTML raporu oluşturulmalı. Tetikleyiciler: "bitti", "tamam", "teşekkürler", "güzel" vb.
🔧 Teknik Detaylar:
- • Dosya:
task-completed-[konu]/index.html - • Tasarım: Yeşil tema, success badge
- • İçerik: "Ne yapıldı?" (kod bloğu YOK)
B6. Konuşma Başlangıç & Konu Değişikliği Raporları
📝 Basit Anlatım:
Yeni konuşmanın ilk mesajında veya tamamen farklı konuya geçildiğinde planlama raporu oluşturulmalı. Aynı konunun devamıysa rapor oluşturma.
🔧 Teknik Detaylar:
- • İlk mesaj:
session-start-[konu]/ - • Konu değişikliği:
topic-change-[yeni-konu]/ - • Aynı konunun devamı → Rapor oluşturma!
B7. README Index Sayfası
📝 Basit Anlatım:
domain.com/readme/ adresinde tüm raporların otomatik listesi görünür. Yeni rapor eklenince otomatik taranır ve listeye eklenir.
🔧 Teknik Detaylar:
- • Dosya:
public/readme/index.php - • PHP glob() ile klasörleri tarar
- • Masonry layout, versiyon badge'leri
KATEGORİ C: PROJE/SİTE KURALLARI (TENANT-AWARE)
Multi-tenant mimari ve proje özel kurallar
C1. Multi-Tenant Mimari
📝 Basit Anlatım:
Sistem birden fazla siteyi (tenant) barındırır. Her tenant kendi veritabanında çalışır. ixtif.com endüstriyel ekipman satıyor, muzibu.com müzik platformu. Birinin koduna diğerinin özel içeriğini ekleme!
🔧 Teknik Detaylar:
| ID | Domain | Database | Sektör |
|---|---|---|---|
| 1 | tuufi.com | tuufi_4ekim |
Central (Ana sistem) |
| 2 | ixtif.com | tenant_ixtif |
Endüstriyel Ekipman |
| 1001 | muzibu.com | tenant_muzibu_1528d0 |
Müzik Platformu |
❌ ASLA YAPMA:
- • Forklift/Transpalet kodunu Muzibu'ya ekleme
- • Müzik/Album/Artist kodunu İxtif'e ekleme
- • Central DB'ye tenant verisi yazma
C2. Migration Kuralları
📝 Basit Anlatım:
Veritabanı değişikliği (migration) yapılırken HER ZAMAN iki yere yazılmalı: Hem central için hem tenant için. Birini unutursan sistem bozulur!
🔧 Teknik Detaylar:
- • Central:
Modules/[Modül]/database/migrations/xxx.php - • Tenant:
Modules/[Modül]/database/migrations/tenant/xxx.php - • ❌
database/migrations/ana klasör KULLANMA! - • Çalıştır:
php artisan migrate+php artisan tenants:migrate
C3. Tenant CSS (Tailwind)
📝 Basit Anlatım:
Her tenant kendi CSS dosyasını kullanır (tenant-2.css, tenant-1001.css). Tailwind class eklediğinde safelist'e ekle ve npm run prod çalıştır.
🔧 Teknik Detaylar:
- • Config:
tailwind/tenants/tenant-X.config.js - • Output:
public/css/tenant-X.css - • Build:
npm run prod
C4. Pattern Uyumu (Referans Dosyalar)
📝 Basit Anlatım:
Yeni sayfa/component oluştururken mevcut dosyalardan örnek al. Aynı tablo yapısını, buton stillerini, spacing'leri kullan. Tutarlılığı bozma!
🔧 Teknik Detaylar:
- • Tablo:
Modules/Page/.../page-component.blade.php - • Form:
page-manage-component.blade.php - • Sıralama:
category-component.blade.php
KATEGORİ D: GÜVENLİK & KORUMA
Tehlikeli komutlar ve veri koruma
D1. Storage/Medya Koruma - MUTLAK YASAK!
📝 Basit Anlatım:
Storage klasörünü ve medya dosyalarını ASLA silme! Geçmişte bu komutlar 268 medya dosyasını sildi ve geri gelmedi. Müşteri fotoğrafları, ürün görselleri kalıcı kaybolur!
🔧 Teknik Detaylar:
❌ YASAK KOMUTLAR:
- •
php artisan media-library:clear - •
php artisan db:wipe - •
php artisan migrate:fresh - •
rm -rf storage/ - •
rm -rf storage/app/public/
✅ GÜVENLİ KOMUTLAR:
- •
php artisan cache:clear - •
php artisan config:clear - •
php artisan route:clear - •
php artisan view:clear - •
php artisan responsecache:clear
D2. Veritabanı Koruma
📝 Basit Anlatım:
Bu gerçek canlı sistem! Veritabanını silme, truncate yapma, DROP çalıştırma. INSERT/UPDATE için kullanıcı izni gerekli.
🔧 Teknik Detaylar:
- • ❌
migrate:fresh,db:wipe, truncate, DELETE, DROP - • ❌ Sunucu ayarlarını rastgele değiştirme
- • ⚠️ INSERT/UPDATE, migration oluşturma → Kullanıcı izni gerekli
KATEGORİ E: PERFORMANS & OPTİMİZASYON
Horizon, CPU ve sorgu optimizasyonları
E1. Performans Notları (2025-11-30)
📝 Basit Anlatım:
Geçmişte CPU %100'e çıktı ve site 45 saniyede açılıyordu. Horizon ayarları düzeltildi, N+1 query'ler çözüldü, şimdi 2-3 saniyede açılıyor. Bu ayarları bozma!
🔧 Teknik Detaylar:
- • ❌ Horizon auto-restart cron ile YAPMA (orphan process)
- • ❌
exec(...&)ile process başlatma - • ❌ maxProcesses agresif ayarlama (8 değil 2)
- • ✅ Currency N+1 fixed, Settings global cache
📊 Sonuçlar:
- • CPU: 18.44 → 7.09 (%61 azalma)
- • Horizon: 112 → 38 process (%66 azalma)
- • Site: 45s → 2-3s (15-22x hızlanma)
KATEGORİ F: TASARIM STANDARTLARI
UI/UX, renk, admin panel kuralları
F1. Genel Standartlar
📝 Basit Anlatım:
Admin panelde Tabler.io + Bootstrap + Livewire kullan. Frontend'de Alpine.js + Tailwind CSS kullan. İkonlar SADECE FontAwesome olmalı.
🔧 Teknik Detaylar:
- • Admin: Tabler.io + Bootstrap + Livewire
- • Frontend: Alpine.js + Tailwind CSS
- • Icon: FontAwesome (
fas,far,fab) - • Renkler: Framework renkleri (custom yok)
F2. Tasarımsal Değişikliklerde HTML Taslak
📝 Basit Anlatım:
Yeni UI component veya sayfa tasarımı yapmadan önce HTML taslak göster. Kullanıcı "UYGUNDUR" derse kodu yaz, değişiklik isterse yeni versiyon oluştur.
🔧 Teknik Detaylar:
- • Yeni UI, form, liste, panel ekleme → Taslak zorunlu
- • Taslak:
public/readme/[tarih]/[konu]/v1/index.html - • "UYGUNDUR" → Kodu yaz
F3. Renk Kontrast (WCAG AA)
📝 Basit Anlatım:
Metin okunabilir olmalı. Minimum kontrast 4.5:1. Koyu üstüne koyu, açık üstüne açık renk KULLANMA.
F4. Admin Panel Pattern
📝 Basit Anlatım:
Admin panelde iki dosya pattern'i kullan: index.blade.php (liste) ve manage.blade.php (form). Eski create.blade.php / edit.blade.php pattern'ini kullanma.
KATEGORİ G: SİSTEM BİLGİLERİ
Dil, settings, thumbmaker, MD kullanımı
G1-G4. Dil, Settings, Thumbmaker, MD Kullanımı
G1. Dil Sistemi:
- • Admin: system_languages + admin_locale
- • Site: site_languages + site_locale
G2. Settings:
- •
setting('site_name') - • Yeni group → Kullanıcı onayı
G3. Thumbmaker:
- •
thumb($media, 400, 300) - • WebP, loading="lazy"
G4. MD Kullanımı:
- • MD = Sadece TODO!
- • Tetikleyici: "todo", "checklist"
- • Konum: readme/claude-docs/todo/
📊 Özet & Öneriler
✅ KORU (12 kural)
- • HTML Rapor Sistemi (B1-B5, B7)
- • Dosya İzinleri (A1)
- • Storage/DB Koruma (D1, D2)
- • Multi-Tenant & Migration (C1, C2)
⚠️ SADELEŞTİR (8 kural)
- • Git Checkpoint (A2)
- • Konuşma Raporları (B6) - çok uzun
- • Buffer Dosyaları (A4)
- • Renk Kontrast (F3)
- • Sistem Bilgileri (G1-G4)
🔄 YENİDEN YAPILANDIR
- • Tenant bilgileri → TENANT_LIST.md
- • Performans detayları → Sadece link
- • Tekrar eden bilgileri sil
- • Claude kuralları EN ÜSTE
📐 ÖNERİLEN YENİ YAPI:
CLAUDE.md (Yeni - ~400 satır hedef)
├── BÖLÜM 1: CLAUDE ÇALIŞMA KURALLARI (Öncelikli)
│ ├── 1.1 Dosya İzinleri (Permission)
│ ├── 1.2 Git Checkpoint
│ ├── 1.3 Ana Dizin Temizliği
│ └── 1.4 Cache & Build
│
├── BÖLÜM 2: HTML RAPOR SİSTEMİ (Korunacak!)
│ ├── 2.1 Tetikleyiciler
│ ├── 2.2 Dosya Konumu & Versiyon
│ ├── 2.3 İki Seviyeli İçerik
│ ├── 2.4 Birikimli Versiyon
│ └── 2.5 README Index
│
├── BÖLÜM 3: GÜVENLİK & KORUMA
│ ├── 3.1 Yasak Komutlar
│ └── 3.2 DB Koruma
│
├── BÖLÜM 4: PROJE KURALLARI
│ ├── 4.1 Multi-Tenant (özet + TENANT_LIST.md link)
│ ├── 4.2 Migration
│ ├── 4.3 CSS Build
│ └── 4.4 Pattern Uyumu
│
└── BÖLÜM 5: TASARIM & REFERANSLAR
├── 5.1 Standartlar (kısa)
└── 5.2 Referans linkler