Tema tercihi trafficpumper.theme anahtarında light, dark veya system olarak tutulur. resources/js/theme-manager.js hem Blade yerleşiminde ilk boyadan önce hem de Filament head hook'unda kullanılır. Filament'in kendi seçicisi ortak tercihle senkronize edilir.

Yerel Windows ortamında Horizon worker çalıştırmak için gerekli pcntl ve posix PHP uzantıları bulunmaz. Horizon, Linux üretim ortamı için kurulu ve yapılandırılmıştır.

composer install
npm install
php artisan test
npm test
npm run build

API iş rotaları ileride routes/api/v1.php altında ve /api/v1/... önekiyle eklenecektir.

İlk süper admin

Gerçek parola seed dosyalarına yazılmaz. İlk yetkili hesabı interaktif ve gizli parola girişiyle oluşturun:

php artisan trafficpumper:make-super-admin

Public /register yalnızca customer rolü oluşturur. /dashboard aktif ve e-postası doğrulanmış oturum; /admin ayrıca admin.access yetkisi ve Filament canAccessPanel() kontrolü gerektirir.

AŞAMA 3 — Proje / Website yönetimi

Müşteri proje ekranları /projects altında çalışır. Projeler dahili integer anahtarın yanında URL'lerde kullanılan ULID taşır ve user_id + domain birleşik benzersizlik kuralıyla korunur. Yalnızca HTTP/HTTPS kabul eden merkezi URL normalizasyonu www. önekini kaldırır; localhost ve IP adreslerini reddeder. Kayıt sırasında herhangi bir ağ isteği yapılmaz.

Müşteri işlemleri sorgu seviyesinde oturum sahibine sınırlandırılır ve ayrıca ProjectPolicy ile yetkilendirilir. Başka müşteriye ait bir ULID için tutarlı 404 döner. Silme yerine açık arşivleme/geri yükleme uçları kullanılır. Backoffice liste/detay görünümü /admin/projects rotasındadır; sahip değiştirme ve hard delete sunulmaz.

Doğrulama komutları: php artisan migrate, php artisan test, npm test ve npm run build.

AŞAMA 4 — Keyword ve SERP veri altyapısı

Project → Keyword ilişkisi ULID public kimlikleri ve User → Project → Keyword sahiplik zinciriyle kuruldu. Hedef kimliği normalize edilmiş ifade, arama motoru, ülke, dil ve cihaz birleşimidir; aynı Project içinde DB seviyesinde benzersizdir. Whitespace tekilleştirilir, locale bağımsız küçük harf dönüşümü uygulanır ve Türkçe karakterler korunur. Arşivlenen hedef kimliği tutulur ve yeni kayıt yerine restore edilir. Customer nested rotaları sorgu seviyesinde sahipliğe, Filament görünümü ise keywords.view / keywords.manage izinlerine bağlıdır.

serp_checks hedef snapshotlarını, serp_results organik sonuç satırlarını saklayacak veri altyapısıdır. Bu aşamada dış arama motoru sorgusu, scraping, provider, queue, scheduler veya customer SERP endpointi eklenmemiştir.

AŞAMA 5 — Provider-neutral SERP çalıştırma

SERP sağlayıcıları SerpProvider sözleşmesi üzerinden registry tarafından çözülür; domain kodu provider SDK veya response biçimi bilmez. SerpQuery, SerpResponse ve SerpResultData immutable sınırı oluşturur. Fake provider yalnız testing veya açıkça izin verilmiş local ortamda çalışır; production ortamında sonuç üretemez. Bu aşamada production provider ve dış SERP HTTP isteği yoktur.

Kontroller serp kuyruğunda RunSerpCheck job'ıyla çalışır: 3 deneme, 60 saniye timeout ve 10/60/300 saniye backoff. Transient timeout/rate-limit hataları yeniden denenir; kalıcı hatalar güvenli kodla failed olur. Keyword başına atomik cache lock, DB active-slot unique constraint ve job lock birlikte duplicate/eşzamanlı çalışmayı engeller. Provider çağrısı transaction dışında, sonuç tamamlama transaction içindedir.

Manuel kontroller kullanıcı rate-limit'i, 15 dakika keyword cooldown'u, günlük 25 kontrol kotası ve pending/running engeline tabidir. Otomatik takip daily/weekly olup UTC next_check_at kullanır. Scheduler her dakika due kayıtları chunk ile kuyruğa alır, overlap ve tek-sunucu kilidi kullanır. Domain eşleşmesi exact domain veya gerçek subdomain kabul eder; www eşdeğerdir, metinsel sahte suffix eşleşmez.

Production provider eklemek için SerpProvider adaptörü yazılır, service container registry'sine kaydedilir ve SERP_PROVIDER değeri adaptör anahtarına ayarlanır.

AŞAMA 6 — DataForSEO Google Organic adaptörü

Production adaptörü dataforseo anahtarıyla kayıtlıdır. Manuel kontroller Google Organic Live Advanced, zamanlanmış daily/weekly kontroller Standard task_post ve gecikmeli task_get/advanced poll akışını kullanır. Payload ülke, dil ve cihaz allowlist değerlerinden sunucu tarafında üretilir; depth daima 10'dur. Organik sonuç sırası DataForSEO rank_group alanından normalize edilir; sağlayıcıya özgü JSON domain modeline veya veritabanına yazılmaz.

HTTP istemcisi yalnız https://api.dataforseo.com taban adresini, Basic Auth kimlik bilgilerini, TLS doğrulamasını, bağlantı/istek timeout'larını ve redirectsiz çağrıları kullanır. HTTP status ile DataForSEO status_code zarfı ayrı doğrulanır. Kimlik bilgileri yalnız environment/config üzerinden alınır ve loglanmaz.

Kurulum güvenli varsayılanla gelir: SERP_CHECKS_ENABLED=false. Production kimlik bilgileri girilse bile operasyonel onay verilmeden bu değer açılmamalıdır. Gerçek API çağrısı testlerde yapılmaz; Http::preventStrayRequests() ve Http::fake() kullanılır.

ASAMA 7 — Kontrollu production aktivasyonu

SERP operasyonu disabled, validation_only, canary, enabled ve DB kill-switch ile emergency_stopped durumlarini ayirir. Normal ucretli akis icin hem SERP_CHECKS_ENABLED=true hem SERP_OPERATION_MODE=enabled gerekir; bilinmeyen durum fail-closed davranir.

Maliyetler mikro-USD ledgerda UTC gunluk/aylik atomik rezervasyon ve gercek maliyetle tekil reconciliation kullanir. Kill switch ve circuit breaker yeni Live/submit islemlerini engeller, mevcut Standard task polling sonucunu kurtarir. Remote health ve canary execute calistirilmamistir.

Filament /admin/serp-operations support/admin icin salt okunur, emergency stop/clear yalniz super_admin icindir. Ayrintilar: docs/production-serp-runbook.md.

AŞAMA 8 — Güvenli production hazırlığı

Dış HTTP yapmayan production preflight ve 24 saatlik scrubbed operasyon snapshot komutları ile atomik 5/25/100 ramp-up kapısı eklendi. Başlangıç ve mevcut durum güvenli biçimde disabled kalır; remote health, tek canary ve limited production birbirinden ayrı açık onay kapılarıdır. Deployment ve recovery ayrıntıları docs/production-serp-runbook.md içindedir.

README.md Unescape Escape

TrafficPumper — AŞAMA 1