🔧 cnware - E-Ticaret Platformu Teknik Dokümantasyonu

cnware, PHP tabanlı, modern web teknolojileri kullanılarak geliştirilmiş
tam özellikli bir dijital ürün satış platformudur. Güvenli ödeme entegrasyonu,
kapsamlı yönetim paneli ve kullanıcı dostu arayüz ile profesyonel bir çözüm
sunar.

🏗️ Teknik Altyapı

Backend:
• PHP 8.x (PDO ile veritabanı erişimi)
• MySQL/MariaDB (İlişkisel veritabanı)
• Session-based Authentication (Güvenli oturum yönetimi)
• PHPMailer (SMTP e-posta gönderimi)
• PayTR Payment Gateway (iframe-based ödeme)

Frontend:
• Tailwind CSS (Utility-first CSS framework)
• Vanilla JavaScript (ES6+)
• Font Awesome 6.x (İkon kütüphanesi)
• SweetAlert2 (Bildirim sistemi)
• Responsive Design (Mobile-first)

🔐 Güvenlik Özellikleri

• SQL Injection Koruması: PDO Prepared Statements
• XSS Koruması: htmlspecialchars() ile output sanitization
• CSRF Koruması: Token-based form validation
• Password Hashing: password_hash() ile bcrypt
• Session Security: Timeout ve regeneration
• Rate Limiting: Brute force koruması
• User Ban System: Kötü niyetli kullanıcı engelleme
• Security Event Logging: Güvenlik olayları kayıt sistemi

🛒 E-Ticaret Özellikleri

Ürün Yönetimi:
• Dinamik ürün listeleme (sayfalama: 6 ürün/sayfa)
• Kategori bazlı filtreleme
• Arama (ürün adı, açıklama, teknoloji)
• Sıralama (yeni, fiyat artan/azalan, popülerlik)
• İndirim fiyatı desteği (discount_price)
• Ücretsiz ürün desteği (0 TL)
• Görüntülenme sayacı
• Benzer ürün önerileri (aynı kategoriden 3 ürün)
• Demo URL ve giriş bilgileri
• Kullanım talimatları

Sepet ve Ödeme:
• Session-based sepet sistemi
• PayTR iframe entegrasyonu
• IBAN/Havale ile ödeme seçeneği
• Sipariş kodu ile ödeme takibi
• Otomatik sipariş oluşturma
• Callback URL ile ödeme doğrulama
• Ücretsiz ürünler için otomatik onay
• Sipariş durumu (beklemede, onaylandi, iptal)
• E-posta bildirimleri

Lisans Yönetimi:
• Otomatik lisans anahtarı oluşturma
• Sipariş bazlı lisans atama
• Profil sayfasından lisans görüntüleme
• Kopyalama butonu ile kolay erişim

👤 Kullanıcı Yönetimi

Kimlik Doğrulama:
• Kayıt sistemi (e-posta doğrulama ile)
• Güvenli giriş (bcrypt password hashing)
• Şifre sıfırlama (token-based)
• Session timeout (varsayılan: 1800 saniye)
• Rate limiting (5 deneme / 15 dakika)
• CSRF token koruması

Profil Özellikleri:
• Kişisel bilgi güncelleme (ad soyad, telefon)
• T.C. Kimlik No doğrulama (NVİ API hazır)
• Doğum yılı kaydı
• Adres bilgileri
• Sipariş geçmişi görüntüleme
• Lisans anahtarları listeleme
• Kullanım talimatları görüntüleme
• E-posta doğrulama durumu
• Eksik bilgi uyarıları

Ban Sistemi:
• Admin tarafından kullanıcı yasaklama (is_banned)
• Login sırasında ban kontrolü
• Yasaklı kullanıcılara özel hata mesajı

🎫 Destek Sistemi

Ticket Management:
• Kullanıcı bazlı ticket oluşturma
• Kategori seçimi (Teknik, Satış, Genel)
• Öncelik belirleme (Düşük, Normal, Yüksek)
• Mesajlaşma sistemi
• Admin ve kullanıcı yanıtları
• Durum takibi (Açık, Yanıtlandı, Kapalı)
• RESTful API ile mesaj gönderme
• Otomatik scroll (en son mesaja)
• Gerçek zamanlı güncelleme (sayfa yenileme ile)

📊 Admin Panel

Yönetim Özellikleri:
• Dashboard istatistikleri
- Toplam kullanıcı sayısı
- Sipariş durumlarına göre sayaçlar (onaylandi, beklemede, iptal)
• Ürün CRUD işlemleri
- Ürün ekleme/düzenleme/silme
- Modal-based form
- Tüm ürün özellikleri (fiyat, indirim, demo, lisans, vb.)
- AI destekli açıklama optimizasyonu
• Kullanıcı yönetimi
- Kullanıcı listesi
- Ban/Unban işlemleri
• Sipariş yönetimi
- Sipariş listesi ve detayları
- Onay/Red işlemleri
• Ticket sistemi yönetimi
- Tüm ticketları görüntüleme
- Yanıt yazma
- Durum güncelleme
• Sistem ayarları
- Site başlığı, URL
- PayTR API anahtarları
- E-posta ayarları

