Teknik, Güvenlik ve
Mimari Raporu

01. Yönetici Özeti & Proje Manifestosu

Açık kaynak dünyasında geleneksel "Micro Framework" etiketlerinin ötesinde; veritabanı şemasından UI bileşenlerine kadar uçtan uca (vertical-slice) kod üretebilen, CLI tabanlı güvenlik kalkanlarına sahip, sıfır dış bağımlılıklı bir Full-Stack Framework olarak konumlanır.

02. Mimari Sütunlar ve "Safe Vibe Coding" Felsefesi

A. Giriş Noktaları ve İzole Bootstrapping

ArtiFrame, web isteklerini iki ana katmanda kesin çizgilerle ayırır:

• ViewControl.php (View Katmanı Bootstrapping): HTML/Render süreçlerini başlatır. DotEnv, APP_ENV, APP_VERSION ve ViewMethod bileşenlerini yükler.
• ApiControl.php (API Katmanı Bootstrapping): JSON API isteklerini karşılar. $allowedMethods denetimini require edilmeden önce zorunlu tutarak yetkisiz HTTP metotlarını anında keser. Exception detaylarını production ortamında gizler.

B. CLI Jeneratörleri ve "Design by Contract" (Sözleşmeli Tasarım)

CLI araçları geliştiricinin etrafında güvenlik guardrail'leri oluşturur:

• create:method auth: Tek komutla schema.sql veritabanı tablosundan, arka plan PHP controller sınıflarına, CSRF korumalı API uçlarına ve giydirilmemiş HTML formlarına kadar Auth modülünü uçtan uca üretir.
• add Servis Ekosistemi: Dış servisleri (S3, Redis, Stripe, Iyzico, JWT, Twilio, Pusher, Sentry, ImageProcessor) standart bir kılıf arkasında projeye bağlar.

C. Standart Yanıt Sözleşmesi

Tüm add wrapper'ları ve API yardımcıları istisnasız aynı JSON sözleşmesini döner:

{
  "status": "success | error",
  "message": "Human readable status message",
  "data": {}
}

Bu sayede try-catch blokları içinde patlayan kütüphane hataları sistemi çökertmek yerine kibarca yakalanır ve günlüğe (error_log) kaydedilir.

03. Çekirdek Motor ve Veri Kalkanları

A. Veritabanı ve Yüksek Performanslı Kimlik Yönetimi

• Yerleşik Native UUIDv7 (byteId, makeId, formatId): Hiçbir dış Composer kütüphanesine ihtiyaç duymadan, saf PHP ile 16-byte binary UUIDv7 üretir. Veritabanındaki BINARY(16) sütunlarında muazzam bir indeksleme ve disk performansı sağlar.
• JavaScript Precision Kalkanı (bigintId, stringer): JavaScript'in MAX_SAFE_INTEGER sınırını aşan BigInt ID'lerde veri kaybı yaşanmaması için bigintId() varsayılan olarak 15 hane üretir. View katmanında data-id="<?= stringer($id) ?>" kullanımı zorunlu kılınarak frontend-backend veri bozunmaları engellenir.

B. Katı Güvenlik ve Tip Koruması

• XSS Sanitasyon Kalkanı (ViewMethod::display): Ekrana basılan tüm verileri ENT_QUOTES | ENT_HTML5 bayraklarıyla temizler. null veya boş girdilerde $default değerine düşerek PHP 8.1+ tür hatalarını engeller.
• Güvenli Parola Hashleme (SystemMethod::hashPassword): Parola boş geldiğinde sessiz kalıp hatalı hash üretmek yerine Exception fırlatarak boş parolalı kayıt oluşmasını imkansız kılar.
• KVKK / GDPR Yerleşik Maskeleme: maskEmail() ve maskPhone() fonksiyonları ile kullanıcı verileri tek hamlede sansürlenerek View katmanına basılır.

04. Sayısal Performans ve Benchmark Analizi

🖥️ Benchmark Test Ortamı (Test Environment)

