From e4f218d67c2f96128ba0a94f537269b84fef291c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C3=9Cmit=20Tun=C3=A7?= <umitreva@gmail.com>
Date: Sat, 27 Sep 2025 15:00:09 -0300
Subject: [PATCH] Add cursor rules for Citrus Platform: Established
 comprehensive guidelines for localization, module structure, resource
 classes, page classes, form and table rules, model and migration standards,
 testing protocols, coding style, security measures, and performance
 optimizations. Included example structure for the Pages module to serve as a
 reference for future development.

---
 .cursorrules | 138 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 138 insertions(+)
 create mode 100644 .cursorrules

diff --git a/.cursorrules b/.cursorrules
new file mode 100644
index 0000000..65e70e3
--- /dev/null
+++ b/.cursorrules
@@ -0,0 +1,138 @@
+# Citrus Platform - Cursor Rules
+
+## Proje Genel Kuralları
+
+### Dil ve Lokalizasyon
+- Tüm metinler Laravel Localization kullanmalı
+- Türkçe ve İngilizce dil desteği zorunlu
+- Dil dosyaları `lang/tr/` ve `lang/en/` klasörlerinde
+- Çeviri anahtarları kebab-case formatında: `module_name.key_name`
+- Blade template'lerde `{{ __('module.key') }}` kullan
+- Controller'larda `__('module.key')` kullan
+
+### Modül Yapısı
+- Her modül için aşağıdaki yapıyı takip et:
+```
+app/Filament/Admin/Resources/ModuleName/
+├── ModuleNameResource.php
+├── Pages/
+│   ├── ListModuleName.php
+│   ├── CreateModuleName.php
+│   └── EditModuleName.php
+├── Schemas/
+│   └── ModuleNameForm.php
+└── Tables/
+    └── ModuleNameTable.php
+```
+
+### Resource Sınıfı Kuralları
+- `getNavigationLabel()`, `getModelLabel()`, `getPluralModelLabel()` metodlarını implement et
+- Tüm metinler için localization kullan
+- Navigation icon için Heroicon kullan
+
+### Page Sınıfları Kuralları
+- `getTitle()` metodunu implement et ve localization kullan
+- Action butonları için `->label(__('module.action_name'))` kullan
+- Notification mesajları için localization kullan
+- `getRedirectUrl()` metodunu implement et
+
+### Form ve Table Kuralları
+- Form field'ları için label'ları localization'dan al
+- Table column'ları için header'ları localization'dan al
+- Validation mesajları için localization kullan
+
+### Dil Dosyası Yapısı
+```php
+<?php
+
+return [
+    'title' => 'Modül Başlığı',
+    'navigation_label' => 'Navigasyon Etiketi',
+    'model_label' => 'Tekil Model Etiketi',
+    'plural_model_label' => 'Çoğul Model Etiketi',
+    
+    // Actions
+    'create' => 'Oluştur',
+    'edit' => 'Düzenle',
+    'delete' => 'Sil',
+    'restore' => 'Geri Yükle',
+    'force_delete' => 'Kalıcı Olarak Sil',
+    
+    // Form fields
+    'field_name' => 'Alan Etiketi',
+    
+    // Messages
+    'created_successfully' => 'Başarıyla oluşturuldu.',
+    'updated_successfully' => 'Başarıyla güncellendi.',
+    'deleted_successfully' => 'Başarıyla silindi.',
+    
+    // Table columns
+    'table_column_name' => 'Sütun Başlığı',
+    
+    // Validation messages
+    'field_required' => 'Bu alan zorunludur.',
+    'field_unique' => 'Bu değer zaten kullanılıyor.',
+];
+```
+
+### Model Kuralları
+- `$fillable` array'ini tanımla
+- `$casts` array'ini kullan
+- Soft delete için `SoftDeletes` trait'ini kullan
+- `$dates` array'ini kullan
+
+### Migration Kuralları
+- Tablo adları çoğul olmalı
+- Column adları snake_case
+- Foreign key'ler için `_id` suffix'i kullan
+- Timestamps için `created_at` ve `updated_at` kullan
+- Soft delete için `deleted_at` kullan
+
+### Test Kuralları
+- Her modül için test dosyaları oluştur
+- Feature test'leri yaz
+- Unit test'leri yaz
+- Localization test'leri yaz
+
+### Kod Stili
+- PSR-12 standartlarına uy
+- Type hinting kullan
+- Return type'ları belirt
+- DocBlock'ları yaz
+- Kısa ve açıklayıcı metod isimleri kullan
+
+### Güvenlik
+- CSRF koruması aktif
+- Validation kuralları uygula
+- Authorization kontrolü yap
+- SQL injection koruması
+- XSS koruması
+
+### Performans
+- Eager loading kullan
+- Database index'leri ekle
+- Cache kullan
+- Query optimization yap
+
+## Pages Modülü Örnek Yapısı
+
+Pages modülü bu kuralların uygulandığı örnek modüldür. Yeni modül oluştururken bu yapıyı referans al.
+
+### Dosya Yapısı
+- `PageResource.php` - Ana resource sınıfı
+- `Pages/ListPages.php` - Liste sayfası
+- `Pages/CreatePage.php` - Oluşturma sayfası  
+- `Pages/EditPage.php` - Düzenleme sayfası
+- `Schemas/PageForm.php` - Form şeması
+- `Tables/PagesTable.php` - Tablo şeması
+- `lang/tr/pages.php` - Türkçe çeviriler
+- `lang/en/pages.php` - İngilizce çeviriler
+
+### Özellikler
+- ✅ Localization desteği
+- ✅ Soft delete
+- ✅ Form validation
+- ✅ Table filtering
+- ✅ Action buttons
+- ✅ Notifications
+- ✅ Redirect handling