🎨 UI/UX Özellikleri

Tasarım:
• Dark mode tema (siyah/gri tonları)
• Glassmorphism efektleri
• Gradient animasyonlar (blob animasyonları)
• Grid background pattern
• Smooth transitions
• Hover effects
• Responsive grid system
• Mobile-first yaklaşım

Kullanıcı Deneyimi:
• Sezgisel navigasyon
• Form validation
• Loading states
• Error/success notifications (SweetAlert2)
• Kopyalama butonları (clipboard API)
• Scroll to top
• Tab sistemi (profil sayfası)
• Modal popup'lar

🌐 SEO ve Performans

SEO:
• Semantic HTML5
• Meta tags (title, description)
• Dynamic page titles
• Clean URL yapısı (.htaccess)

Performans:
• Pagination (6 ürün/sayfa)
• Database query optimization (prepared statements)
• Session-based cart (veritabanı yükü yok)
• CDN kullanımı (Font Awesome)

📧 E-posta Sistemi

PHPMailer Özellikleri:
• SMTP authentication
• HTML e-posta şablonları
• Sipariş onay mailleri
• Şifre sıfırlama mailleri
• E-posta doğrulama mailleri
• İletişim formu mailleri
• Hata yönetimi

⚖️ Yasal Uyumluluk

Mevcut Sayfalar:
• Hakkımızda
• Gizlilik Politikası ve KVKK Aydınlatma Metni
• Kullanım Şartları
• Mesafeli Satış Sözleşmesi
• Ön Bilgilendirme Formu
• İletişim (zorunlu bilgiler ile)

🔄 API Entegrasyonları

Aktif Entegrasyonlar:
• PayTR Payment Gateway (iframe mode)
• AI API (ürün açıklaması optimizasyonu - admin panel)
• NVİ API (T.C. Kimlik doğrulama - hazır, aktif değil)

Internal API:
• POST /api/....

📱 Responsive Breakpoints

• Mobile: < 768px
• Tablet: 768px - 1024px
• Desktop: > 1024px

Tüm sayfalar mobile-first yaklaşımla geliştirilmiştir.

🚀 Deployment Gereksinimleri

Minimum Sunucu:
• PHP 8.0+
• MySQL 5.7+ veya MariaDB 10.3+
• Apache/Nginx
• mod_rewrite enabled
• SMTP server (e-posta için)

PHP Extensions:
• PDO
• pdo_mysql
• mbstring
• openssl
• curl
• json
• session

🛠️ Öne Çıkan Teknik Özellikler

1. SecurityManager Sınıfı
- CSRF token yönetimi
- Rate limiting
- Session timeout kontrolü
- Input sanitization
- Security event logging
- Client IP tespiti

2. Modüler Yapı
- Separation of concerns
- Reusable components (includes/)
- API endpoints (api/)
- Clean file organization

3. Veritabanı Güvenliği
- Prepared statements (SQL injection koruması)
- Password hashing (bcrypt)
- Foreign key constraints

4. Kullanıcı Deneyimi
- Session-based cart (hızlı)
- Otomatik lisans teslimi
- Gerçek zamanlı form validation
- Responsive tasarım

5. Yönetim Kolaylığı
- Tek sayfa admin panel
- Modal-based forms
- İstatistikler dashboard
- Kolay ürün yönetimi

📋 Mevcut Özellikler Özeti

✅ Ürün listeleme, filtreleme, sıralama, arama
✅ Sepet sistemi (session-based)
✅ PayTR ve IBAN ödeme seçenekleri
✅ Otomatik lisans anahtarı teslimi
✅ Kullanıcı kayıt/giriş/şifre sıfırlama
✅ E-posta doğrulama sistemi
✅ Profil yönetimi ve sipariş geçmişi
✅ Ticket (destek talebi) sistemi
✅ Admin panel (ürün, kullanıcı, sipariş, ticket yönetimi)
✅ Ban sistemi
✅ İndirim fiyatı desteği
✅ Ücretsiz ürün desteği
✅ Benzer ürün önerileri
✅ Kullanım talimatları
✅ Yasal sayfalar (KVKK uyumlu)
✅ İletişim formu
✅ Responsive tasarım
✅ Dark mode tema
✅ Güvenlik özellikleri (CSRF, rate limiting, vb.)
✅ E-posta bildirimleri