• Sunucu Özellikleri: 4 vCPU Intel Processor, 8 GB RAM, 80 GB NVMe/SSD, 20 TB Aylık Trafik
• İşletim Sistemi & Yazılım: Ubuntu 24.04 LTS, Nginx 1.26, PHP 8.3 FPM (OPcache Aktif)
• Test Yöntemi: wrk -t4 -c100 -d30s (4 Thread, 100 Eşzamanlı Bağlantı, 30 Saniye Sürdürülebilir Yük)
• Test Senaryosu: Basit JSON API Yanıtı ({"status":"success","message":"OK"})

05. Detaylı Güvenlik ve Zaafiyet Matrisi

06. AI & Vibe Coding Context Window Verimliliği

Yapay zeka ajanları (Cursor, Claude, Copilot) ile kod geliştirme süreçlerinde framework kodunun boyutu, AI bağlam penceresi (context window) maliyetini ve kod üretme kalitesini doğrudan etkiler.

07. DevOps, CI/CD ve Docker Ekosistemi

08. Kesintisiz ve Otomatik Sürüm Yükseltme Mimarisi (Zero-Shatter Upgrades)

Geleneksel framework'lerde major sürüm güncellemeleri (örneğin Laravel 10'dan 11'e geçiş) yüzlerce dosyada kırılmalara (breaking changes), bağımlılık çakışmalarına ve günlerce süren refactor süreçlerine yol açar.

ArtiFrame, sabit fonksiyon imzaları ve CLI tabanlı senkronizasyon mekanizması sayesinde projenizdeki tek bir satır iş mantığı (business logic) kodunu kırmadan güncellenir.

🛠️ Adım Adım Güncelleme İş Akışı (Upgrade Workflow)

1. Global CLI Paketini Güncelleyin:

$ npm install -g @artilingo/artiframe-cli@latest

2. Proje Dizinine Geçin ve Güncelleme Komutunu Çalıştırın:

$ cd /var/www/my-artiframe-project
$ artiframe update

⚙️ Arka Planda Ne Çalışır?

• CLI, projenin kök dizinindeki app/ veya bin/ klasöründe yer alan çekirdek dosyalarını (SystemMethod.php, ViewMethod.php, ViewControl.php, ApiControl.php) yeni PHP sürümüne uygun optimizasyonlar ve güvenlik yamaları içeren en güncel versiyonlarıyla otomatik değiştirir.
• Arayüzde kullanılan display(), API tarafındaki apiResponse(), veri maskelemedeki maskPhone() veya CSRF doğrulamasındaki verifyCsrf() metod imzaları asla değişmediği için yazmış olduğunuz tüm view, controller ve servis sınıfları sorunsuz çalışmaya devam eder.
• Geliştirici, yüzlerce dosyada kod düzenleme karmaşası yaşamadan en son PHP versiyonunun (PHP 8.3/8.4/8.5) performans ve güvenlik iyileştirmelerini anında elde eder.

09. Toplam Sahip Olma Maliyeti (TCO & Finansal Analiz)

Aylık ortalama 150 Milyon İstek (Saniyede ~60 aktif işlem) alan, yoğun veritabanı işlemleri yapan ağır bir SaaS projesinin bulut sunucu maliyet projeksiyonu:

10. Sonuç: Neden ArtiFrame?

ArtiFrame; geliştirmeyi ne idüğü belirsiz paket çorbasına ve hantal soyutlama katmanlarına boğmadan, Native PHP'nin ham gücünü disiplinli ve kurşun geçirmez bir CLI mimarisiyle harmanlar.

• Hızlıdır: İstek başına 0.46 ms yanıt süresi ile sunucu kaynaklarını sömürmez.
• Güvenlidir: Güvenlik önlemlerini opsiyonel bırakmaz; mimari düzeyde dayatır.
• AI Dostudur: ~18.000 token'lık çekirdeği ile yapay zeka ajanlarının hatasız kod üretmesini sağlar.
• Sürdürülebilirdir: artiframe update komutuyla proje kodunuz kırılmadan çekirdek anında güncellenir.